Bitrix24-plugin

v1.2.x · opdateret 2026-10-14

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.

Medierne og fælles OAuth nedenfor kræver signeret Core 1.4.15 og den separat signerede connector 1.1.1 efter katalogoffentliggørelse og opdatering. En installeret 1.1.0 bekræfter ikke disse funktioners tilgængelighed.

Fakta

Mark	Værdi
Version	1.1.1
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.

Angiv særskilte portalbrugere i BITRIX24_AGENT_USER_IDS og portalen i BITRIX24_PORTAL. Afdelingsrouting begrænser medarbejderadgang; agentkontoen erstatter ikke opgavens initiativtager. Valgfri eksisterende automatisk klargøring bruger BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Med de angivne versioner vælger BITRIX24_VAULT_CONNECTIONS en eksisterende, gyldig, autonom OAuth-legitimationsoplysning, som tilhører ejeren. Brug understøttet native boks-/forbindelsesadministration; genbrug oplysningens ID i værktøjsbindinger. Den faktiske ejer registrerer den kørende connector i dens arbejdsområde via /v1/admin/connections/channel med en særskilt connection-token-nøgle. Angiv endpoint og apiKey pr. agentbruger-ID i den hemmelige indstilling BITRIX24_VAULT_CONNECTIONS, aldrig i agentprofiler eller instruktioner. Kun boksen fornyer tokens; værktøjerne kontrollerer aktør og deling. Se OAuth2.

Hvordan det bruges

Indgående: polleren læser beskeder. Medier downloades som bytes og registreres via /v1/inbound/media; agenten får media_id, ikke blot en URL eller filmetadata.
Udgående: Deliver konverterer Markdown til BB-code og uploader faktiske bytes via im.v2.File.upload. Mediebekræftelse kræver rigtige FILE_ID og besked-ID’er; tekst eller link er ingen filkvittering.

Bevar den varige leveringsjournal ved opdateringer. En gentaget bekræftet operation returnerer den tidligere kvittering. Delvise eller ukendte virkninger genafsendes ikke automatisk; kontroller dem før et nyt forsøg.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Understøttede funktioner

Reaktioner og @-omtaler.
Skriveindikator og svar, når kontoen og udbyderen understøtter im.dialog.writing og REPLY_ID.
Indgående billeder, lyd, tale og filer med versionskravene ovenfor.
Redigering/sletning af beskeder kun for ældre integrationer med særskilt botidentitet; de annonceres ikke for almindelige OAuth-brugere.

Grænser

[!WARNING] Interaktive tastaturer, knapper og tråde understøttes ikke.

En genereret eller klargjort fil bekræfter ikke levering. Delvise, mislykkede og ukendte resultater skal forblive synlige.

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.
Værts-native — kører under systemd, ikke i en container.