AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Generic inbound

Generic inbound

v1.0.x · yangilandi 2026-06-26

Generic inbound — AiHummerga universal kirish nuqtasi. Manbangiz uchun maxsus yaratilgan kanal boʻlmasa — email-to-webhook releyi, cron vazifasi, ichki vosita — siz xabarni bitta endpointga joylaysiz va u boshqa har qanday kanal xabari kabi turn dvigateliga kiradi.

Endpoint

Gateway’ga bitta JSON POST yuboring:

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

Tana uchta maydonni oʻz ichiga oladi:

  • channel — manba uchun siz tanlagan mantiqiy kanal nomi.
  • external_id — oxirgi foydalanuvchi yoki suhbat uchun barqaror identifikator.
  • text — xabar mazmuni.

Autentifikatsiya

Endpoint X-AIHummer-Inbound-Secret sarlavhasida olib boriladigan HMAC bilan himoyalangan boʻlib, u umumiy **AIHUMMER_INBOUND_SECRET**dan olinadi. Yaroqli imzosiz soʻrovlar rad etiladi, shuning uchun faqat sirni egallagan chaqiruvchilargina xabar kirita oladi.

[!NOTE] Generic inbound xabarlarini dispetcherlash uchun gateway’da standart ish maydoni sozlangan boʻlishi kerak (AIHUMMER_DEFAULT_WORKSPACE_ID).

Mavjud / preview konnektorlar

AiHummer preview holatida qoʻshimcha kanal konnektorlarini taklif qiladi: ular allaqachon amalga oshirilgan, lekin jonli hisoblarga qarshi hali tasdiqlanmagan. Har biri Marketplace’dan oʻrnatiladi, oʻz portida host-native ishlaydi va kiruvchi xabarlarni /v1/inbound/genericga uzatadi.

Konnektor Port Eslatmalar
Discord 8801
Slack 8802
Matrix 8803
Signal 8804 signal-cli sidecar talab qiladi
Microsoft Teams 8805
Email (IMAP/SMTP) 8806
WhatsApp Cloud API 8807

[!WARNING] Bu konnektorlarni mavjud / preview sifatida qabul qiling. Ular amalga oshirilgan, lekin haqiqiy provayder hisoblariga qarshi jonli sinovdan oʻtkazilmagan — ishlab chiqarishda ularga tayanishdan oldin oʻz muhitingizda tasdiqlang.

Brauzer kengaytmasi

AiHummer shuningdek brauzer kengaytmasini — Manifest V3 yon-panel chat yuzasini yetkazadi. Bu shaxsiy ah- API kalitidan foydalanadigan /v1/chat/completions mijozi — server tomonidagi kanal emas. Undan yoʻnaltirish uchun kiruvchi manba sifatida emas, balki shaxsiy, brauzer ichidagi chat uchun foydalaning.

Keyingi qadam