Жалпы кирүүчү (Generic inbound)

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'ге универсалдуу кирүү чекити.** Сиздин булагыңыз үчүн атайын курулган канал жок болсо — email-ден-вебхукка ретранслятор, cron тапшырмасы, ички курал — сиз билдирүүнү бир эндпоинтке жайгаштырасыз жана ал башка каналдын билдирүүсү сыяктуу кезек кыймылдаткычына (turn engine) кирет. ## Эндпоинт Шлюзга жалгыз 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`** — билдирүүнүн мазмуну. ## Аутентификация Эндпоинт **`X-AIHummer-Inbound-Secret`** аталышында алып жүрүлгөн **HMAC** менен корголгон, ал бөлүшүлгөн **`AIHUMMER_INBOUND_SECRET`** маанисинен алынат. Жарактуу кол тамгасы жок суроо-талаптар четке кагылат, ошондуктан билдирүүлөрдү инжекциялай алгандар сырды кармагандар гана. > [!NOTE] > Жалпы кирүүчү билдирүүлөрдү жөнөтүү үчүн шлюзда демейки жумушчу мейкиндик > конфигурацияланган болушу керек (`AIHUMMER_DEFAULT_WORKSPACE_ID`). ## Жеткиликтүү / превью коннекторлору AiHummer **превью** режиминде кошумча канал коннекторлорун сунуштайт: алар буга чейин ишке ашырылган, бирок **жандуу аккаунттарга карата али текшерилген эмес**. Ар бири Marketplace'тен орнотулат, өзүнүн портунда хост-нативдик иштейт жана кирүүчү билдирүүлөрдү `/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] > Бул коннекторлорду **жеткиликтүү / превью** катары кабыл алыңыз. Алар ишке > ашырылган, бирок чыныгы провайдер аккаунттарына карата **жандуу далилденген > эмес** — өндүрүштө аларга таянуудан мурда өз чөйрөңүздө текшериңиз. ## Браузер кеңейтүүсү AiHummer ошондой эле браузер кеңейтүүсүн жеткирет, бул **Manifest V3 каптал-панель** маек бети. Ал жеке `ah-` API ачкычын колдонуу менен **`/v1/chat/completions` кардары** — **сервердик канал эмес**. Аны багыттоо үчүн кирүүчү булак катары эмес, жеке, браузердин ичиндеги маек үчүн колдонуңуз. ## Андан ары кайда - Өндүрүштүк маек үчүн [Telegram](/ky/v1.0/channels/telegram) жана [MAX](/ky/v1.0/channels/max) караңыз. - Кызматкерлердин IM'и үчүн [Bitrix24](/ky/v1.0/channels/bitrix24) караңыз. - API'ге каршы куруп жатасызбы? [chat/completions](/ky/v1.0/api/chat-completions) караңыз.