PromptPipe is a Go-based WhatsApp messaging service built on the whatsmeow client. It exposes a REST API to send and schedule prompts, track receipts and responses, and run a stateful conversation flow (intake + feedback). OpenAI-backed GenAI features are optional.
Table of Contents
- Overview
- Quickstart
- Configuration
- API Reference
- Conversation Flow
- Storage
- Development
- Docs Index
- License
Overview
Key capabilities:
- Send and schedule prompts (static, genai, branch, conversation, custom)
- WhatsApp integration via whatsmeow
- Conversation flow with intake and feedback modules
- Auto-enrollment of new participants (optional)
- Receipt/response tracking and timer introspection
- SQLite or PostgreSQL for application data
Quickstart
# Build make build # Run (loads .env if present) ./build/promptpipe
Optional GenAI configuration:
export OPENAI_API_KEY="your-openai-key" ./build/promptpipe
PromptPipe searches for .env files in ./.env, ../.env, and ../../.env.
Configuration
See docs/configuration.md for environment variables, CLI flags, defaults, and precedence rules.
API Reference
See docs/api.md for endpoints, request/response schemas, and examples. API test scripts live in test-scripts/.
Conversation Flow
See docs/conversation.md for the current flow summary and docs/conversation-flow.md for detailed behavior.
Storage
See docs/storage.md for database layout and persistence details.
Development
See docs/development.md for build/test instructions.
Docs Index
Current implementation references:
- Configuration
- API Reference
- Flow Generators
- Conversation Flow (summary)
- Conversation Flow (detailed)
- Storage
- Debug Mode
- Auto-enrollment
- Intensity adjustment
- State recovery
- Troubleshooting
Legacy or historical design docs (kept for reference):
Python/LangChain subproject: the python/langchain directory is experimental and not integrated with the Go service. Its documentation is marked accordingly.
License
MIT License. See LICENSE.