# Інтеграції

Підключіть AI-провайдерів, CRM, вебхуки та сповіщення клієнта до Happ з одного каталогу

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

Усе, що клієнт підключає до Happ — AI-провайдери, CRM, вебхуки, сповіщення, телефонія — живе в одному каталозі **Інтеграцій**. Підключіть, призначте асистента, готово.

<IntegrationsOverviewDemo />

## Підключення [#підключення]

1. **Інтеграції** на бічній панелі → **Додати інтеграцію**.
2. Оберіть тип інтеграції.
3. Введіть облікові дані в модальному вікні (API-ключі, токени, URL).
4. Призначте асистента (лише для інтеграцій типу каналу) → **Підключити**.

Натисніть активну інтеграцію, щоб **Редагувати**; видаліть її, щоб від'єднати й зупинити весь потік даних (інтеграції каналів також прибирають свої чати). Перегляньте список через `GET /api/company-integrations` із заголовком `X-Access-Token`.

## Трирівнева модель інтеграцій [#three-tier-integration-model]

1. **Інтеграція** — головне визначення типу (наприклад, "Telegram", "Binotel").
2. **Інтеграція компанії** — підключення вашого клієнта з його обліковими даними.
3. **Інтеграція асистента** — який асистент обробляє це підключення.

Тож ви можете підключити кілька акаунтів одного типу й призначити кожному окремого асистента.

## AI-провайдери [#ai-провайдери]

Один API-ключ на провайдера, додається через **Додати інтеграцію** (свій ключ). Без ключа асистент працює на моделях платформи.

| Провайдер          | Що покриває                                                                                  |
| ------------------ | -------------------------------------------------------------------------------------------- |
| OpenAI             | Сімейство GPT-5.x (`gpt-5.1` — дефолт для нових асистентів), GPT-4.1, GPT-4o — текст і голос |
| Claude (Anthropic) | `claude-sonnet-4-5` — текст                                                                  |
| Gemini (Google)    | Gemini 3.x Flash / Pro — текст і голос                                                       |
| Groq               | GPT-OSS 120B / 20B — надшвидкий текстовий інференс                                           |
| ElevenLabs         | Синтез і розпізнавання мовлення для голосових агентів                                        |
| Qdrant             | Власна векторна база для бази знань                                                          |

Точний каталог із цінами — у селекторі моделі всередині асистента: він змінюється швидше за цю сторінку.

## CRM-системи [#crm-системи]

Пошук покупця за телефоном посеред розмови, створення замовлень і лідів, пошук по каталогу товарів: **KeyCRM, NetHunt, Odoo, SalesDrive, Sitniks, Uspacy, RO App, KeepinCRM, Creatio, Zoho CRM, OneBox, Міністерство Ремонту**. **Bitrix24** працює інакше — він дзеркалить чати Telegram, Instagram і WhatsApp у відкриті лінії Bitrix24.

Див. [CRM](/docs/integrations/crm) щодо полів облікових даних кожної системи.

## Вебхуки [#вебхуки]

Отримуйте події чатів і дзвінків у реальному часі на власній точці прийому.

Див. [Вебхуки](/docs/integrations/webhooks).

## Сповіщення [#сповіщення]

Сповіщайте команду, коли розмова потребує людини, або вивантажуйте дані: **Telegram Push**, **Slack**, **Google Sheets**, **пуші в мобільний застосунок** (готові розбори розмов) і **email** (щотижневі та щомісячні аналітичні звіти).

Див. [Сповіщення](/docs/integrations/notifications).

## Інше [#інше]

* **Коментарі в соцмережах** — Instagram Comments, Facebook Comments, Rozetka Comments: асистент відповідає під постами, рілсами й картками товарів.
* **Маркетплейси** — Prom.ua, Rozetka, OLX: чати покупців потрапляють у ту саму скриньку.
* **Телефонія** — Binotel, Ringostat, Phonet, Unitalk, Stream Telecom, а також Custom Calls для будь-якого іншого провайдера. Див. [Провайдери телефонії](/docs/integrations/telephony).
* **Вихідний Viber** — DirectHub надсилає перше повідомлення на номер телефону.
* **Векторна БД** — Qdrant забезпечує [базу знань](/docs/agents/knowledge) (ембедінги OpenAI `text-embedding-3-large` + пошук у Qdrant).

Тримайте API-ключі приватними, використовуйте окремі ключі для Happ і періодично оновлюйте їх.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Далі [#далі]

* [Канали](/docs/integrations/messengers) — підключіть месенджери
* [CRM](/docs/integrations/crm) — синхронізуйте воронку продажів
* [Вебхуки](/docs/integrations/webhooks) — створюйте власні інтеграції