# Интеграции

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

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

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

<IntegrationsOverviewDemo />

## Подключение [#connect]

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

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

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

1. **Интеграция** — основное определение типа (например, «Telegram», «Binotel»).
2. **Интеграция компании** — подключение вашего клиента с его данными доступа.
3. **Интеграция агента** — какой агент обрабатывает это подключение.

Поэтому можно подключить несколько аккаунтов одного типа и назначить каждому своего агента.

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

Один 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-systems]

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

Поля данных доступа для каждой системы — в разделе [CRM](/docs/integrations/crm).

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

Получайте события чатов и звонков в реальном времени на собственный эндпоинт.

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

## Уведомления [#notifications]

Оповещайте команду, когда разговору нужен человек, или выгружайте данные: **Telegram Push**, **Slack**, **Google Таблицы**, **push-уведомления в мобильном приложении** (готовые анализы разговоров) и **email** (еженедельные и ежемесячные аналитические отчёты).

См. [Уведомления](/docs/integrations/notifications).

## Другое [#other]

* **Комментарии в соцсетях** — 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)

## Дальше [#next]

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