Yleinen saapuva

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

**Geneerinen sisäänmeno on yleinen sisäänkäyntipiste AiHummeriin.** Kun lähteellesi ei ole tarkoitukseen tehtyä kanavaa — sähköposti-webhook-välitys, cron-tehtävä, sisäinen työkalu — lähetät viestin yhdelle päätepisteelle ja se tulee vuorovaikutuskoneeseen kuten mikä tahansa muu kanavaviesti. ## Päätepiste Lähetä yksi JSON `POST` portille: ```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" } ``` Runko kantaa kolmea kenttää: - **`channel`** — looginen kanavan nimi, jonka valitset lähteelle. - **`external_id`** — vakaa tunniste loppukäyttäjälle tai keskustelulle. - **`text`** — viestin sisältö. ## Todennus Päätepiste on suojattu **HMAC** kantoi sisällä **`X-AIHummer-Inbound-Secret`** otsikko, johdettu jaetusta **`AIHUMMER_INBOUND_SECRET`**. Pyynnöt ilman voimassa olevaa allekirjoitusta hylätään, joten vain ne, joilla on salaisuus, voivat lisätä viestejä. > [!NOTE] > Portaalissa on oltava määritetty oletustyötila > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) lähettää yleisiä saapuvia viestejä. ## Lisäkanavien liittimet AiHummer tarjoaa lisäkanavien liittimiä. Jokainen asennetaan Marketplace-palvelusta, toimii isäntäjärjestelmässä omalla portillaan ja välittää saapuvat viestit `/v1/inbound/generic`. | Liitin | Satama | Muistiinpanot | |---|---|---| | Discord | 8801 | | | Slack | 8802 | | | Matriisi | 8803 | | | Signaali | 8804 | vaatii `signal-cli` sivuvaunu | | Microsoft Teams | 8805 | | | Sähköposti (IMAP/SMTP) | 8806 | | | WhatsApp-pilvi-API | 8807 | | > [!NOTE] > Liittimet asennetaan Marketplacesta; jotkut tarvitsevat lisäpalvelun > (esimerkiksi, `signal-cli` Signalille). ## Selainlaajennus AiHummer lähettää myös selainlaajennuksen, a **Manifesti V3 sivupaneeli** keskustelupinta. Se on a **asiakas, jonka `/v1/chat/completions`** käyttäen henkilökohtaista `ah-` API-avain — **ei palvelinpuolen kanava**Käytä sitä henkilökohtaiseen, selaimessa tapahtuvaan keskusteluun ennemmin kuin saapuvana lähteenä reitityksessä. ## Minne seuraavaksi - Tuotantokeskustelua varten, katso [Telegram](/fi/v1.0/channels/telegram) ja [MAX](/fi/v1.0/channels/max). - Henkilökunnan pikaviesteille, katso [Bitrix24](/fi/v1.0/channels/bitrix24). - Rakennatko API:n päälle? Katso [keskustelu/täydennykset](/fi/v1.0/api/chat-completions).