Bitrix24-plugin
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.
Fakta
| Felt | Verdi |
|---|---|
| Versjon | 1.0.0 |
| 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.
I tillegg til OAuth-identiteter støttes andre tilordningsveier: automatisk oppretting av agentkontoer via en portaladministrator pålogging (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) og binding til forhåndsopprettede Bitrix24-brukere ved faste ID-er (BITRIX24_AGENT_USER_IDS).
Hvordan det brukes
- Innkommende: en pull-poller henter nye meldinger og videresender dem til gatewayens generiske innkommende endepunkt, hvor ruteren løser opp målagenten.
- Utgående: svar sendes gjennom koblerens idempotente Levere trinn, som konverterer agentens Markdown til Bitrix24 BB-kode og garanterer at en melding ikke sendes to ganger.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24Støttede funksjoner
Pluginen støtter rik, menneskelignende chatteatferd:
- reaksjoner
- rediger og slett melding
- skriveindikatorer
- @-omtaler
- media
Grenser
[!WARNING] Den menneskelignende modellen gjør det med hensikt ikke inkluder noen Bitrix24-bot funksjoner:
- Ingen interaktive tastaturer / knapper og ingen tråder.
- Innkommende medier og tale blir ikke videresendt — innkommende er kun tekst. A kollega-stil identitet mottar og svarer på tekst; vedlegg og stemme notater sendt til agenten blir ikke videreformidlet i en omgang.
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.
- Idempotent levering — Markdown blir gjengitt til BB-kode og sendes aldri to ganger.
- Kun tekst innkommende; ingen tastaturer/tråder.
- Verts-native — kjører under systemd, ikke i en container.