Ģenerisks ienākošais ir universālais ieejas punkts AiHummer. Kad nav īpaši izveidota kanāla jūsu avotam — e-pasta uz webhook pāradresācijas, cron uzdevuma, iekšējā rīka — jūs nosūtat ziņu uz vienu galapunktu, un tā nonāk turnu dzinējā kā jebkura cita kanāla ziņa.
Gala punkts
Sūtīt vienu JSON POST uz vārtiem:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Ķermenim ir trīs lauki:
channel — loģisks kanāla nosaukums, ko izvēlaties avotam.
external_id — stabils identifikators galalietotājam vai sarunai.
text — ziņas saturs.
Autentifikācija
Šis galapunkts ir aizsargāts ar HMAC nestāvēt iekšā X-AIHummer-Inbound-Secret galvene, iegūta no kopīgās AIHUMMER_INBOUND_SECRET. Pieprasījumi bez derīgas paraksta tiek noraidīti, tāpēc tikai tie izsaucēji, kuriem ir slepenais atslēga, var ievadīt ziņojumus.
[!NOTE]
Vārtejai jābūt konfigurētai ar noklusējuma darba vidi
(AIHUMMER_DEFAULT_WORKSPACE_ID) lai nosūtītu vispārīgus ienākošos ziņojumus.
Papildu kanālu savienotāji
AiHummer piedāvā papildu kanālu savienotājus. Katrs tiek instalēts no Tirgus vietas, darbojas saimniekdatorā savā portā un pārsūta ienākošos ziņojumus uz /v1/inbound/generic.
Savienotājs
Osta
Piezīmes
Discord
8801
Slack
8802
Matrica
8803
Signāls
8804
prasa signal-cli piedevvāģis
Microsoft Teams
8805
E-pasts (IMAP/SMTP)
8806
WhatsApp mākoņa API
8807
[!NOTE]
Savienotājus instalē no Tirdzniecības vietas; dažiem nepieciešams papildu serviss
(piemēram, signal-cli lietotnei Signal).
Pārlūkprogrammas paplašinājums
AiHummer arī piegādā pārlūkprogrammas paplašinājumu, a Manifest V3 sānu panelis čata virsma. Tas ir klients no /v1/chat/completions izmantojot personīgo ah- API atslēga — ne servera puse kanāls. Izmantojiet to personīgai tērzēšanai pārlūkprogrammā, nevis kā ienākošu avotu maršrutēšanai.
**Ģenerisks ienākošais ir universālais ieejas punkts AiHummer.** Kad nav īpaši izveidota kanāla jūsu avotam — e-pasta uz webhook pāradresācijas, cron uzdevuma, iekšējā rīka — jūs nosūtat ziņu uz vienu galapunktu, un tā nonāk turnu dzinējā kā jebkura cita kanāla ziņa.
## Gala punkts
Sūtīt vienu JSON `POST` uz vārtiem:
```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"
}
```
Ķermenim ir trīs lauki:
- **`channel`** — loģisks kanāla nosaukums, ko izvēlaties avotam.
- **`external_id`** — stabils identifikators galalietotājam vai sarunai.
- **`text`** — ziņas saturs.
## Autentifikācija
Šis galapunkts ir aizsargāts ar **HMAC** nestāvēt iekšā **`X-AIHummer-Inbound-Secret`** galvene, iegūta no kopīgās **`AIHUMMER_INBOUND_SECRET`**. Pieprasījumi bez derīgas paraksta tiek noraidīti, tāpēc tikai tie izsaucēji, kuriem ir slepenais atslēga, var ievadīt ziņojumus.
> [!NOTE]
> Vārtejai jābūt konfigurētai ar noklusējuma darba vidi
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) lai nosūtītu vispārīgus ienākošos ziņojumus.
## Papildu kanālu savienotāji
AiHummer piedāvā papildu kanālu savienotājus. Katrs tiek instalēts no Tirgus vietas, darbojas saimniekdatorā savā portā un pārsūta ienākošos ziņojumus uz `/v1/inbound/generic`.
| Savienotājs | Osta | Piezīmes |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrica | 8803 | |
| Signāls | 8804 | prasa `signal-cli` piedevvāģis |
| Microsoft Teams | 8805 | |
| E-pasts (IMAP/SMTP) | 8806 | |
| WhatsApp mākoņa API | 8807 | |
> [!NOTE]
> Savienotājus instalē no Tirdzniecības vietas; dažiem nepieciešams papildu serviss
> (piemēram, `signal-cli` lietotnei Signal).
## Pārlūkprogrammas paplašinājums
AiHummer arī piegādā pārlūkprogrammas paplašinājumu, a **Manifest V3 sānu panelis** čata virsma. Tas ir **klients no `/v1/chat/completions`** izmantojot personīgo `ah-` API atslēga — **ne servera puse kanāls**. Izmantojiet to personīgai tērzēšanai pārlūkprogrammā, nevis kā ienākošu avotu maršrutēšanai.
## Kur uz nākamo
- Ražošanas tērzēšanai skatīt [Telegramma](/lv/v1.0/channels/telegram) un
[MAKS](/lv/v1.0/channels/max).
- Personāla IM skatīt [Bitrix24](/lv/v1.0/channels/bitrix24).
- Veidojat pret API? Skatīt [čats/pabeigumi](/lv/v1.0/api/chat-completions).
