AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Daxil olan və inteqrasiya tetikləyiciləri

Daxil olan və inteqrasiya tetikləyiciləri

v1.0.x · yeniləndi 2026-06-26

OpenAI-uyğun API-dən əlavə, AiHummer konnektorlardan, avtomatlaşdırma platformalarından və brauzer vidcetindən daxil olan mesajları qəbul edir, və abunə ola biləcəyiniz server tərəfli hadisə axını yayımlayır. Bu endpoint-lər xarici sistemlərin gateway-ə iş çatdırma və UI-ların canlı qalma yoludur.

Daxil olan endpoint-lər

Daxil olan endpoint-lər kanal konnektorlarının və xüsusi inteqrasiyaların növbə mühərrikinə bir mesaj ötürmə yoludur. Onlar X-AIHummer-Inbound-Secret başlığında göndərilən (AIHUMMER_INBOUND_SECRET vasitəsilə konfiqurasiya edilən) HMAC paylaşılan gizli açarı ilə qorunur.

Metod və yol Məqsəd
POST /v1/inbound/telegram Yerli Telegram daxil olan yükləri
POST /v1/inbound/generic email→webhook, cron və xüsusi tətbiqlər üçün ümumi daxil olan
POST /v1/inbound/binding/status Kanal-bağlama statusunu bildir

Ümumi endpoint istənilən mənbəni AiHummer-ə qidalandırmağın ən sadə yoludur. Kanal adı, sabit xarici identifikator və mesaj mətni ilə kiçik JSON gövdə 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 daxil olan dispetçerinə defolt iş sahəsi lazımdır. Daxil olan mesajların marşrutlaşdırıla bilməsi üçün AIHUMMER_DEFAULT_WORKSPACE_ID təyin edin.

[!WARNING] Daxil olan endpoint-lər ah- API açarı ilə qorunmur — onlar X-AIHummer-Inbound-Secret HMAC-ə güvənir. Həmin gizli açarı müştəri tərəfli koddan kənarda saxlayın və sızdırıldığı təqdirdə rotasiya edin.

İnteqrasiya tetikləyiciləri (Zapier / Make)

POST /v1/integrations/trigger Zapier və Make kimi az-kodlu avtomatlaşdırma platformaları üçün giriş nöqtəsidir. O, ya X-AIHummer-Signature HMAC, ya da Bearer token qəbul edir.

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

Veb vidcet

Yerləşdirilə bilən veb vidcet iki endpoint istifadə edir: biri sessiya açmaq, digəri assistentin cavabını axıtmaq üçün.

Metod və yol Məqsəd
POST /v1/web/session Vidcet sessiyası aç
GET /v1/web/stream Vidcet cavablarını SSE kimi al 
# 1) Open a session
curl https://your-aihummer.example/v1/web/session \
  -H "Content-Type: application/json" \
  -d '{}'

# 2) Stream responses (Server-Sent Events)
curl -N https://your-aihummer.example/v1/web/stream

Hadisə axını

GET /v1/events/stream gateway hadisələrinin bərpa edilə bilən Server-Sent Events lentidir. Əvvəlki bağlantının dayandığı yerdən davam etmək üçün ?since= kursoru ötürün ki, yenidən qoşulma heç vaxt hadisələri itirməsin.

# Subscribe from the beginning
curl -N https://your-aihummer.example/v1/events/stream

# Resume after a known cursor
curl -N "https://your-aihummer.example/v1/events/stream?since=<cursor>"

[!TIP] Hər hadisənin daşıdığı dəyəri növbəti since kursoru kimi qəbul edin. Yenidən qoşulduqda, istehlakçınıza ən-azı-bir-dəfə çatdırılmanı zəmanət etmək üçün həmin kursordan təkrar oynadın.

Sonra haraya