AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Saapuvat ja integraatiotriggerit

Saapuvat ja integraatiotriggerit

v1.2.x · päivitetty 2026-07-27

OpenAI-yhteensopivan API:n lisäksi AiHummer hyväksyy saapuvat viestit liittimistä ja automaatioalustoista ja lähettää palvelinpuolen tapahtumavirta johon voit tilata. Nämä päätepisteet ovat tapa, jolla ulkoiset järjestelmät toimittavat työtä portille ja miten käyttöliittymät pysyvät aktiivisina.

Saapuvat päätepisteet

Saapuvat päätepisteet ovat tapa, jolla kanavayhdistäjät ja mukautetut integraatiot välittävät viestin kääntömoottorille. Ne suojataan HMAC-jaettu salaisuus lähetettyssä X-AIHummer-Inbound-Secret otsikko (se AIHUMMER_INBOUND_SECRET settings-catalog-avain — määritetty järjestelmänvalvojan käyttöliittymässä kohdassa Hallinta → Asetukset tai aihummer settings set, ei sisällä gateway.env).

Menetelmä & polku Tarkoitus
POST /v1/inbound/telegram Natiiviset Telegramin saapuvat tietokuormat
POST /v1/inbound/generic Geneerinen saapuva sähköpostille→webhook, cron ja mukautetuille sovelluksille
POST /v1/inbound/binding/status Ilmoita kanavan sitomisen tila

Se yleinen Päätepiste on yksinkertaisin tapa syöttää mikä tahansa lähde AiHummeriin. Lähetä pieni JSON-rakenne, joka sisältää kanavan nimen, vakaan ulkoisen tunnisteen ja viestin tekstin:

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] Geneerinen saapuvan liikenteen lähettäjä tarvitsee oletustyötilan. Aseta AIHUMMER_DEFAULT_WORKSPACE_ID jotta saapuvat viestit voidaan ohjata.

[!WARNING] Saapuvat päätepisteet eivät ole suojattuja ah- API-avain — he luottavat siihen X-AIHummer-Inbound-Secret HMAC. Pidä tuo salaisuus poissa asiakaspuolen koodista ja kierrä sitä, jos se vuotaa.

Integraation laukaisimet (Zapier / Make)

POST /v1/integrations/trigger on sisäänkäyntipiste matalan koodin automaatioalustoille, kuten Zapier ja Tehdä. Päätepiste on pois käytöstä oletuksena: asti AIHUMMER_INBOUND_TRIGGER_SECRET asetus on määritetty se vastaa 501 Not Implemented. Tämä on erillinen salainen, erilainen kuin AIHUMMER_INBOUND_SECRET; kuten jokainen asetukset-katalogin avain, se asetetaan hallintakäyttöliittymässä (Hallinta → Asetukset) tai aihummer settings set.

Kun se on määritetty, päätepiste hyväksyy joko X-AIHummer-Signature HMAC tai kantajatunnus muodossa 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 -taustajärjestelmä

Nämä kaksi reittiä ovat Admin Sessions -sivua varten säilytetty sisäinen siirtokerros. Ne eivät ole tuettu asiakkaalle tarkoitettu upotettava kanava.

Menetelmä ja polku Tarkoitus
POST /v1/web/session Avaa Admin Sessions -keskustelu tai liitä se uudelleen
GET /v1/web/stream Suoratoista keskustelun vastaus SSE:nä

Tapahtumavirta

GET /v1/events/stream on jatkettavissa Palvelimen lähettämien tapahtumien syöte porttikonsolin tapahtumista. Päätepisteellä on kaksi koviin vaatimuksiin perustuvaa ehtoa:

  1. Se ?workspace_id=<id> parametri on pakollinen — ilman sitä pyyntö hylätään kanssa 400. Vuokralaisvalvoja varmistaa, että työtila kuuluu soittajan vuokralainen; jonkun toisen workspace_id tuottaa 403.
  2. Todennus vaaditaan — järjestelmänvalvojan istunto (eväste) tai ah- API näppäillä sisään Authorization: Bearer otsikko. Ilman sitä vastaus on 401.

Ohita ?since= kursorin jatkaminen siitä, mihin edellinen yhteys jäi, niin että uudelleenyhdistäminen ei koskaan menetä tapahtumia.

# 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] Kohtele kunkin tapahtuman kantamaa arvoa seuraavana since osoitin. Päällä yhdistä uudelleen, toista toiminnot siitä osoittimesta varmistaaksesi vähintään kerran toimituksen kohteeseesi kuluttaja.

Minne seuraavaksi