AiHummer
Latviešu▾
PierakstītiesKonts
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Ienākošie un integrācijas aktivatori

Ienākošie un integrācijas aktivatori

v1.0.x · atjaunināts 2026-07-27

Papildus OpenAI saderīgajam API, AiHummer pieņem ienākošie ziņojumi no savienotājiem un automatizācijas platformām, un izstaro servera puses notikumu straume jūs varat abonēt. Šie galapunkta punkti ir veids, kā ārējās sistēmas piegādā darbu vārtejai un kā lietotāja interfeisi paliek aktīvi.

Ienākošie galapunkti

Ieejošie galapunkti ir tas, kā kanālu savienotāji un pielāgotās integrācijas nodod ziņojumu pagrieziena dzinējam. Tie ir aizsargāti ar HMAC kopīgā slepena atslēga nosūtīts X-AIHummer-Inbound-Secret galvene (tas AIHUMMER_INBOUND_SECRET settings-catalog atslēga — konfigurēta administratora lietotāja saskarnē sadaļā Pārvaldība → Iestatījumi vai ar aihummer settings set, ne iekšā gateway.env).

Metode un ceļš Mērķis
POST /v1/inbound/telegram Dabiskie Telegram ienākošie dati
POST /v1/inbound/generic Ģenerisks ienākošais e-pastam → webhook, cron un pielāgotām lietotnēm
POST /v1/inbound/binding/status Ziņot par kanāla saistīšanas statusu

Tas vispārējs galapunkts ir vienkāršākais veids, kā ievadīt jebkuru avotu AiHummer. Nosūtiet nelielu JSON objektu ar kanāla nosaukumu, stabilu ārēju identifikatoru un ziņas tekstu:

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] Vispārīgajam ienākošo ziņojumu dispečeram nepieciešama noklusējuma darbavieta. Iestatīt AIHUMMER_DEFAULT_WORKSPACE_ID tātad ienākošie ziņojumi var tikt maršrutēti.

[!WARNING] Ienākošie galapunkti nav aizsargāti ar ah- API atslēga — viņi paļaujas uz X-AIHummer-Inbound-Secret HMAC. Glabājiet šo noslēpumu ārpus klienta puses koda un pagriez to, ja tas noplūst.

Integrācijas trigeri (Zapier / Make)

POST /v1/integrations/trigger ir ieejas punkts zemas koda automatizācijas platformām, piemēram, Zapier un Izgatavot. Gala punkts ir pēc noklusējuma atspējots: līdz AIHUMMER_INBOUND_TRIGGER_SECRET iestatījums ir konfigurēts, tas atbild ar 501 Not Implemented. Tas ir atsevišķs slepeni, atšķirīgs no AIHUMMER_INBOUND_SECRET; tāpat kā katrs settings-catalog atslēgas ieraksts, tas tiek iestatīts administrācijas saskarnē (Pārvaldība → Iestatījumi) vai ar aihummer settings set.

Kad konfigurēts, galapunkts pieņem vai nu X-AIHummer-Signature HMAC vai nesēja žetons formā 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 aizmugursistēma

Šie divi maršruti ir iekšējais transports, kas saglabāts lapai Admin Sessions. Tie nav atbalstīts klientiem paredzēts iegulstams kanāls.

Metode un ceļš Mērķis
POST /v1/web/session Atvērt vai atkārtoti piesaistīt Admin Sessions sarunu
GET /v1/web/stream Straumēt sarunas atbildi ar SSE

Notikumu plūsma

GET /v1/events/stream ir atsākams Vārtu notikumu Server-Sent Events plūsma. Galapunkts ir divi stingri nosacījumi:

  1. Tas ?workspace_id=<id> parametrs ir obligāts — bez tā pieprasījums ir noraidīts ar 400. Noma drošības darbinieks pārbauda, vai darba vieta pieder zvanītāja īrnieks; kāda cita workspace_id raža 403.
  2. Autentifikācija ir nepieciešama — administrēšanas sesija (sīkfails) vai ah- API atslēga Authorization: Bearer galvene. Bez tās atbilde ir 401.

Izlaist ?since= kursors atsākt no vietas, kur iepriekšējā savienojuma pārtraukums beidzās, tāpēc atkārtota pieslēgšanās nekad nezaudē notikumus.

# 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] Apstrādājiet katra notikuma nesošo vērtību kā nākamo since kursors. Ieslēgts pievienoties atkārtoti, atsākt no tā kursora, lai garantētu vismaz vienu piegādi jūsu patērētājs.

Kur uz nākamo