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

**Generic inbound нуқтаи универсалии вуруд ба AiHummer аст.** Вақте ки барои манбаи шумо канали махсус мавҷуд нест — релеи email-to-webhook, корти cron, асбоби дохилӣ — шумо паёмро ба як нуқтаи интиҳоӣ мефиристед ва он мисли ҳар паёми канали дигар ба муҳаррики гардиш (turn engine) ворид мешавад. ## Нуқтаи интиҳоӣ Як `POST`-и JSON-ро ба gateway фиристед: ```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] > gateway бояд як корфазои пешфарз танзимшуда дошта бошад > (`AIHUMMER_DEFAULT_WORKSPACE_ID`), то паёмҳои generic inbound-ро равон кунад. ## Коннекторҳои дастрас / пешнамоиш AiHummer коннекторҳои иловагии каналро дар **пешнамоиш** пешниҳод мекунад: онҳо аллакай татбиқ шудаанд, аммо **ҳанӯз нисбати ҳисобҳои зинда тасдиқ нашудаанд**. Ҳар яке аз Marketplace насб карда мешавад, ба таври host-native дар порти худ кор мекунад ва паёмҳои воридшавандаро ба `/v1/inbound/generic` мефиристад. | Коннектор | Порт | Эзоҳҳо | |---|---|---| | 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](/tg/v1.0/channels/telegram) ва [MAX](/tg/v1.0/channels/max)-ро бубинед. - Барои паёмнависии кормандон, [Bitrix24](/tg/v1.0/channels/bitrix24)-ро бубинед. - Бар зидди API месозед? [chat/completions](/tg/v1.0/api/chat-completions)-ро бубинед.