Bendras įeinamasis yra universali įėjimo į AiHummer taškas. Kai nėra specialiai sukurto kanalo jūsų šaltiniui – el. pašto į webhook relė, cron užduotis, vidinis įrankis – jūs siunčiate pranešimą į vieną galinį tašką, ir jis įeina į pokalbių variklį kaip bet koks kitas kanalo pranešimas.
Galutinis taškas
Siųsti vieną JSON POST į vartus:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Kūnas turi tris laukus:
channel — logiškas kanalo pavadinimas, kurį pasirenkate šaltiniui.
external_id — stabilus identifikatorius galutiniam vartotojui arba pokalbiui.
text — pranešimo turinys.
Autentifikavimas
Galinis taškas yra apsaugotas HMAC nešamas į X-AIHummer-Inbound-Secret antraštė, kilusi iš bendro AIHUMMER_INBOUND_SECRET. Užklausos be galiojančio parašo yra atmetamos, todėl tik tie kvietėjai, kurie turi paslaptį, gali įterpti žinutes.
[!NOTE]
Šliuzas turi turėti sukonfigūruotą numatytąją darbo sritį
(AIHUMMER_DEFAULT_WORKSPACE_ID) siųsti bendrus gaunamus pranešimus.
Papildomi kanalų jungtukai
AiHummer siūlo papildomus kanalo jungtis. Kiekviena įdiegiama iš Rinkos aikštelės, veikia savo prigimtiniame prievade ir perduoda įeinančias žinutes į /v1/inbound/generic.
Jungtis
Uostas
Pastabos
Discord
8801
Slack
8802
Matrica
8803
Signalas
8804
reikalauja signal-cli šoninė priekaba
Microsoft Teams
8805
El. paštas (IMAP/SMTP)
8806
WhatsApp debesų API
8807
[!NOTE]
Jungtys įdiegiamos iš Prekyvietės; kai kurioms reikalinga papildoma paslauga
(pavyzdžiui, signal-cli skirto Signal.
Naršyklės plėtinys
AiHummer taip pat siunčia naršyklės plėtinį, a „Manifest V3“ šoninė panelė pokalbių paviršius. Tai yra klientas /v1/chat/completions naudojant asmeninį ah- API raktas — ne serverio pusės kanalas. Naudokite tai asmeniniam pokalbiui naršyklėje, o ne kaip įeinantį maršrutizavimo šaltinį.
**Bendras įeinamasis yra universali įėjimo į AiHummer taškas.** Kai nėra specialiai sukurto kanalo jūsų šaltiniui – el. pašto į webhook relė, cron užduotis, vidinis įrankis – jūs siunčiate pranešimą į vieną galinį tašką, ir jis įeina į pokalbių variklį kaip bet koks kitas kanalo pranešimas.
## Galutinis taškas
Siųsti vieną JSON `POST` į vartus:
```http
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"
}
```
Kūnas turi tris laukus:
- **`channel`** — logiškas kanalo pavadinimas, kurį pasirenkate šaltiniui.
- **`external_id`** — stabilus identifikatorius galutiniam vartotojui arba pokalbiui.
- **`text`** — pranešimo turinys.
## Autentifikavimas
Galinis taškas yra apsaugotas **HMAC** nešamas į **`X-AIHummer-Inbound-Secret`** antraštė, kilusi iš bendro **`AIHUMMER_INBOUND_SECRET`**. Užklausos be galiojančio parašo yra atmetamos, todėl tik tie kvietėjai, kurie turi paslaptį, gali įterpti žinutes.
> [!NOTE]
> Šliuzas turi turėti sukonfigūruotą numatytąją darbo sritį
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) siųsti bendrus gaunamus pranešimus.
## Papildomi kanalų jungtukai
AiHummer siūlo papildomus kanalo jungtis. Kiekviena įdiegiama iš Rinkos aikštelės, veikia savo prigimtiniame prievade ir perduoda įeinančias žinutes į `/v1/inbound/generic`.
| Jungtis | Uostas | Pastabos |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrica | 8803 | |
| Signalas | 8804 | reikalauja `signal-cli` šoninė priekaba |
| Microsoft Teams | 8805 | |
| El. paštas (IMAP/SMTP) | 8806 | |
| WhatsApp debesų API | 8807 | |
> [!NOTE]
> Jungtys įdiegiamos iš Prekyvietės; kai kurioms reikalinga papildoma paslauga
> (pavyzdžiui, `signal-cli` skirto Signal.
## Naršyklės plėtinys
AiHummer taip pat siunčia naršyklės plėtinį, a **„Manifest V3“ šoninė panelė** pokalbių paviršius. Tai yra **klientas `/v1/chat/completions`** naudojant asmeninį `ah-` API raktas — **ne serverio pusės kanalas**. Naudokite tai asmeniniam pokalbiui naršyklėje, o ne kaip įeinantį maršrutizavimo šaltinį.
## Kur toliau
- Dėl gamybos pokalbio žr. [Telegrama](/lt/v1.0/channels/telegram) ir
[MAKS](/lt/v1.0/channels/max).
- Dėl darbuotojų IM žr. [Bitrix24](/lt/v1.0/channels/bitrix24).
- Kuriate prieš API? Žr. [pokalbis/užbaigimai](/lt/v1.0/api/chat-completions).
