AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Içerki we integrasiýa triggerleri

Içerki we integrasiýa triggerleri

v1.0.x · täzelendi 2026-06-26

OpenAI bilen utgaşýan API-den başga, AiHummer baglanyşdyryjylardan, awtomatizasiýa platformalaryndan we brauzer widgetinden içerki habarlary kabul edýär we siziň abuna ýazyp biljek serwer tarapyndaky waka akymyny çykarýar. Bu nokatlar daşky ulgamlaryň derwezä iş bermeginiň we UI-leriň janly galmagynyň usulydyr.

Içerki nokatlar

Içerki nokatlar — kanal baglanyşdyryjylarynyň we özboluşly integrasiýalaryň nobat hereketlendirijisine habar bermeginiň usulydyr. Olar X-AIHummer-Inbound-Secret başlygynda iberilýän HMAC umumy syry bilen goralýar (AIHUMMER_INBOUND_SECRET arkaly sazlanýar).

Usul we ýol Maksat
POST /v1/inbound/telegram Natiw Telegram içerki ýükleri
POST /v1/inbound/generic email→webhook, cron we özboluşly programmalar üçin umumy içerki
POST /v1/inbound/binding/status Kanal-baglanyşyk ýagdaýyny habar ber

Generic nokady islendik çeşmäni AiHummer-e iýmitlendirmegiň iň ýönekeý usulydyr. Kanal ady, durnukly daşky kesgitleýji we habar teksti bilen kiçi JSON beden 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 içerki dispetçere deslapky iş giňişligi gerek. Içerki habarlar ugrukdyrylyp bilner ýaly AIHUMMER_DEFAULT_WORKSPACE_ID belläň.

[!WARNING] Içerki nokatlar ah- API açary bilen goralmaýar — olar X-AIHummer-Inbound-Secret HMAC-a bil baglaýar. Şol syry müşderi tarapyndaky koddan daşda saklaň we ol syzsa ony aýlaň.

Integrasiýa triggerleri (Zapier / Make)

POST /v1/integrations/trigger — Zapier we Make ýaly az kodly awtomatizasiýa platformalary üçin giriş nokadydyr. Ol ýa X-AIHummer-Signature HMAC-y ýa-da Bearer belgisini kabul edýär.

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

Web widget

Ýerleşdirip bolýan web widgeti iki nokady ulanýar: biri sessiýany açmak üçin we biri kömekçiniň jogabyny akym etmek üçin.

Usul we ýol Maksat
POST /v1/web/session Widget sessiýasyny aç
GET /v1/web/stream Widget jogaplaryny SSE hökmünde 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

Waka akymy

GET /v1/events/stream — derweze wakalarynyň dowam etdirip bolýan Server-Sent Events iýmidir. Öňki birikmäniň galan ýerinden dowam etmek üçin ?since= kursoryny geçiriň, şonuň üçin gaýtadan birikme hiç haçan wakalary ýitirmeýär.

# 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] Her wakanyň göterýän bahasyny indiki since kursory hökmünde garaň. Gaýtadan birikmede, sarp edijiňize azyndan bir gezek ýetirmegi kepillendirmek üçin şol kursordan gaýtalaň.

Indiki nirä