# Integrations

Wire a client's AI providers, CRM, webhooks, and notifications into Happ from one catalog

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Everything a client connects to Happ — AI providers, CRM, webhooks, notifications, telephony — lives in one **Integrations** catalog. Connect it, assign an assistant, done.

<IntegrationsOverviewDemo />

## Connect [#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 [#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 [#ai-providers]

API key per provider, added via **Add Integration**. See [Assistants > AI Model Configuration](/docs/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 [#crm-systems]

Sync conversations, contacts, and orders. KeyCRM, NetHunt, Odoo, SalesDrive, Bookon, SmartCRM, Altegio.

See [CRM](/docs/integrations/crm) for per-system credential fields.

## Webhooks [#webhooks]

Receive real-time chat and call events on your own endpoint.

See [Webhooks](/docs/integrations/webhooks).

## Notifications [#notifications]

Alert the team when a conversation needs a human — Telegram push or Google Spreadsheets.

See [Notifications](/docs/integrations/notifications).

## Other [#other]

* **Telephony** — Binotel, Ringostat, Phonet, Unitalk for the voice assistant. See [Telephony Providers](/docs/voice/providers).
* **Voice** — ElevenLabs premium text-to-speech.
* **Vector DB** — Qdrant powers the [Knowledge Base](/docs/knowledge) (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](https://api.happ.tools/reference)

## Next [#next]

* [Channels](/docs/channels) — connect messengers
* [CRM](/docs/integrations/crm) — sync your sales pipeline
* [Webhooks](/docs/integrations/webhooks) — build custom integrations