Generic inbound
Generic inbound — гэта ўніверсальная кропка ўваходу ў AiHummer. Калі для вашай крыніцы няма спецыяльна створанага канала — рэле email-to-webhook, cron-задача, унутраны інструмент — вы адпраўляеце паведамленне на адзін эндпойнт, і яно ўваходзіць у рухавік ходаў, як і любое іншае канальнае паведамленне.
Эндпойнт
Адпраўце адзін JSON POST на шлюз:
POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>
{
"channel": "my-app",
"external_id": "user-42",
"text": "Hello from my custom integration"
}Цела нясе тры палі:
channel— лагічная назва канала, якую вы выбіраеце для крыніцы.external_id— стабільны ідэнтыфікатар канчатковага карыстальніка ці размовы.text— змест паведамлення.
Аўтэнтыфікацыя
Эндпойнт абаронены HMAC, які нясецца ў загалоўку
X-AIHummer-Inbound-Secret і вырабляецца з агульнага
AIHUMMER_INBOUND_SECRET. Запыты без сапраўднага подпісу адхіляюцца, таму
ўводзіць паведамленні могуць толькі тыя, хто валодае сакрэтам.
[!NOTE] Шлюз павінен мець наладжаны працоўны прастор па змаўчанні (
AIHUMMER_DEFAULT_WORKSPACE_ID), каб дыспетчарызаваць generic inbound паведамленні.
Даступныя / прэв’ю канектары
AiHummer прапануе дадатковыя канальныя канектары ў прэв’ю: яны ўжо
рэалізаваны, але яшчэ не правераны на жывых акаўнтах. Кожны ўсталёўваецца з
Маркетплейса, працуе host-native на сваім порце і перасылае ўваходныя
паведамленні на /v1/inbound/generic.
| Канектар | Port | Заўвагі |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrix | 8803 | |
| Signal | 8804 | патрабуе sidecar signal-cli |
| Microsoft Teams | 8805 | |
| Email (IMAP/SMTP) | 8806 | |
| WhatsApp Cloud API | 8807 |
[!WARNING] Стаўцеся да гэтых канектараў як да даступных / прэв’ю. Яны рэалізаваны, але не правераны ў жывых умовах на рэальных акаўнтах правайдараў — праверце іх ва ўласным асяроддзі, перш чым належыцца на іх у прадакшэне.
Браўзернае пашырэнне
AiHummer таксама пастаўляе браўзернае пашырэнне — чат-паверхню ў бакавой панэлі
Manifest V3. Гэта кліент /v1/chat/completions, які выкарыстоўвае
персанальны API-ключ ah- — а не серверны канал. Выкарыстоўвайце яго для
персанальнага чату ў браўзеры, а не як уваходную крыніцу для маршрутызацыі.
Куды далей
- Для прадакшэн-чату глядзіце Telegram і MAX.
- Для карпаратыўнага IM глядзіце Bitrix24.
- Будуеце пад API? Глядзіце chat/completions.