AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Içeri we Integrasiýa Trigerleri

Içeri we Integrasiýa Trigerleri

v1.2.x · täzelendi 2026-07-27

OpenAI bilen gabat gelýän API-dan başga-da, AiHummer kabul edýär gelýän hatlar baglaýjylardan we awtomatlaşdyrma platformalaryndan we çykarýar serwer taraplaýyn wakalar akymy siz abuna bolup bilersiňiz. Bu nokatlar daşarky ulgamlaryň işleri gapyja ýetirmegi we ulanyjy interfeysleriň janly bolmagyny üpjün edýän ýollardyr.

Gelýän nokatlar

Gelýän ahyrky nokatlar arkaly kanal birleşdirijileri we ýörite integrasiýalar habarlary öwrüm motoryna geçirýär. Olary X-AIHummer-Inbound-Secret sözbaşysynda iberilýän paýlaşylýan HMAC syry goraýar (AIHUMMER_INBOUND_SECRET sazlamalar katalogynyň açarydyr; ol dolandyryş interfeýsiniň Management → Settings bölüminde ýa-da aihummer settings set buýrugy bilen sazlanýar, gateway.env-de däl).

Usul we ýol Maksat
POST /v1/inbound/telegram Asyl Telegram girýän ýükler
POST /v1/inbound/generic Elektron poçta→webhook, cron we ýörite programmalary üçin umumy girýän
POST /v1/inbound/binding/status Kanal baglanyşygyny hasabat ber

Şu umumy uç nokady, islendik çeşmäni AiHummer-e iýmitlendirmmegiň iň ýönekeý usulydyr. Kanal ady, durnukly daşarky aýrylga we habar teksti bilen kiçi JSON göwrümi iberiň:

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] Umumy gelýän iberiji üçin öňünden bellenilen iş meýdançasy gerek. Sazla AIHUMMER_DEFAULT_WORKSPACE_ID şeýlelik bilen gelýän habarlary ugrukdyrmak bolýar.

[!WARNING] Içeri girýän uç nokatlar bilen goraýan öňüni alman ah- API açary — olar şuna baglydyrlar X-AIHummer-Inbound-Secret HMAC. Muny müşderi tarapy kodyndan gizlin sakla we Eger syzsa, ony öwür.

Integrasiýa tötörgeçleri (Zapier / Make)

POST /v1/integrations/trigger daşky kodsyz awtomatlaşdyryş platformalary üçin giriş nokady bolup durýar Zapier we Düzmek. Çykdajy nokady standart boýy işe ýaramaz: çenli AIHUMMER_INBOUND_TRIGGER_SECRET saýlama sazlandyrylanda ol bilen jogap berýär 501 Not Implemented. Bu bir ayıraýmak gizlin, tapawutly AIHUMMER_INBOUND_SECRET; ähli sazlama katalog açary ýaly, ol dolandyryş interfeýsinde (Dolandyryş → Sazlamalar) ýa-da bilen kesgitlenilýär aihummer settings set.

Bir gezek sazlanan bady, nokat ýa öňki kabul edýär X-AIHummer-Signature HMAC ýa-da görnüşindäki Bearer tokeni 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 nokat Admin Sessions sahypasynyň içerki transporty hökmünde saklanýar. Olar müşderiniň saýtyna ýerleşdirilýän goldanylýan kanal däldir.

Usul we ýol Maksat
POST /v1/web/session Admin Sessions söhbetini aç ýa-da dowam etdir
GET /v1/web/stream Söhbetiň jogabyny SSE hökmünde al

Waka akymy

GET /v1/events/stream -dyr täzeden dowam etdirip bolýan Şluz wakalarynyň Serwer tarapyndan iberilen wakalaryny (Server-Sent Events) üpjün edýän akym. Bu nokat üçin iki sany çäklendirme talap bar:

  1. Şu ?workspace_id=<id> parametr hökmanydyr — munuňsyz haýyş berra edilýär 400. Ijarçy goragçysy iş bölüminiň eýesine degişli bolandygyny barlaýar jaň edijiniň kärendeçisi; beýlekiniň workspace_id hasyl bolýar 403.
  2. Tassyklama talap edilýär — bir administrasiýa sessiýasy (peçenye) ýa-da bir ah- API birine açar Authorization: Bearer başlyk. Ondan bolmasa jogap 401.

Geç ?since= öňki baglanyşyk goşaýan ýerine dowam etmek üçin kursory, şonuň üçin täzeden baglanyşmak hiç haçan wakalary ýitirmeýär.

# 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] Her wakanyň alyp barýan gymmatyny indiki hasap ediň since kursor. On täzeden baglanyş, bu kursordan gaýtadan oýnatmak bilen elmydama azyndan bir gezek eltip bermäni kepillendiriň iste’molçy.

Indi nire?