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

One API key per provider, added through Add Integration (bring your own key). Without a key the assistant runs on the platform's own models.

ProviderWhat it covers
OpenAIGPT-5.x family (gpt-5.1 is the default for new assistants), GPT-4.1, GPT-4o — text and voice
Claude (Anthropic)claude-sonnet-4-5 — text
Gemini (Google)Gemini 3.x Flash / Pro — text and voice
GroqGPT-OSS 120B / 20B — ultra-fast text inference
ElevenLabsSpeech synthesis and recognition for voice agents
QdrantYour own vector database for the knowledge base

The exact catalogue with prices lives in the model picker inside an assistant — it changes faster than this page.

CRM systems

Look buyers up by phone mid-conversation, create orders and leads, search the product catalogue: KeyCRM, NetHunt, Odoo, SalesDrive, Sitniks, Uspacy, RO App, KeepinCRM, Creatio, Zoho CRM, OneBox, Ministerstvo Remontu. Bitrix24 works differently — it mirrors Telegram, Instagram and WhatsApp chats into Bitrix24 Open Lines.

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, or ship the data out: Telegram Push, Slack, Google Sheets, mobile app push (finished conversation analyses) and email (weekly and monthly analytics reports).

See Notifications.

Other

  • Social comments — Instagram Comments, Facebook Comments, Rozetka Comments: the assistant replies under posts, reels and product cards.
  • Marketplaces — Prom.ua, Rozetka, OLX: buyer chats land in the same inbox.
  • Telephony — Binotel, Ringostat, Phonet, Unitalk, Stream Telecom, plus Custom Calls for any other provider. See Telephony Providers.
  • Outbound Viber — DirectHub sends the first message to a phone number.
  • 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

Help me solve it

Happ answers right away and hands over to a manager when needed.

On this page