AiHummer
Қазақша▾
КіруЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Арналар/Жалпы кіріс

Жалпы кіріс

v1.0.x · жаңартылды 2026-06-26

Жалпы кіріс AiHummer-ге кіретін әмбебап нүкте болып табылады. Егер сіздің көзіңізге арналған арнайы арна болмаса — мысалы, электрондық хаттан вебхукке беру, cron жұмысы, ішкі құрал — сіз хабарламаны бір нүктеге жібересіз және ол кез келген басқа арна хабарламасы сияқты айналдыру қозғалтқышына енеді.

Соңғы нүкте

Бір JSON жіберу POST қақпаға:

POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>

{
  "channel": "my-app",
  "external_id": "user-42",
  "text": "Hello from my custom integration"
}

Дене үш өрісті тасымалдайды:

  • channel — бастапқы үшін таңдаған логикалық арна атауы.
  • external_id — соңғы пайдаланушы немесе әңгімелесу үшін тұрақты идентификатор.
  • text — хабар мазмұны.

Аутентификация

Соңғы нүкте арқылы қорғалған HMAC ішіне көтерілген X-AIHummer-Inbound-Secret тақырып, жалпыға ортақтан алынған **AIHUMMER_INBOUND_SECRET**Қолтаңба жоқ сұраулар қабылданбайды, сондықтан тек құпия кілтке ие шақырулар ғана хабарларды енгізе алады.

[!NOTE] Шлюзде әдепкі жұмыс кеңістігі конфигурацияланған болуы керек (AIHUMMER_DEFAULT_WORKSPACE_ID) жалпы кіріс хабарламаларды жіберу үшін.

Қосымша арна қосқыштары

AiHummer қосымша арна қосқыштарын ұсынады. Олардың әрқайсысы Marketplace-тен орнатылып, өзінің портында хост-табиғи түрде жұмыс істейді және кіріс хабарларды жібереді /v1/inbound/generic.

Коннектор Порт Ескертпелер
Дискорд 8801
Слак 8802
Матрица 8803
Сигнал 8804 қажет етеді signal-cli қасындағы арба
Microsoft Teams 8805
Электрондық пошта (IMAP/SMTP) 8806
WhatsApp бұлттық API 8807

[!NOTE] Коннекторлар Marketplace-тен орнатылады; кейбіреулері қосымша қызметті қажет етеді (мысалы, signal-cli Signal үшін).

Браузер кеңейтімі

AiHummer сондай-ақ браузер кеңейтімін жібереді, a Manifest V3 бүйірлік панель чат беті. Бұл клиент /v1/chat/completions жеке қолдана отырып ah- API кілті — сервер жағы каналы емес. Оны бағыттаудың кіріс көзі ретінде емес, жеке, шолғыш ішіндегі чат үшін пайдаланыңыз.

Келесі қайда