Generiline sissetulev on universaalne sisenemispunkt AiHummerisse. Kui teie allikale ei ole spetsiaalset kanalit — e-posti jaotamine webhook-ile, cron-töö, sisemine tööriist — saadate sõnumi ühele lõpp-punktile ja see siseneb pöörlemismootorisse nagu iga teine kanali sõnum.
Lõpp-punkt
Saada üks JSON POST värava juurde:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Kehal on kolm välja:
channel — loogiline kanalinimi, mille valite allika jaoks.
external_id — stabiilne identifikaator lõppkasutaja või vestluse jaoks.
text — sõnumi sisu.
Autentimine
Lõpp-punkt on kaitstud HMAC kandes sees X-AIHummer-Inbound-Secret päis, tuletatud jagatud AIHUMMER_INBOUND_SECRET. Taotlusi ilma kehtiva allkirjata lükatakse tagasi, seega saavad sõnumeid lisada ainult kutsujad, kellel on saladus.
[!NOTE]
Sildil peab olema määratud vaike-tööruum
(AIHUMMER_DEFAULT_WORKSPACE_ID) üldiste sisenevate sõnumite edastamiseks.
Täiendavad kanalühendused
AiHummer pakub täiendavaid kanalite ühendajaid. Igaüks paigaldatakse Marketplace’ist, töötab hosti sees oma pordil ja edastab sissetulevad sõnumid /v1/inbound/generic.
Ühendus
Sadam
Märkmed
Discord
8801
Slack
8802
Maatriks
8803
Signaal
8804
nõuab signal-cli järelkäru
Microsoft Teams
8805
E-post (IMAP/SMTP)
8806
WhatsApp pilve API
8807
[!NOTE]
Pistikupesad paigaldatakse turuplatsilt; mõned vajavad täiendavat teenust
(näiteks, signal-cli Signalile).
Brauseri lisandmoodul
AiHummer tarnib ka brauserilaiendit, a Manifest V3 külgriba vestluse pind. See on kliendi /v1/chat/completions isikliku kasutamine ah- API võti — pole serveripoolne kanal. Kasutage seda isiklikuks vestluseks brauseris, mitte sissetuleva suunamise allikana.
**Generiline sissetulev on universaalne sisenemispunkt AiHummerisse.** Kui teie allikale ei ole spetsiaalset kanalit — e-posti jaotamine webhook-ile, cron-töö, sisemine tööriist — saadate sõnumi ühele lõpp-punktile ja see siseneb pöörlemismootorisse nagu iga teine kanali sõnum.
## Lõpp-punkt
Saada üks JSON `POST` värava juurde:
```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"
}
```
Kehal on kolm välja:
- **`channel`** — loogiline kanalinimi, mille valite allika jaoks.
- **`external_id`** — stabiilne identifikaator lõppkasutaja või vestluse jaoks.
- **`text`** — sõnumi sisu.
## Autentimine
Lõpp-punkt on kaitstud **HMAC** kandes sees **`X-AIHummer-Inbound-Secret`** päis, tuletatud jagatud **`AIHUMMER_INBOUND_SECRET`**. Taotlusi ilma kehtiva allkirjata lükatakse tagasi, seega saavad sõnumeid lisada ainult kutsujad, kellel on saladus.
> [!NOTE]
> Sildil peab olema määratud vaike-tööruum
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) üldiste sisenevate sõnumite edastamiseks.
## Täiendavad kanalühendused
AiHummer pakub täiendavaid kanalite ühendajaid. Igaüks paigaldatakse Marketplace'ist, töötab hosti sees oma pordil ja edastab sissetulevad sõnumid `/v1/inbound/generic`.
| Ühendus | Sadam | Märkmed |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Maatriks | 8803 | |
| Signaal | 8804 | nõuab `signal-cli` järelkäru |
| Microsoft Teams | 8805 | |
| E-post (IMAP/SMTP) | 8806 | |
| WhatsApp pilve API | 8807 | |
> [!NOTE]
> Pistikupesad paigaldatakse turuplatsilt; mõned vajavad täiendavat teenust
> (näiteks, `signal-cli` Signalile).
## Brauseri lisandmoodul
AiHummer tarnib ka brauserilaiendit, a **Manifest V3 külgriba** vestluse pind. See on **kliendi `/v1/chat/completions`** isikliku kasutamine `ah-` API võti — **pole serveripoolne kanal**. Kasutage seda isiklikuks vestluseks brauseris, mitte sissetuleva suunamise allikana.
## Kuhu järgmine
- Tootmisvestluse puhul vaata [Telegram](/et/v1.0/channels/telegram) ja
[MAX](/et/v1.0/channels/max).
- Töötajate IM puhul vaata [Bitrix24](/et/v1.0/channels/bitrix24).
- Rakenduse loomiseks API vastu? Vaata [vestlus/valmimised](/et/v1.0/api/chat-completions).
