An AI assistant answering from your docs, handing off to a person when it isn't sure. A real weekend project.
What is on this board
Parts
- Telegram Chat channel · Telegram
- WhatsApp Chat channel · WhatsApp
- Webhook Serverless function
- Messages Message queue
- Assistant AI agent
- Claude LLM · Anthropic
- Docs Vector DB · Qdrant
- Conversations Relational DB · Supabase
- Human handoff SaaS tool · Zendesk
- Team alerts Chat channel · Slack
- The docs SaaS tool · Notion
- Reindex nightly Scheduled job
- Before going live Checklist
- It makes things up Risk
How they connect
- Telegram → Webhook: message
- WhatsApp → Webhook: message
- Webhook → Messages: process
- Messages → Assistant: next message
- Assistant → Docs: find passages
- Assistant → Claude: answer from these
- Assistant → Conversations: history
- Assistant → Telegram: reply
- Assistant → Human handoff: not sure: hand off
- Human handoff → Team alerts: new ticket
- Reindex nightly → The docs: read
- Reindex nightly → Docs: embed
Notes and decisions
- Webhook: Answers in time, works later
- Assistant: Answers from the docs, or passes it on
- It makes things up: Answer only from the passages found. Otherwise, hand off.