Generic inbound — AiHummer Документация

Generic inbound — это универсальная точка входа в AiHummer. Когда для вашего источника нет специализированного канала — реле email-в-webhook, cron-задача, внутренний инструмент — вы отправляете сообщение на один эндпоинт, и оно попадает в turn-движок как сообщение любого другого канала.

Эндпоинт

Отправьте один JSON-POST в gateway:

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 — содержимое сообщения.

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

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

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

Коннекторы в статусе «доступно / preview»

AiHummer предлагает дополнительные коннекторы каналов в статусе preview: они уже реализованы, но ещё не проверены на живых аккаунтах. Каждый устанавливается из Marketplace, работает host-native на своём порту и пересылает входящие на /v1/inbound/generic.

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

[!WARNING] Считайте эти коннекторы доступными / preview. Они реализованы, но не проверены вживую на реальных аккаунтах провайдеров — валидируйте их в своём окружении, прежде чем полагаться на них в продакшене.

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

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

Куда дальше

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