AiHummer
Հայերեն▾
Մուտք
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Մուտքային և ինտեգրման Triggers

Մուտքային և ինտեգրման Triggers

v1.0.x · թարմացվել է 2026-06-26

OpenAI-համատեղելի API-ից բացի, AiHummer-ը ընդունում է մուտքային հաղորդագրություններ կոնեկտորներից, ավտոմատացման հարթակներից և բրաուզերի widget-ից, և արձակում է սերվերի կողմից իրադարձությունների հոսք, որին կարող եք բաժանորդագրվել։ Այս վերջնակետները այն ձևն են, որով արտաքին համակարգերը աշխատանք են հանձնում gateway-ին, և ինչպես են UI-ները մնում կենդանի։

Մուտքային վերջնակետեր

Մուտքային վերջնակետները այն ձևն են, որով ալիքի կոնեկտորները և հատուկ ինտեգրումները հաղորդագրություն են հանձնում turn engine-ին։ Դրանք ապահովվում են HMAC համօգտագործվող գաղտնիքով, որն ուղարկվում է X-AIHummer-Inbound-Secret header-ում (կարգաբերվում է AIHUMMER_INBOUND_SECRET-ի միջոցով)։

Մեթոդ և path Նպատակ
POST /v1/inbound/telegram Native Telegram մուտքային payload-ներ
POST /v1/inbound/generic Generic մուտքային՝ email→webhook, cron և հատուկ հավելվածների համար
POST /v1/inbound/binding/status Հաղորդել ալիք-կապի կարգավիճակը

Generic վերջնակետը ամենապարզ ձևն է ցանկացած աղբյուր AiHummer մատակարարելու։ Ուղարկեք փոքր JSON մարմին՝ ալիքի անունով, կայուն արտաքին նույնացուցիչով և հաղորդագրության տեքստով՝

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] Generic մուտքային dispatcher-ին անհրաժեշտ է լռելյայն աշխատանքային տարածք։ Սահմանեք AIHUMMER_DEFAULT_WORKSPACE_ID, որպեսզի մուտքային հաղորդագրությունները կարողանան երթուղավորվել։

[!WARNING] Մուտքային վերջնակետները պաշտպանված չեն ah- API բանալիով — դրանք ապավինում են X-AIHummer-Inbound-Secret HMAC-ին։ Պահեք այդ գաղտնիքը client-side կոդից դուրս և պտտեք այն, եթե այն արտահոսի։

Ինտեգրման triggers (Zapier / Make)

POST /v1/integrations/trigger-ը մուտքակետն է low-code ավտոմատացման հարթակների համար, ինչպիսիք են Zapier-ը և Make-ը։ Այն ընդունում է կա՛մ X-AIHummer-Signature HMAC, կա՛մ Bearer token։

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

Web widget

Ներդրվող web widget-ն օգտագործում է երկու վերջնակետ՝ մեկը session բացելու և մեկը օգնականի պատասխանը հոսքով հաղորդելու համար։

Մեթոդ և path Նպատակ
POST /v1/web/session Բացել widget session
GET /v1/web/stream Ստանալ widget-ի պատասխանները որպես 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

Իրադարձությունների հոսք

GET /v1/events/stream-ը gateway իրադարձությունների վերսկսելի Server-Sent Events feed է։ Փոխանցեք ?since= cursor վերսկսելու համար այնտեղից, որտեղ նախորդ միացումն ընդհատվել էր, որպեսզի վերամիացումը երբեք չկորցնի իրադարձություններ։

# 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] Վերաբերվեք յուրաքանչյուր իրադարձության տանող արժեքին որպես հաջորդ since cursor։ Վերամիացման ժամանակ վերարտադրեք այդ cursor-ից՝ ձեր սպառողին առնվազն մեկ անգամ առաքումը երաշխավորելու համար։

Ուր գնալ հաջորդիվ