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

Bitrix24-plugin

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

Bitrix24-plugin’et forbinder din agent til Bitrix24 som en intern medarbejder instant messaging-kanal. Personalet sender besked til agenten på samme måde, som de ville sende besked til en kollega, og agenten svarer inde i Bitrix24’s chat.

[!WARNING] Bitrix24 her er en intern medarbejder IM-kanal — som Telegram eller Slack for personalet. Det er ikke kunde omnichannel: der er ingen åbne linjer, nej billetkø og ingen operatøroptrapning. Brug ikke dette plugin til at fronte en kundeservicetelefon

Pluginet kører på værtens native system og kommunikerer med gatewayen over aihummer.connector.v1 kontrakt. Slutbrugerens kanaladfærd er på kanalsiden Bitrix24; denne side dækker selve plugin’et.

Fakta

Mark Værdi
Version 1.0.0
Havn 8810
Kørselstid værts-native

Hvad det er

En tovejs bro mellem Bitrix24-chat og AiHummer. Agenten vises som en menneskelignende identitet i Bitrix24 — hver agent autentificerer sig med sin egen OAuth-identitet i stedet for en generisk botkonto — så samtaler føles som at tale med en kollega. Adgang følger organisationens afdelings-træ ACL, så en agents rækkevidde respekterer din Bitrix24-struktur.

Udover OAuth-identiteter understøttes andre provisionsveje: automatisk oprettelse af agentkonti via en portaladministrator-login (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) og binding til forudoprettede Bitrix24-brugere efter faste id’er (BITRIX24_AGENT_USER_IDS).

Hvordan det bruges

  • Indkommende: en pull-poller henter nye beskeder og videresender dem til gatewayens generiske indgående endepunkt, hvor routeren løser det målrettede agent.
  • Udgående: svar sendes gennem connectorens idempotente Levere trin, som konverterer agentens Markdown til Bitrix24 BB-kode og garanterer, at en besked ikke sendes to gange.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Understøttede funktioner

Plugin’et understøtter rig, menneskelig-lignende chatadfærd:

  • reaktioner
  • rediger og slet besked
  • skriveindikatorer
  • @-omtaler
  • medier

Grænser

[!WARNING] Den menneskelignende model gør det med vilje ikke inkluder nogle Bitrix24-bots funktioner:

  • Ingen interaktive tastaturer / knapper og ingen tråde.
  • Indgående medier og tale videresendes ikke — indkommende er kun tekst. A kollega-stil identitet modtager og reagerer på tekst; vedhæftede filer og stemme noter sendt til agenten videresendes ikke til en tur.

Installation

Installer Bitrix24 med ét klik fra markedspladsen i admin-brugergrænsefladen. Den host-native deployer downloader plugin’et, kører dets installationsskridt, genererer en sandboxed systemd-enhed og venter på sundhed, før den markerer det som klar — se Installation og opdateringer. Du forbinder derefter hver agents OAuth-identitet og kortlægger afdelingstræets ACL.

Sikkerhed og grænser

  • Intern medarbejder IM kun — ikke kundeomnichannel.
  • Pr-agent menneskelig-lignende OAuth-identitet — agenter er ikke generiske botkonti.
  • Afdelings-træ ACL — reach respekterer din organisationsstruktur.
  • Idempotent levering — Markdown gengives til BB-kode og sendes aldrig to gange.
  • Kun tekst indgående; ingen tastaturer/tråde.
  • Værts-native — kører under systemd, ikke i en container.

Hvor til næste