Bitrix24 är en intern medarbetar-kanal för snabbmeddelanden — samma roll som Telegram eller Slack spelar för personal. En AiHummer-agent dyker upp i ditt företags Bitrix24 som en kollega som anställda kan skicka meddelanden till och nämna.
Kanalen skickas som en kontakt från produkten Marknad och körs värd-native. Det konfigureras från Admin UI, precis som någon annan kanal.
[!NOTE]
Bitrix24-kanalen kräver en aktiv Startmotor, Affärer eller
Företag licens. På Community-planen ger installation av anslutningen tillbaka
HTTP 402 “uppgradering krävs” (kod plan_limit) — se
Licensiering.
[!WARNING]
Bitrix24 här är strikt en intern medarbetar-IM-kanal. Det är inte
kundomnikanal inte Bitrix24 Öppna linjer, inte en biljettkö, och
inte en operatörs-eskaleringsyta. Använd den inte för att dirigera extern
kundsamtal.
En människoliknande agentidentitet
Varje agent ansluter med sin egen mänsklig-liknande OAuth-identitet, så att det visas i Bitrix24 som en separat person istället för en generisk integrationsbot. Synligheten respekterar din organisationsstruktur genom en avdelningsträd ACL — en agent ser och deltar endast där dess identitet är tillåten, följande samma avdelningshierarki som dina anställda gör.
Förutom OAuth-identiteter stöder anslutningen även andra tillhandahållningsvägar: automatisk tilldelning av agentkonton via en portaladministratörs inloggning (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) och bindning till förskapade Bitrix24-användare med fasta id:n (BITRIX24_AGENT_USER_IDS).
Portar och runtime
Anslutningen lyssnar på en enda port:
Port
Syfte
8810
Kopplingstjänst (hälsa, Deliver-slutpunkt och OAuth-samtycke)
Hur meddelanden flödar
Bitrix24 skickar inte inkommande händelser till AiHummer; kopplingen drar dem.
Inbound — en pull-poller läser nya meddelanden och postar dem till gatewayen vid
/v1/inbound/generic.
Utgående — svaren levereras via aihummer.connector.v1Leverera kontrakt. Agent markdown konverteras till Bitrix24 BB-kod, och
leverans är idempotent, så ett nytt försök att skicka aldrig producerar en kopia
meddelande.
Vad stöds
Kanalen täcker de interaktioner som passar en mänsklig-liknande medarbetaridentitet:
Reaktioner, meddelande redigera och ta bort.
Skriver indikatorer.
@-omnämnanden.
Media i utgående meddelanden.
[!WARNING]
Vissa Telegram-liknande funktioner är avsiktligt inte stöds i
mänsklig-liknande modell:
Inga interaktiva tangentbord eller knappar och inga trådar.
Inkommande text, media och röst vidarebefordras — bilder, ljud, röst och filer.
Planera agentflöden kring textbaserad interaktion på den här kanalen.
**Bitrix24 är en intern medarbetar-kanal för snabbmeddelanden** — samma roll som Telegram eller Slack spelar för personal. En AiHummer-agent dyker upp i ditt företags Bitrix24 som en kollega som anställda kan skicka meddelanden till och nämna.
Kanalen skickas som en **kontakt från produkten [Marknad](/sv/v1.0/marketplace/overview-tiers)** och körs värd-native. Det konfigureras från Admin UI, precis som någon annan kanal.
> [!NOTE]
> Bitrix24-kanalen kräver en aktiv **Startmotor**, **Affärer** eller
> **Företag** licens. På Community-planen ger installation av anslutningen tillbaka
> **HTTP 402 "uppgradering krävs"** (kod `plan_limit`) — se
> [Licensiering](/sv/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 här är strikt en **intern medarbetar-IM-kanal**. Det är **inte**
> kundomnikanal **inte** Bitrix24 Öppna linjer, **inte** en biljettkö, och
> **inte** en operatörs-eskaleringsyta. Använd den inte för att dirigera extern
> kundsamtal.
## En människoliknande agentidentitet
Varje agent ansluter med sin egen **mänsklig-liknande OAuth-identitet**, så att det visas i Bitrix24 som en separat person istället för en generisk integrationsbot. Synligheten respekterar din organisationsstruktur genom en **avdelningsträd ACL** — en agent ser och deltar endast där dess identitet är tillåten, följande samma avdelningshierarki som dina anställda gör.
Förutom OAuth-identiteter stöder anslutningen även andra tillhandahållningsvägar: **automatisk tilldelning av agentkonton via en portaladministratörs inloggning** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) och bindning till **förskapade Bitrix24-användare med fasta id:n** (`BITRIX24_AGENT_USER_IDS`).
## Portar och runtime
Anslutningen lyssnar på en enda port:
| Port | Syfte |
|---|---|
| 8810 | Kopplingstjänst (hälsa, Deliver-slutpunkt och OAuth-samtycke) |
## Hur meddelanden flödar
Bitrix24 skickar inte inkommande händelser till AiHummer; kopplingen **drar** dem.
- **Inbound** — en pull-poller läser nya meddelanden och postar dem till gatewayen vid
`/v1/inbound/generic`.
- **Utgående** — svaren levereras via `aihummer.connector.v1`
**Leverera** kontrakt. Agent **markdown konverteras till Bitrix24 BB-kod**, och
leverans är **idempotent**, så ett nytt försök att skicka aldrig producerar en kopia
meddelande.
## Vad stöds
Kanalen täcker de interaktioner som passar en mänsklig-liknande medarbetaridentitet:
- Reaktioner, meddelande **redigera** och **ta bort**.
- **Skriver** indikatorer.
- **@-omnämnanden**.
- **Media** i utgående meddelanden.
> [!WARNING]
> Vissa Telegram-liknande funktioner är avsiktligt **inte** stöds i
> mänsklig-liknande modell:
>
> - **Inga interaktiva tangentbord eller knappar** och **inga trådar**.
> - **Inkommande text, media och röst vidarebefordras** — bilder, ljud, röst och filer.
>
> Planera agentflöden kring textbaserad interaktion på den här kanalen.
## Vart härnäst
- Om installation av kontakter: [Marknad](/sv/v1.0/marketplace/overview-tiers).
- För interaktiva tangentbord och omröstningar, använd [Telegram](/sv/v1.0/channels/telegram)
eller [MAX](/sv/v1.0/channels/max).
- Se det underliggande ingestations-API:et i
[Generisk inkommande](/sv/v1.0/channels/generic-inbound).
