Универсальный входящий вебхук

v1.2.x · обновлено 2026-07-21

Универсальный входящий вебхук (в API — generic inbound) — это универсальная точка входа в AiHummer. Три типовых примера:

письмо → событие: реле «почта-в-вебхук» превращает входящее письмо в сообщение агенту;
cron → плановый запрос: задача по расписанию просит агента подготовить утреннюю сводку;
CRM → новый лид: ваша CRM отправляет карточку нового лида, и агент начинает работу с ним.

Когда для вашего источника нет специализированного канала, вы отправляете сообщение на один endpoint, и оно попадает в движок обработки запросов как сообщение любого другого канала.

Endpoint

Отправьте один JSON-POST в шлюз:

POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>

{
  "channel": "my-app",
  "external_id": "user-42",
  "text": "Привет из моей кастомной интеграции"
}

Тело содержит три поля:

channel — логическое имя канала, которое вы выбираете для источника.
external_id — стабильный идентификатор конечного пользователя или диалога.
text — содержимое сообщения.

Аутентификация

Endpoint защищён HMAC в заголовке X-AIHummer-Inbound-Secret, производным от общего секрета AIHUMMER_INBOUND_SECRET. Запросы без валидной подписи отклоняются, поэтому внедрять сообщения могут только вызывающие, у которых есть секрет.

[!NOTE] Для диспетчеризации сообщений универсального входящего вебхука в шлюзе должно быть задано рабочее пространство по умолчанию (AIHUMMER_DEFAULT_WORKSPACE_ID).

Дополнительные коннекторы каналов

AiHummer предлагает дополнительные коннекторы каналов. Каждый устанавливается из Маркетплейса, работает напрямую в Linux на своём порту и пересылает входящие на /v1/inbound/generic.

Коннектор	Порт	Примечания
Discord	8801
Slack	8802
Matrix	8803
Signal	8804	требуется дополнительный сервис `signal-cli`
Microsoft Teams	8805
Email (IMAP/SMTP)	8806
WhatsApp Cloud API	8807

[!NOTE] Коннекторы устанавливаются из Маркетплейса; для некоторых нужны дополнительные сервисы (например, signal-cli для Signal).

Браузерное расширение

AiHummer также поставляет браузерное расширение — чат в боковой панели на Manifest V3. Это клиент /v1/chat/completions с личным API-ключом ah-, а не серверный канал. Используйте его для личного чата в браузере, а не как входящий источник для маршрутизации.

Куда дальше

Для рабочего чата см. Telegram и MAX.
Для мессенджера сотрудников см. Bitrix24.
Интегрируетесь с API? См. chat/completions.