Generisk indgående er det universelle indgangspunkt til AiHummer. Når der ikke er en formålsbygget kanal til din kilde — en e-mail-til-webhook relæ, et cron-job, et internt værktøj — sender du beskeden til et endepunkt, og den kommer ind i turmotoren som enhver anden kanalbesked.
Endepunktet
Send en enkelt JSON POST til porten:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Kroppen bærer tre felter:
channel — et logisk kanalnavn, du vælger for kilden.
external_id — en stabil identifikator for slutbrugeren eller samtalen.
text — beskedens indhold.
Autentificering
Endepunktet er sikret af en HMAC båret i X-AIHummer-Inbound-Secret header, afledt af den delte AIHUMMER_INBOUND_SECRET. Forespørgsler uden en gyldig signatur afvises, så kun kaldere, der har hemmeligheden, kan indsende beskeder.
[!NOTE]
Gatewayen skal have et standardarbejdsområde konfigureret
(AIHUMMER_DEFAULT_WORKSPACE_ID) til at afsende generiske indgående meddelelser.
Yderligere kanaltilslutninger
AiHummer tilbyder yderligere kanalforbindere. Hver installeres fra Marketplace, kører vært-native på sin egen port og videresender indgående beskeder til /v1/inbound/generic.
Forbinder
Havn
Noter
Discord
8801
Slack
8802
Matrix
8803
Signal
8804
kræver en signal-cli sidevogn
Microsoft Teams
8805
Email (IMAP/SMTP)
8806
WhatsApp Cloud API
8807
[!NOTE]
Stikkene installeres fra Marketplace; nogle kræver en ekstra tjeneste
(for eksempel, signal-cli for Signal).
Browserudvidelsen
AiHummer leverer også en browserudvidelse, en Manifest V3 sidepanel chatflade. Det er en klient af /v1/chat/completions ved hjælp af en personlig ah- API-nøgle — ikke en server-side kanal. Brug det til personlig chat i browseren fremfor som en indgående kilde til routing.
**Generisk indgående er det universelle indgangspunkt til AiHummer.** Når der ikke er en formålsbygget kanal til din kilde — en e-mail-til-webhook relæ, et cron-job, et internt værktøj — sender du beskeden til et endepunkt, og den kommer ind i turmotoren som enhver anden kanalbesked.
## Endepunktet
Send en enkelt JSON `POST` til porten:
```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"
}
```
Kroppen bærer tre felter:
- **`channel`** — et logisk kanalnavn, du vælger for kilden.
- **`external_id`** — en stabil identifikator for slutbrugeren eller samtalen.
- **`text`** — beskedens indhold.
## Autentificering
Endepunktet er sikret af en **HMAC** båret i **`X-AIHummer-Inbound-Secret`** header, afledt af den delte **`AIHUMMER_INBOUND_SECRET`**. Forespørgsler uden en gyldig signatur afvises, så kun kaldere, der har hemmeligheden, kan indsende beskeder.
> [!NOTE]
> Gatewayen skal have et standardarbejdsområde konfigureret
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) til at afsende generiske indgående meddelelser.
## Yderligere kanaltilslutninger
AiHummer tilbyder yderligere kanalforbindere. Hver installeres fra Marketplace, kører vært-native på sin egen port og videresender indgående beskeder til `/v1/inbound/generic`.
| Forbinder | Havn | Noter |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrix | 8803 | |
| Signal | 8804 | kræver en `signal-cli` sidevogn |
| Microsoft Teams | 8805 | |
| Email (IMAP/SMTP) | 8806 | |
| WhatsApp Cloud API | 8807 | |
> [!NOTE]
> Stikkene installeres fra Marketplace; nogle kræver en ekstra tjeneste
> (for eksempel, `signal-cli` for Signal).
## Browserudvidelsen
AiHummer leverer også en browserudvidelse, en **Manifest V3 sidepanel** chatflade. Det er en **klient af `/v1/chat/completions`** ved hjælp af en personlig `ah-` API-nøgle — **ikke en server-side kanal**. Brug det til personlig chat i browseren fremfor som en indgående kilde til routing.
## Hvor til næste
- For produktionschat, se [Telegram](/da/v1.0/channels/telegram) og
[MAX](/da/v1.0/channels/max).
- For personale IM, se [Bitrix24](/da/v1.0/channels/bitrix24).
- Bygger mod API'en? Se [chat/fuldførelser](/da/v1.0/api/chat-completions).
