Bitrix24 pistikprogramm

v1.0.x · uuendatud 2026-07-05

Bitrix24 pistikprogramm ühendab teie agendi Bitrix24-ga sisemise töötaja kiirsuhtluskanalina. Töötajad saadavad agendile sõnumi samamoodi, nagu nad saadaksid sõnumi kolleegile, ja agent vastab Bitrix24 vestluses.

[!WARNING] Bitrix24 siin on sisemine töötajate IM-kanal — nagu Telegram või Slack töötajatele. See on ei kliendi mitmekanaliline: avatud liine ei ole, ei ole piletijärjekord ja operaatori eskaleerimist ei toimu. Ära kasuta seda pistikprogrammi ettepoole suunamiseks klienditoe liin.

Pistikprogramm jookseb hosti natiivina ja suhtleb väravaga üle aihummer.connector.v1 leping. Lõppkasutaja kanali käitumine on kanali lehel Bitrix24; see leht käsitleb ise pluginat.

Faktid

Väli	Väärtus
Versioon	1.0.0
Sadam	8810
Käivitusajal	peremees-ja kohaliku

Mis see on

Kahepoolne sild Bitrix24 vestluse ja AiHummeri vahel. Agent ilmub kui inimese-laadne identiteet Bitrix24-s — iga agent autentib ennast oma OAuth-identiteediga, mitte üldise boti kontoga — seega tundub vestlus nagu rääkimine kolleegiga. Juurdepääs järgib organisatsiooni osakond-puu ACL, nii et agendi ulatus austab teie Bitrix24 struktuuri.

Pärast OAuth-identiteete toetatakse ka muid provisjonimise teid: agentide kontode automaatselt loomine portaali administraatori sisselogimise kaudu (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ja seostamine eelnevalt loodud Bitrix24 kasutajatega kindlate id-de alusel (BITRIX24_AGENT_USER_IDS).

Kuidas seda kasutatakse

Sissetulev: tõmbav küsitlusvigur võtab uusi sõnumeid üles ja edastab need värava üldine sissetulev lõpp-punkt, kus ruuter määrab sihtagendi.
Väljaminev: vastused saadetakse läbi ühendaja idempotentse Tarnima samm, mis konverteerib agendi Markdowni Bitrix24-ks BB-kood ja tagab, et sõnumit ei saadeta kaks korda.

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

Toetatud funktsioonid

Plugin toetab rikkalikku, inimliku sarnase vestluskäitumist:

reaktsioonid
sõnumi redigeerimine ja kustutamine
tippimise indikaatorid
@-mainimised
meedia

Piirid

[!WARNING] Inimesele sarnane mudel teeb seda teadlikult ei lisada mõned Bitrix24 botid omadused:

Puuduvad interaktiivsed klaviatuurid / nupud ja pole lõime.

Sissetulevat meediat ja häält ei edastata — saabuv on ainult tekst. A kolleegi-tüüpi identiteet võtab tekstisõnumeid vastu ja reageerib neile; manusfailid ja hääl agenti saadetud märkmeid ei edastata vestlusse.

Paigaldus

Paigalda Bitrix24 turuletilt ühe klikiga administraatori liidesest. Host-omane juurutaja laadib pistikprogrammi alla, käivitab selle paigaldamise sammu, kuvab liivakastitud systemd üksuse ja ootab tervist, enne kui märgib selle valmis olevaks — vaata Paigalda ja uuendused. Seejärel ühendate iga esindaja OAuth-identiteedi ja kaardistate osakonnapuu ACL-i.

Turvalisus ja piirid

Ainult siseinimeste IM — mitte kliendi mitmekanali
Agendi kohta inimese sarnane OAuth-identiteet — agendid ei ole üldised boti kontod.
Osakond-puu ACL — reach austab teie organisatsiooni struktuuri.
Idempotentne kohaletoimetamine — Markdown renderdatakse BB-koodiks ja seda ei saadeta kunagi kaks korda.
Ainult tekstiga saabuv; klaviatuurid/ketid puuduvad.
Host-mahine — töötab systemdi all, mitte konteineris.