AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Declanșatoare de intrare și integrare

Declanșatoare de intrare și integrare

v1.0.x · actualizat 2026-06-26

Pe lângă API-ul compatibil OpenAI, AiHummer acceptă mesaje de intrare de la conectori, platforme de automatizare și un widget de browser și emite un flux de evenimente pe partea de server la care vă puteți abona. Aceste endpointuri sunt modul în care sistemele externe livrează muncă către gateway și modul în care interfețele rămân live.

Endpointuri de intrare

Endpointurile de intrare sunt modul în care conectorii de canal și integrările personalizate predau un mesaj motorului de ture. Ele sunt securizate printr-un secret partajat HMAC trimis în antetul X-AIHummer-Inbound-Secret (configurat prin AIHUMMER_INBOUND_SECRET).

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

Endpointul generic este cel mai simplu mod 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 de intrare generic are nevoie de un spațiu de lucru implicit. Setați AIHUMMER_DEFAULT_WORKSPACE_ID astfel încât mesajele de intrare să poată fi rutate.

[!WARNING] Endpointurile de intrare nu sunt protejate de o cheie API ah- — ele se bazează pe HMAC-ul X-AIHummer-Inbound-Secret. Țineți acel secret în afara codului din partea clientului și rotiți-l dacă se scurge.

Declanșatoare de integrare (Zapier / Make)

POST /v1/integrations/trigger este punctul de intrare pentru platformele de automatizare low-code, precum Zapier și Make. Acceptă fie un HMAC X-AIHummer-Signature, fie un token Bearer.

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

Widget web

Widgetul web încorporabil folosește două endpointuri: unul pentru a deschide o sesiune și unul pentru a transmite în streaming răspunsul asistentului.

Metodă și cale Scop
POST /v1/web/session Deschide o sesiune de widget
GET /v1/web/stream Primește răspunsurile widgetului sub formă de SSE 
# 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

Flux de evenimente

GET /v1/events/stream este un flux reluabil de Server-Sent Events cu evenimente de gateway. Treceți un cursor ?since= pentru a relua de unde s-a oprit o conexiune anterioară, astfel încât o reconectare să nu piardă niciodată evenimente.

# 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] Tratați valoarea purtată de fiecare eveniment ca următorul cursor since. La reconectare, redați de la acel cursor pentru a garanta livrarea cel-puțin-o-dată către consumatorul dumneavoastră.

Unde mai departe