AiHummer
Română▾
AutentificareCont personal
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Declanșatoare de intrare și integrare

Declanșatoare de intrare și integrare

v1.0.x · actualizat 2026-07-27

Dincolo de API-ul compatibil cu OpenAI, AiHummer acceptă mesaje primite de la conectori și platforme de automatizare și emite un flux de evenimente pe partea serverului la care te poți abona. Aceste puncte finale sunt modul în care sistemele externe livrează munca către gateway și modul în care interfețele utilizatorului rămân active.

Puncte finale de intrare

Punctele finale de intrare sunt modul în care conectorii de canale și integrările personalizate livrează un mesaj către motorul de procesare. Ele sunt securizate printr-un Secret partajat HMAC trimis în X-AIHummer-Inbound-Secret antet (cel AIHUMMER_INBOUND_SECRET cheia settings-catalog — configurată în interfața de administrare sub Management → Setări sau cu aihummer settings set, nu în gateway.env).

Metodă și cale Scop
POST /v1/inbound/telegram Payload-uri native de intrare Telegram
POST /v1/inbound/generic Generic inbound pentru email→webhook, cron și aplicații personalizate
POST /v1/inbound/binding/status Raportează starea legării canalului

generic endpoint-ul este cea mai simplă metodă de a alimenta orice sursă în AiHummer. Trimiteți un corp JSON mic cu numele canalului, un identificator extern stabil și textul mesajului:

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] Dispatcherul generic de intrare are nevoie de un spațiu de lucru implicit. Setează AIHUMMER_DEFAULT_WORKSPACE_ID astfel încât mesajele primite să poată fi direcționate.

[!WARNING] Punctele finale de intrare nu sunt protejate de un ah- Cheie API — ei se bazează pe X-AIHummer-Inbound-Secret HMAC. Ține acel secret departe de codul de pe partea clientului și rotește-l dacă picură.

Declanșatoare de integrare (Zapier / Make)

POST /v1/integrations/trigger este punctul de intrare pentru platformele de automatizare low-code, cum ar fi Zapier și A face. Punctul final este dezactivat implicit: până la AIHUMMER_INBOUND_TRIGGER_SECRET setarea este configurată răspunde cu 501 Not Implemented. Acesta este un separa secret, distinct de AIHUMMER_INBOUND_SECRET; ca orice cheie din catalogul de setări, este setată în interfața de administrare (Management → Setări) sau cu aihummer settings set.

Odată configurat, punctul final acceptă fie un X-AIHummer-Signature HMAC sau un token Bearer de forma 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."
  }'

Backend Admin Sessions

Aceste două endpointuri sunt păstrate ca transport intern pentru pagina Admin Sessions. Ele nu sunt un canal încorporabil pentru clienți.

Metodă și cale Scop
POST /v1/web/session Deschide sau continuă un dialog Admin Sessions
GET /v1/web/stream Primește răspunsul dialogului ca SSE

Flux de evenimente

GET /v1/events/stream este reluabil Flux de evenimente transmise de server pentru evenimentele gateway. Endpoint-ul are două cerințe stricte:

  1. ?workspace_id=<id> parametrul este obligatoriu — fără ea cererea este respins cu 400. Un agent de chiriaș verifică dacă spațiul de lucru aparține chiriașul apelantului; al altcuiva workspace_id randamente 403.
  2. Este necesară autentificarea — o sesiune de admin (cookie) sau un ah- API introduceți într-un Authorization: Bearer antet. Fără el, răspunsul este 401.

Trece ?since= cursor pentru a relua de unde a rămas o conexiune anterioară, astfel încât o reconectare să nu piardă niciodată evenimente.

# 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] Tratează valoarea purtată de fiecare eveniment ca pe următoarea since cursor. Pornit reconectează-te, redă din acel cursor pentru a garanta livrarea cel puțin o dată către tine consumator.

Unde următor?