Integrations
Wire a client's AI providers, CRM, webhooks, and notifications into Happ from one catalog
Everything a client connects to Happ — AI providers, CRM, webhooks, notifications, telephony — lives in one Integrations catalog. Connect it, assign an assistant, done.
Connect
- Integrations in the sidebar → Add Integration.
- Pick the integration type.
- Enter credentials in the modal (API keys, tokens, URLs).
- Assign an assistant (channel-type integrations only) → Connect.
Click an active integration to Edit; delete one to disconnect it and stop all data flow (channel integrations also clean up their chats). List them via GET /api/company-integrations with header X-Access-Token.
Three-tier integration model
- Integration — master type definition (e.g. "Telegram", "Binotel").
- Company Integration — your client's connection with its credentials.
- Assistant Integration — which assistant handles that connection.
So you can connect multiple accounts of one type and assign a different assistant to each.
AI providers
API key per provider, added via Add Integration. See Assistants > AI Model Configuration.
| Provider | Popular models |
|---|---|
| OpenAI | GPT-4o, GPT-4o Mini, GPT-4 Turbo, GPT-4, GPT-3.5 Turbo |
| Claude (Anthropic) | Sonnet 4.5, Sonnet 3.7, Opus 3.5, Haiku 3 |
| Gemini (Google) | 2.0 Flash, 1.5 Pro, 1.5 Flash, 1.5 Flash 8B |
| Groq | GPT-OSS 120B (ultra-fast inference) |
CRM systems
Sync conversations, contacts, and orders. KeyCRM, NetHunt, Odoo, SalesDrive, Bookon, SmartCRM, Altegio.
See CRM for per-system credential fields.
Webhooks
Receive real-time chat and call events on your own endpoint.
See Webhooks.
Notifications
Alert the team when a conversation needs a human — Telegram push or Google Spreadsheets.
See Notifications.
Other
- Telephony — Binotel, Ringostat, Phonet, Unitalk for the voice assistant. See Telephony Providers.
- Voice — ElevenLabs premium text-to-speech.
- Vector DB — Qdrant powers the Knowledge Base (OpenAI
text-embedding-3-largeembeddings + Qdrant retrieval).
Keep API keys private, use separate keys for Happ, and rotate them periodically.