Generisk innkommende

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"
}

**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).