AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Иҩнаауа & интеграциатә триггерцәа

Иҩнаауа & интеграциатә триггерцәа

v1.0.x · ирҿыцуп 2026-06-26

OpenAI-иадҳәалоу API ацынхәрас, AiHummer иаднахылоит иҩнаауа ацҳамҭақәа коннекторцәа, автоматизациатә-аплатформацәа насгьы абраузер-виджет рҟынтә, насгьы иҭнагалоит сервер-ахьыгазоу аивент-астрим шәара ишәынанашьҭартәу. Абарҭ ахьырргоу ауп аҩныҵҟатәи асистемацәа аусура ашлюз ахь рҭара насгьы UI-цәа дбыргны ианхо.

Иҩнаауа ахьырргоу

Иҩнаауа ахьырргоу ауп аканал-коннекторцәа насгьы хазыхҟаҵоу интеграциақәа ацҳамҭа абжьабыргра-мотор ахь ииҭо. Урҭ ирыхьчоуп HMAC шәоу секрет ала иршьҭуа X-AIHummer-Inbound-Secret ахьыршаҳәа (иаконфигурированоу AIHUMMER_INBOUND_SECRET ала).

Аметоди амҩеи Иазҟьоу
POST /v1/inbound/telegram Иҷыдоу Telegram иҩнаауа пейлоудқәа
POST /v1/inbound/generic Идҟьоу иҩнаауа email→webhook, cron насгьы хазыхҟаҵоу аппцәа разы
POST /v1/inbound/binding/status Иаарԥшуа аканал-аԥшьара астатус

Идҟьоу ахьырргоу ауп еиҵыхәу амҩа иарбану зегь 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] Идҟьоу иҩнаауа адиспетчер иаҭахуп адефолт аусуратә. Иргала AIHUMMER_DEFAULT_WORKSPACE_ID иҩнаауа ацҳамҭақәа имаршрутизартәу разы.

[!WARNING] Иҩнаауа ахьырргоу ирыхьчам ah- API калит ала — урҭ иадгылоит X-AIHummer-Inbound-Secret HMAC ахь. Иршә убри секрет клиент-ахьыгазоу акод аҟнытә насгьы иаԥхьаԥхьа иаалырҟьар.

Интеграциатә триггерцәа (Zapier / Make)

POST /v1/integrations/trigger ауп алагара аҭыԥ low-code автоматизациатә аплатформацәа разы Zapier насгьы Make реиԥш. Уи иаднахылоит ма X-AIHummer-Signature HMAC ма 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."
  }'

Веб-виджет

Иадгыларатәу веб-виджет ихархәоит ҩба ахьырргоу: акак асессиа аартра разы насгьы акак ассистент ажәап астриминг разы.

Аметоди амҩеи Иазҟьоу
POST /v1/web/session Иаарт виджет асессиа
GET /v1/web/stream Иаиура виджет ажәапқәа 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 ауп иаԥхьаԥхьартәу Server-Sent Events ашлюз аивентцәа рфид. Ишьҭга ?since= курсор уаанӡатәи аиадҳәалара ахьаанажьыз аҟынтә аиҭалагара разы, убри ала аиҭаиадҳәалара зныкгьы аивентцәа лашьуам.

# 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 курсорс. Аиҭаиадҳәалара аҿы, иҩаԥхьа убри акурсор аҟнытә, шәара иршәынашьҭ ахь ицымҩаԥгакуа-ала акак-ала аус-ҟаҵара агарантиа разы.

Уаха ахь