Ерөнхий орж ирэх

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` сайдкар | | Майкрософт Тимс | 8805 | | | Имэйл (IMAP/SMTP) | 8806 | | | WhatsApp Cloud API | 8807 | | > [!NOTE] > Холбогчуудыг Зах зээлээс суулгадаг; зарим нь нэмэлт үйлчилгээ шаарддаг > (жишээлбэл, `signal-cli` Signal-ийн хувьд). ## Вэб хөтчийн өргөтгөл AiHummer мөн браузерын өргөтгөл илгээдэг, нэг **Manifest V3 хажуугийн самбар** чатын талбай. Энэ нь **үйлчлүүлэгчийн `/v1/chat/completions`** хувь хүний хэрэглэх `ah-` API түлхүүр — **сервер талын сувгa биш**. Үүнийг чиглүүлэх эх сурвалж болгон бус, хувийн, браузер доторхи чатанд ашиглаарай. ## Дараа хаашаа явах вэ - Үйлдвэрлэлийн чатыг үзэхийн тулд, харна уу [Телеграм](/mn/v1.0/channels/telegram) болон [МАКС](/mn/v1.0/channels/max). - Ажилтны IM-ийн хувьд, үзнэ үү [Bitrix24](/mn/v1.0/channels/bitrix24). - API-тай эсрэг барилга барих уу? Хар [чат/түргэн хариу](/mn/v1.0/api/chat-completions).