Агульны ўваходны

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"
}

**Агульны ўваход з'яўляецца універсальным пунктам доступу ў AiHummer.** Калі няма спецыяльна створанага канала для вашага крыніцы — перасылкі з электроннай пошты на вэб-хук, cron-задачы, унутранага інструмента — вы адпраўляеце паведамленне на адзін канец і яно трапляе ў рухавік чаргавання як любога іншага паведамлення канала. ## Канчатковая кропка Даслаць адзін JSON `POST` да варот: ```http 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`) для адпраўкі агульных уваходных паведамленняў. ## Дадатковыя раздымы канала AiHummer прапануе дадатковыя канектары каналаў. Кожны ўсталёўваецца з Marketplace, працуе на ўласным порце хаста і перанакіроўвае ўваходныя паведамленні на `/v1/inbound/generic`. | Злучальнік | Порт | Нататкі | |---|---|---| | Дыскард | 8801 | | | Слак | 8802 | | | Матрыца | 8803 | | | Сігнал | 8804 | патрабуе `signal-cli` бокавы прыцэп | | Microsoft Teams | 8805 | | | Электронная пошта (IMAP/SMTP) | 8806 | | | WhatsApp воблачны API | 8807 | | > [!NOTE] > Злучальнікі ўсталёўваюцца з Marketplace; некаторым патрэбна дадатковая служба > (напрыклад, `signal-cli` для Signal). ## Расшырэнне браўзэра AiHummer таксама прадастаўляе пашырэнне для браўзера **Бокавая панэль Manifest V3** паверхня чата. Гэта **кліент `/v1/chat/completions`** выкарыстоўваючы асабісты `ah-` Ключ API — **не серверны канал**Выкарыстоўвайце гэта для асабістай перапіскі ў браўзэры, а не як уваходны крыніца для маршрутызацыі. ## Куды далей - Для вытворчай размовы глядзіце [Тэлеграм](/be/v1.0/channels/telegram) і [МАКС](/be/v1.0/channels/max). - Для персаналу IM гл. [Бітрыкс24](/be/v1.0/channels/bitrix24). - Будуеце ствараць супраць API? Глядзіце [чат/завяршэнні](/be/v1.0/api/chat-completions).