Generisk inkommande

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 inkommande är den universella ingångspunken till AiHummer.** När det inte finns någon specialbyggd kanal för din källa — en e-post-till-webhook-omkopplare, ett cron-jobb, ett internt verktyg — skickar du meddelandet till en slutpunkt och det går in i turmotorn som vilket annat kanalmeddelande som helst. ## Slutpunkten Skicka en enda JSON `POST` till 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 innehåller tre fält: - **`channel`** — ett logiskt kanalnamn som du väljer för källan. - **`external_id`** — en stabil identifierare för slutanvändaren eller konversationen. - **`text`** — meddelandets innehåll. ## Autentisering Slutpunkten är säkrad av en **HMAC** buren i **`X-AIHummer-Inbound-Secret`** huvud, härledd från den delade **`AIHUMMER_INBOUND_SECRET`**. Begäranden utan en giltig signatur avvisas, så endast de som har hemligheten kan injicera meddelanden. > [!NOTE] > Gatewayen måste ha ett standardarbetsområde konfigurerat > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) för att skicka generiska inkommande meddelanden. ## Ytterligare kanalanslutningar AiHummer erbjuder ytterligare kanalanslutningar. Varje installeras från Marketplace, körs nativt på värddatorn på sin egen port och vidarebefordrar inkommande meddelanden till `/v1/inbound/generic`. | Kontaktor | Port | Anteckningar | |---|---|---| | Discord | 8801 | | | Slack | 8802 | | | Matris | 8803 | | | Signal | 8804 | kräver en `signal-cli` sidvagn | | Microsoft Teams | 8805 | | | E-post (IMAP/SMTP) | 8806 | | | WhatsApp Cloud API | 8807 | | > [!NOTE] > Kontakterna installeras från Marketplace; vissa behöver en extra tjänst > (till exempel, `signal-cli` för Signal). ## Webbläsartillägget AiHummer skickar också med en webbläsartillägg, en **Manifest V3 sidopanel** chatyta. Det är en **kund hos `/v1/chat/completions`** använder en personlig `ah-` API-nyckel — **inte en server-sida kanal**Använd det för personlig chatt i webbläsaren snarare än som en inkommande källa för vidarebefordring. ## Vart härnäst - För produktionschatt, se [Telegram](/sv/v1.0/channels/telegram) och [MAX](/sv/v1.0/channels/max). - För personal IM, se [Bitrix24](/sv/v1.0/channels/bitrix24). - Bygger mot API:et? Se [chatt/kompletteringar](/sv/v1.0/api/chat-completions).