AiHummer
Dansk
Log indKonto
v1.1.x
{ }Swagger

Bitrix24

v1.1.x · opdateret 2026-07-05

Bitrix24 er en intern chatkanal til medarbejdere — den samme rolle Telegram eller Slack spiller for personalet. En AiHummer-agent dukker op i din virksomheds Bitrix24 som en kollega, som medarbejderne kan sende beskeder til og nævne.

Kanalen sender som en stik fra produktet Markedsplads og kører som vært-native. Det konfigureres fra Admin UI, ligesom enhver anden kanal.

[!NOTE] Bitrix24-kanalen kræver en aktiv Starter, Forretning eller Foretagende licens. På Community-planen giver installation af connectoren HTTP 402 “opgradering påkrævet” (kode plan_limit) — se Licensiering.

[!WARNING] Bitrix24 her er strengt en intern medarbejder IM-kanal. Det er ikke kundeomnichannel ikke Bitrix24 Åbne Linjer ikke en billetkø, og ikke en operatøroptrapningsflade. Brug den ikke til at dirigere eksterne kundesamtaler.

En menneskelignende agentidentitet

Hver agent forbinder med sin egen menneskelignende OAuth-identitet, så det vises i Bitrix24 som en særskilt person i stedet for en generisk integrationsbot. Synligheden respekterer din organisationsstruktur gennem en afdelings-træ ACL — en agent ser kun og deltager, hvor dens identitet er tilladt, og følger den samme afdelingstruktur som dine medarbejdere gør.

Udover OAuth-identiteter understøtter connectoren også andre provisioneringsveje: automatisk oprettelse af agentkonti via en portaladministrator-login (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) og binding til forudoprettede Bitrix24-brugere med faste id’er (BITRIX24_AGENT_USER_IDS).

Porte og runtime

Stikket lytter på en enkelt port:

Havn Formål
8810 Connector-service (sundhed, Deliver-endpointet og OAuth-samtykke)

Hvordan beskeder flyder

Bitrix24 sender ikke indgående begivenheder til AiHummer; forbindelsen trækker dem.

  • Indgående — en pull-poller læser nye beskeder og poster dem til gatewayen på /v1/inbound/generic.
  • Udgående — svar leveres gennem aihummer.connector.v1 Levere kontrakt. Agent markdown konverteres til Bitrix24 BB-kode, og levering er idempotent, så et genforsøg aldrig producerer en duplikat besked.

Hvad er understøttet

Kanalen dækker de interaktioner, der passer til en menneskelig-lignende medarbejderidentitet:

  • Reaktioner, besked rediger og slet.
  • Skriver indikatorer.
  • @-omtaler.
  • Medier i udgående beskeder.

[!WARNING] Nogle Telegram-lignende funktioner er med vilje ikke understøttet i menneskelignende model:

  • Ingen interaktive tastaturer eller knapper og ingen tråde.
  • Indgående tekst, medier og stemme videresendes — billeder, lyd, stemme og filer.

Planlæg agentflows omkring tekstbaseret interaktion på denne kanal.

Hvor til næste