AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Gələn və İnteqrasiya Trigerləri

Gələn və İnteqrasiya Trigerləri

v1.0.x · yeniləndi 2026-07-27

OpenAI uyğun API-dən kənarda, AiHummer qəbul edir gələn mesajlar birləşdiricilərdən və avtomatlaşdırma platformalarından, və yayır bir server tərəfli hadisə axını abunə ola bilərsiniz. Bu son nöqtələr xarici sistemlərin işləri keçid vasitəsinə necə çatdırdığını və istifadəçi interfeyslərinin necə davamlı qalmasını göstərir.

Gələn nöqtələr

Gələn son nöqtələr kanal birləşdiriciləri və xüsusi inteqrasiyaların mesajı dönmə mühərrikinə ötürməsinin yoludur. Onlar tərəfindən qorunur HMAC ortaq sirr göndərildi X-AIHummer-Inbound-Secret başlıq (AIHUMMER_INBOUND_SECRET settings-catalog açarı — İdarəetmə → Ayarlar altında admin istifadəçi interfeysində və ya ilə konfiqurasiya olunub aihummer settings set, deyil gateway.env).

Metod və yol Məqsəd
POST /v1/inbound/telegram Yerleşik Telegram gələn payload-ları
POST /v1/inbound/generic E-poçt→vebhak, cron və xüsusi tətbiqlər üçün ümumi daxilolma
POST /v1/inbound/binding/status Kanal əlaqələndirmə vəziyyətini hesabat et

O ümumi endpoint, hər hansı bir mənbəni AiHummer-ə göndərməyin ən sadə yoludur. Kanal adı, sabit xarici identifikator və mesaj mətni ilə kiçik bir JSON bədəni göndərin:

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] Ümumi gələn dispatcher üçün standart iş sahəsi lazımdır. Təyin edin AIHUMMER_DEFAULT_WORKSPACE_ID beləliklə daxil olan mesajlar yönləndirilə bilər.

[!WARNING] Gələn son nöqtələr tərəfindən qorunmur ah- API açarı — onlar ona güvənirlər X-AIHummer-Inbound-Secret HMAC. Bu sirri müştəri tərəfi kodundan uzaq saxlayın və Əgər sızırsa, onu fırladın.

İnteqrasiya tetikleyiciləri (Zapier / Make)

POST /v1/integrations/trigger aşağı kodlu avtomatlaşdırma platformaları üçün giriş nöqtəsidir, məsələn Zapier və Etmək. Nöqtə sonu şifrə ilə söndürülüb: qədər AIHUMMER_INBOUND_TRIGGER_SECRET ayar qurulduqda cavab verir 501 Not Implemented. Bu bir ayrılmış sirli, fərqli AIHUMMER_INBOUND_SECRET; hər bir settings-catalog açarı kimi, bu da admin UI-də (İdarəetmə → Parametrlər) və ya ilə təyin olunur aihummer settings set.

Bir dəfə konfiqurasiya edildikdən sonra, son nöqtə ya birini qəbul edir X-AIHummer-Signature HMAC və ya aşağıdakı formada bir 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 iki endpoint Admin Sessions səhifəsinin daxili nəqliyyatı kimi saxlanılır. Onlar müştəri saytına yerləşdirilən dəstəklənən kanal deyil.

Metod və yol Məqsəd
POST /v1/web/session Admin Sessions söhbətini aç və ya davam etdir
GET /v1/web/stream Söhbət cavabını SSE kimi al

Hadisə axını

GET /v1/events/stream dır davam oluna bilən Şlüz hadisələrinin Server-Tərəfdən Göndərilən Hadisələr axını. Endpoint-in iki ciddi tələbi var:

  1. O ?workspace_id=<id> parametr məcburidir — onsuz sorğu ilə rədd edilir 400. Bir icarədar qoruyucusu iş yerinin kimə aid olduğunu təsdiqləyir zəng edən şəxsin kirayəçisi; başqasının workspace_id verir 403.
  2. Təsdiqləmə tələb olunur — bir admin sessiyası (kukisi) və ya bir ah- API açarı daxil et Authorization: Bearer başlıq. Onsuz cavab 401.

Keçmək ?since= əvvəlki əlaqənin dayandığı yerdən davam etmək üçün kursor, beləliklə yenidən qoşulma heç bir hadisəni itirmir.

# 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] Hər hadisə ilə daşıyan dəyəri növbəti kimi hesab edin since kursor. Açıq əlaqəni bərpa et, həmin kursorundan oynatmağa davam et ki, ən azı bir dəfə çatdırılma təmin edilsin istehlakçı.

Növbəti haradır