Жалпы кирүү

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ге универсалдуу кирүү чекити болуп саналат.** Эгерде сиздин булак үчүн атайын канал болбосо — электрондук почта аркылуу webhookка өткөрүү, 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 ошондой эле браузер кеңейтүүсүн жөнөтөт, a **Manifest V3 жаны панел** чат бет. Бул **кардар `/v1/chat/completions`** жеке колдонуу `ah-` API ачкычы — **сервер тараптагы канал эмес**. Аны багыттоо үчүн кирген булак катары эмес, жеке, браузерде чат үчүн колдонуу. ## Келерки кайда - Өндүрүш чаты үчүн караңыз [Телеграм](/ky/v1.0/channels/telegram) жана [МАКС](/ky/v1.0/channels/max). - Кызматкерлер үчүн IM, караңыз [Bitrix24](/ky/v1.0/channels/bitrix24). - APIга каршы куруу? Караңыз [чат/аяктоолор](/ky/v1.0/api/chat-completions).