AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Kirilish va Integratsiya Trigerlari

Kirilish va Integratsiya Trigerlari

v1.1.x · yangilandi 2026-07-27

OpenAI-ga mos APIdan tashqari, AiHummer qabul qiladi kelib tushgan xabarlar ulanishlar va avtomatlashtirish platformalaridan, va chiqaradi server tomonidagi voqea oqimi siz obuna bo’lishingiz mumkin. Ushbu tugunlar tashqi tizimlar ishni darvozaga qanday yetkazishini va foydalanuvchi interfeyslari qanday jonli qolishini ko’rsatadi.

Kirish nuqtalari

Kirish nuqtalari bu kanal ulanishlari va maxsus integratsiyalar xabarni aylantirish dvigateliga uzatadigan usuldir. Ular tomonidan himoyalangan HMAC umumiy sir jo’natilgan X-AIHummer-Inbound-Secret sarlavha (AIHUMMER_INBOUND_SECRET settings-catalog kaliti — Boshqaruv → Sozlamalar ostida admin UI da sozlangan yoki bilan aihummer settings set, da emas gateway.env).

Usul va yo‘l Maqsad
POST /v1/inbound/telegram Telegramning mahalliy kiruvchi payloadlari
POST /v1/inbound/generic Elektron pochta→veb-xok, cron va maxsus ilovalar uchun umumiy kirish
POST /v1/inbound/binding/status Kanallarni bog‘lash holatini hisobot qilish

umumiy endpoint har qanday manbani AiHummer ga uzatishning eng oddiy usulidir. Kanal nomi, barqaror tashqi identifikator va xabar matni bilan kichik JSON tanasini yuboring:

curl https://your-aihummer.example/v1/inbound/generic \
  -H "X-AIHummer-Inbound-Secret: $AIHUMMER_INBOUND_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "external_id": "ticket-4821",
    "text": "A customer asks whether order #4821 has shipped."
  }'

[!NOTE] Umumiy kiruvchi jo’natish moslamasi standart ish joyiga muhtoj. Sozlash AIHUMMER_DEFAULT_WORKSPACE_ID shunda kiruvchi xabarlar yo’naltirilishi mumkin.

[!WARNING] Kirish nuqtalari tomonidan himoyalanmagan ah- API kaliti — ular unga tayanadilar X-AIHummer-Inbound-Secret HMAC. Shu sirni mijoz tomonidagi koddan uzoqda saqlang va Agar u oqsa, uni aylantiring.

Integratsiya tetiklovchilari (Zapier / Make)

POST /v1/integrations/trigger past kodli avtomatlashtirish platformalari uchun kirish nuqtasi hisoblanadi, masalan Zapier va Qilmoq. Endpoint standart bo’yicha o‘chirib qo‘yilgan: …gacha AIHUMMER_INBOUND_TRIGGER_SECRET sozlama o‘rnatilganda u javob beradi 501 Not Implemented. Bu ajratish maxfiy, ajralib turuvchi AIHUMMER_INBOUND_SECRET; har qanday settings-catalog kaliti kabi u admin UI (Boshqaruv → Sozlamalar) orqali yoki bilan o’rnatiladi aihummer settings set.

Bir marta sozlanganidan so‘ng, tugun foydalanishni qabul qiladi X-AIHummer-Signature HMAC yoki quyidagi shakldagi Bearer token Authorization: Bearer <the AIHUMMER_INBOUND_TRIGGER_SECRET value>.

curl https://your-aihummer.example/v1/integrations/trigger \
  -H "Authorization: Bearer $AIHUMMER_INBOUND_TRIGGER_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "zapier",
    "external_id": "lead-99",
    "text": "New lead captured from the contact form."
  }'

Admin Sessions backend’i

Bu ikki endpoint Admin Sessions sahifasining ichki transporti sifatida saqlanadi. Ular mijoz saytiga joylashtiriladigan qo’llab-quvvatlanadigan kanal emas.

Metod va yoʻl Maqsad
POST /v1/web/session Admin Sessions suhbatini ochish yoki davom ettirish
GET /v1/web/stream Suhbat javobini SSE sifatida olish

Tadbir oqimi

GET /v1/events/stream bo’ladi davom ettirilishi mumkin Shlyuz voqealarining Server-Sent Events oqimi. Unga quyidagi ikki qat’iy talab mavjud:

  1. ?workspace_id=<id> parametr majburiy — buni qilmasdan so‘rov rad etiladi 400. Ijarachi qo’riqchi ish joyi kimga tegishli ekanligini tekshiradi qo’ng’iroq qiluvchining ijarachisi; boshqanning workspace_id hosil beradi 403.
  2. Avtorizatsiya talab qilinadi — bir admin sessiyasi (cookie) yoki bir ah- API kalit ichiga Authorization: Bearer sarlavha. Bu holda javob mavjud emas 401.

O‘tkaz ?since= oldingi ulanish to‘xtagan joydan davom ettirish uchun kursor, shuning uchun qayta ulanish hech qachon hodisalarni yo‘qotmaydi.

# Subscribe from the beginning
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>"

# Resume after a known cursor
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>&since=<cursor>"

[!TIP] Har bir voqea olib kelgan qiymatni keyingisi sifatida ko’rib chiqing since kursor. Yoqilgan qayta ulaning, o‘sha kursoridan qayta ijro eting, shunda kamida bir marta yetkazilishini kafolatlaydi iste’molchi.

Keyingi qayerga