Bitrix24-plugin

v1.0.x · oppdatert 2026-10-14

Bitrix24-pluginen kobler agenten din til Bitrix24 som en intern ansatt instant-meldingskanal. Ansatte sender meldinger til agenten på samme måte som de ville gjort til en kollega, og agenten svarer inne i Bitrix24s chat.

[!WARNING] Bitrix24 her er en intern ansatt IM-kanal — som Telegram eller Slack for ansatte. Det er ikke kunde omnichannel: det er ingen åpne linjer, nei billettkø og ingen opptrapping til operatør. Ikke bruk denne pluginen for å fronte en kundestøttelinje

Pluginet kjører på verten og kommuniserer med gatewayen over aihummer.connector.v1 kontrakt. Sluttbrukerkanalens oppførsel er på kanalens side Bitrix24; denne siden dekker selve pluginen.

Medier og felles OAuth nedenfor krever signert Core 1.4.15 og den separat signerte koblingen 1.1.1 etter katalogpublisering og oppdatering. En installert 1.1.0 bekrefter ikke at disse funksjonene er tilgjengelige.

Fakta

Felt	Verdi
Versjon	1.1.1
Havn	8810
Kjøretid	verts-native

Hva det er

En toveis bro mellom Bitrix24-chat og AiHummer. Agenten vises som en menneskelignende identitet i Bitrix24 — hver agent autentiserer seg med sin egen OAuth-identitet i stedet for en generisk botkonto — slik at samtaler føles som å snakke med en kollega. Tilgang følger organisasjonens avdelings-tre ACL, slik at en agents rekkevidde respekterer Bitrix24-strukturen din.

Angi egne portalbrukere i BITRIX24_AGENT_USER_IDS og portalen i BITRIX24_PORTAL. Avdelingsruting begrenser ansattes tilgang; agentkontoen erstatter ikke personen som starter oppgaven. Valgfri eksisterende automatisk klargjøring bruker BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Med angitte versjoner velger BITRIX24_VAULT_CONNECTIONS en eksisterende, gyldig, autonom OAuth-legitimasjon som tilhører eieren. Bruk støttet native hvelv-/tilkoblingsadministrasjon; gjenbruk legitimasjonens ID i verktøybindinger. Den faktiske eieren registrerer den kjørende koblingen i arbeidsområdet via /v1/admin/connections/channel med en egen connection-token-nøkkel. Angi endpoint og apiKey per agentbruker-ID i den hemmelige innstillingen BITRIX24_VAULT_CONNECTIONS, aldri i agentprofiler eller instrukser. Bare hvelvet fornyer tokener; verktøyene sjekker aktør og deling. Se OAuth2.

Hvordan det brukes

Innkommende: polleren leser meldinger. Medier lastes ned som byte og registreres via /v1/inbound/media; agenten får media_id, ikke bare en URL eller filmetadata.
Utgående: Deliver konverterer Markdown til BB-code og laster opp faktiske byte via im.v2.File.upload. Mediebekreftelse krever ekte FILE_ID og meldings-ID-er; tekst eller lenke er ingen filkvittering.

Behold den varige leveringsjournalen ved oppdateringer. En gjentatt bekreftet operasjon returnerer den tidligere kvitteringen. Delvise eller ukjente virkninger sendes ikke automatisk på nytt; sjekk dem før et nytt forsøk.

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

Støttede funksjoner

Reaksjoner og @-omtaler.
Skriveindikator og svar når kontoen og leverandøren støtter im.dialog.writing og REPLY_ID.
Innkommende bilder, lyd, tale og filer med versjonskravene ovenfor.
Redigering/sletting av meldinger bare for eldre integrasjoner med en egen botidentitet; dette annonseres ikke for vanlige OAuth-brukere.

Grenser

[!WARNING] Interaktive tastaturer, knapper og tråder støttes ikke.

En generert eller klargjort fil bekrefter ikke levering. Delvise, mislykkede og ukjente resultater må forbli synlige.

Installasjon

Installer Bitrix24 med ett klikk fra markedet i admin-grensesnittet. Den vertsnative distribusjonsverktøyet laster ned pluginen, kjører installasjonssteget, gjengir en sandboxet systemd-enhet og venter på helsetilstand før den markerer den som klar — se Installer og oppdateringer. Du kobler deretter hver agents OAuth-identitet og kartlegger avdelings-treets ACL.

Sikkerhet og grenser

Kun intern ansatt IM — ikke kundeomnikanal.
Per-agent menneskelig-lignende OAuth-identitet — agenter er ikke generiske botkontoer.
Avdelings-tre ACL — reach respekterer organisasjonsstrukturen din.
Verts-native — kjører under systemd, ikke i en container.