HappHapp Docs

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

  1. Integrations in the sidebar → Add Integration.
  2. Pick the integration type.
  3. Enter credentials in the modal (API keys, tokens, URLs).
  4. 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

  1. Integration — master type definition (e.g. "Telegram", "Binotel").
  2. Company Integration — your client's connection with its credentials.
  3. 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.

ProviderPopular models
OpenAIGPT-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
GroqGPT-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-large embeddings + Qdrant retrieval).

Keep API keys private, use separate keys for Happ, and rotate them periodically.

API: api.happ.tools/reference

Next

  • Channels — connect messengers
  • CRM — sync your sales pipeline
  • Webhooks — build custom integrations

On this page