Generisk innkommende er det universelle inngangspunktet til AiHummer. Når det ikke finnes en kanal spesiallaget for kilden din — en e-post-til-webhook-omkobling, et cron-jobb, et internt verktøy — legger du meldingen til ett endepunkt, og den går inn i turmotoren som en hvilken som helst annen kanalmelding.
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 inneholder tre felt:
channel — et logisk kanalnavn du velger for kilden.
external_id — en stabil identifikator for sluttbrukeren eller samtalen.
text — meldingsinnholdet.
Autentisering
Endepunktet er sikret av en HMAC bært i X-AIHummer-Inbound-Secret overskrift, hentet fra den delte AIHUMMER_INBOUND_SECRET. Forespørsler uten en gyldig signatur blir avvist, så bare kallere som har hemmeligheten kan sende inn meldinger.
[!NOTE]
Gatewayen må ha et standard arbeidsområde konfigurert
(AIHUMMER_DEFAULT_WORKSPACE_ID) for å sende generiske innkommende meldinger.
Ekstra kanaltilkoblinger
AiHummer tilbyr ekstra kanaltilkoblinger. Hver installeres fra Marketplace, kjører vertsnativt på sin egen port, og videresender innkommende meldinger til /v1/inbound/generic.
Kontakter
Havn
Notater
Discord
8801
Slack
8802
Matrise
8803
Signal
8804
krever en signal-cli sidevogn
Microsoft Teams
8805
E-post (IMAP/SMTP)
8806
WhatsApp Cloud API
8807
[!NOTE]
Koblingene installeres fra Marketplace; noen trenger en ekstra tjeneste
(for eksempel, signal-cli for Signal).
Nettleserutvidelsen
AiHummer leverer også en nettleserutvidelse, en Manifest V3 sidepanel chat-overflate. Det er en klient av /v1/chat/completions ved å bruke en personlig ah- API-nøkkel — ikke en server-side-kanalBruk det til personlig chat i nettleseren i stedet for som en innkommende kilde for ruting.
**Generisk innkommende er det universelle inngangspunktet til AiHummer.** Når det ikke finnes en kanal spesiallaget for kilden din — en e-post-til-webhook-omkobling, et cron-jobb, et internt verktøy — legger du meldingen til ett endepunkt, og den går inn i turmotoren som en hvilken som helst annen kanalmelding.
## 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 inneholder tre felt:
- **`channel`** — et logisk kanalnavn du velger for kilden.
- **`external_id`** — en stabil identifikator for sluttbrukeren eller samtalen.
- **`text`** — meldingsinnholdet.
## Autentisering
Endepunktet er sikret av en **HMAC** bært i **`X-AIHummer-Inbound-Secret`** overskrift, hentet fra den delte **`AIHUMMER_INBOUND_SECRET`**. Forespørsler uten en gyldig signatur blir avvist, så bare kallere som har hemmeligheten kan sende inn meldinger.
> [!NOTE]
> Gatewayen må ha et standard arbeidsområde konfigurert
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) for å sende generiske innkommende meldinger.
## Ekstra kanaltilkoblinger
AiHummer tilbyr ekstra kanaltilkoblinger. Hver installeres fra Marketplace, kjører vertsnativt på sin egen port, og videresender innkommende meldinger til `/v1/inbound/generic`.
| Kontakter | Havn | Notater |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrise | 8803 | |
| Signal | 8804 | krever en `signal-cli` sidevogn |
| Microsoft Teams | 8805 | |
| E-post (IMAP/SMTP) | 8806 | |
| WhatsApp Cloud API | 8807 | |
> [!NOTE]
> Koblingene installeres fra Marketplace; noen trenger en ekstra tjeneste
> (for eksempel, `signal-cli` for Signal).
## Nettleserutvidelsen
AiHummer leverer også en nettleserutvidelse, en **Manifest V3 sidepanel** chat-overflate. Det er en **klient av `/v1/chat/completions`** ved å bruke en personlig `ah-` API-nøkkel — **ikke en server-side-kanal**Bruk det til personlig chat i nettleseren i stedet for som en innkommende kilde for ruting.
## Hvor til neste
- For produksjonschat, se [Telegram](/no/v1.0/channels/telegram) og
[MAKS](/no/v1.0/channels/max).
- For personalets IM, se [Bitrix24](/no/v1.0/channels/bitrix24).
- Bygger mot API-et? Se [chat/fullføringer](/no/v1.0/api/chat-completions).
