Интеграции

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

Подключение

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

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

Трёхуровневая модель интеграций

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

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

AI-провайдеры

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

Точный каталог с ценами — в выборе модели внутри агента: он меняется быстрее этой страницы.

CRM-системы

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

Поля данных доступа для каждой системы — в разделе CRM.

Вебхуки

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

См. Вебхуки.

Уведомления

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

См. Уведомления.

Другое

• Комментарии в соцсетях — Instagram Comments, Facebook Comments, Rozetka Comments: агент отвечает под постами, рилсами и карточками товаров.
• Маркетплейсы — Prom.ua, Rozetka, OLX: чаты покупателей попадают в тот же инбокс.
• Телефония — Binotel, Ringostat, Phonet, Unitalk, Stream Telecom, а также Custom Calls для любого другого провайдера. См. Провайдеры телефонии.
• Исходящий Viber — DirectHub отправляет первое сообщение на номер телефона.
• Векторная БД — Qdrant обеспечивает работу базы знаний (эмбеддинги OpenAI text-embedding-3-large + поиск в Qdrant).

Храните API-ключи в тайне, используйте для Happ отдельные ключи и регулярно их меняйте.

API: api.happ.tools/reference

Дальше

• Каналы — подключите мессенджеры
• CRM — синхронизируйте воронку продаж
• Вебхуки — создавайте собственные интеграции