AiHummer
Norsk▾
Logg påKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Inngående og integrasjonsutløsere

Inngående og integrasjonsutløsere

v1.2.x · oppdatert 2026-07-27

Utover den OpenAI-kompatible API-en, aksepterer AiHummer innkommende meldinger fra koblinger og automatiseringsplattformer, og sender ut en server-side hendelsesstrøm du kan abonnere på. Disse endepunktene er hvordan eksterne systemer leverer arbeid til gatewayen, og hvordan brukergrensesnitt forblir aktive.

Innkommende endepunkter

Innkommende endepunkter er hvordan kanaltilkoblinger og tilpassede integrasjoner leverer en melding til turn-motoren. De er sikret av en HMAC delt hemmelighet sendt inn i X-AIHummer-Inbound-Secret overskrift (AIHUMMER_INBOUND_SECRET innstillinger-katalognøkkel — konfigurert i administrasjonsgrensesnittet under Administrasjon → Innstillinger eller med aihummer settings set, ikke i gateway.env).

Metode og sti Formål
POST /v1/inbound/telegram Inngående data fra Native Telegram
POST /v1/inbound/generic Generisk innkommende for e-post→webhook, cron og egendefinerte apper
POST /v1/inbound/binding/status Rapporter kanalbindingstatus

Den generisk endepunktet er den enkleste måten å sende hvilken som helst kilde til AiHummer på. Send en liten JSON-body med kanalnavnet, en stabil ekstern identifikator og meldingsteksten:

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] Den generiske innkommende dispatcheren trenger et standard arbeidsområde. Sett AIHUMMER_DEFAULT_WORKSPACE_ID slik at innkommende meldinger kan rutes.

[!WARNING] Innkommende endepunkter er ikke beskyttet av en ah- API-nøkkel — de er avhengige av X-AIHummer-Inbound-Secret HMAC. Hold den hemmeligheten unna klientkode og dre det hvis det lekker.

Integrasjonsutløsere (Zapier / Make)

POST /v1/integrations/trigger er inngangspunktet for lavkode-automatiseringsplattformer som Zapier og Lage. Endepunktet er deaktivert som standard: til AIHUMMER_INBOUND_TRIGGER_SECRET innstilling er konfigurert den svarer med 501 Not Implemented. Dette er en separat hemmelig, forskjellig fra AIHUMMER_INBOUND_SECRET; som alle innstillinger-katalognøkler, settes den i administrasjonsgrensesnittet (Administrasjon → Innstillinger) eller med aihummer settings set.

Når den er konfigurert, aksepterer endepunktet enten en X-AIHummer-Signature HMAC eller en bærertoken av formen 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 for Admin Sessions

Disse to rutene er det interne transportlaget som beholdes for siden Admin Sessions. De er ikke en støttet, innebyggbar kundekanal.

Metode og bane Formål
POST /v1/web/session Åpne eller koble til en Admin Sessions-samtale på nytt
GET /v1/web/stream Strøm svaret fra samtalen via SSE

Hendelsesstrøm

GET /v1/events/stream er en gjenopptakbar Server-Sent Events-strøm av gateway-hendelser. Endepunktet har to faste krav:

  1. Den ?workspace_id=<id> parameter er obligatorisk — uten det forespørselen avvises med 400. En leietakervakt verifiserer at arbeidsområdet tilhører innringerens leietaker; noen andres workspace_id gir 403.
  2. Autentisering er påkrevd — en admin-økt (informasjonskapsel) eller en ah- API tast inn en Authorization: Bearer overskrift. Uten den er svaret 401.

Gi videre ?since= markør for å gjenoppta fra der en tidligere tilkobling slapp, slik at en gjenforbindelse aldri mister hendelser.

# 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] Behandle verdien som bæres av hver hendelse som den neste since markør. På koble til igjen, spill av fra den markøren for å garantere minst én-gang levering til din forbruker.

Hvor til neste