Bitrix24 įskiepis

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

Bitrix24 papildinys jungia jūsų agentą prie Bitrix24 kaip vidinį darbuotojo momentinių žinučių kanalą. Darbuotojai agentui siunčia žinutę tokiu pat būdu, kaip siųstų žinutę kolegai, o agentas atsako Bitrix24 pokalbių lange.

[!WARNING] Bitrix24 čia yra vidinis darbuotojų IM kanalas — kaip Telegram arba Slack skirta personalui. Tai yra ne kliento daugialypis kanalas: nėra Atvirų Linijų, nėra bilietų eilė ir be operatoriaus eskalacijos. Nenaudokite šio papildinio, kad priekintumėte klientų aptarnavimo linija.

Įskiepis veikia tiesiogiai kompiuteryje ir bendrauja su vartais per aihummer.connector.v1 sutartis. Galutinio naudotojo kanalo elgsena yra kanalo puslapyje Bitrix24; šiame puslapyje aptariamas pats papildinys.

Faktai

Laukas	Vertė
Versija	1.0.0
Uostas	8810
Vykdymo laikas	šeimininko-gimtoji

Kas tai yra

Dviejų krypčių tiltas tarp Bitrix24 pokalbių ir AiHummer. Agentas pasirodo kaip žmogaus panaši tapatybė Bitrix24 — kiekvienas agentas autentifikuojasi naudodamas savo OAuth tapatybę, o ne bendrą bot paskyrą — todėl pokalbiai jaučiasi tarsi bendradarbiui kalbantis. Prieiga vykdoma pagal organizacijos skyriaus-medžio ACL, todėl agento pasiekiamumas gerbia jūsų Bitrix24 struktūrą.

Be OAuth tapatybių, palaikomi ir kiti teikimo keliai: automatiškai kuriant agentų paskyras per portalo administratoriaus prisijungimą (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ir susiejimas su iš anksto sukurtais Bitrix24 vartotojais pagal fiksuotus ID (BITRIX24_AGENT_USER_IDS).

Kaip tai naudojama

Įeinantis: traukimo apklausos įrankis paima naujus pranešimus ir perduoda juos į Bendras vartų įeinantis taškas, kur maršrutizatorius nustato tikslinį agentą.
Išeinantis: atsakymai siunčiami per jungties idempotentą Pristatyti žingsnis, kuris konvertuoja agento Markdown į Bitrix24 BB-kodas ir užtikrina, kad žinutė nebūtų išsiųsta du kartus.

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

Palaikomos funkcijos

Šis papildinys palaiko turtingą, žmogaus panašų pokalbio elgesį:

reakcijos
žinutės redagavimas ir šalinimas
rašymo indikatoriai
@-paminėjimai
žiniasklaida

Apribojimai

[!WARNING] Žmogaus panašus modelis tyčia daro ne įtraukti kai kuriuos Bitrix24 botus funkcijos:

Nėra interaktyvių klaviatūrų / mygtukų ir nėra siūlų.

Įeinanti žiniasklaida ir balsas nėra persiunčiami — atvykstantis yra tik tekstas. A kolegos stiliaus tapatybė gauna tekstą ir į jį atsako; prisegtukai ir balsas pastabos, siunčiamos agentui, nėra perduodamos į pokalbį.

Įdiegimas

Įdiekite Bitrix24 vienu spustelėjimu iš rinkos administravimo sąsajoje. Vietinis diegėjas atsisiunčia papildinį, vykdo jo diegimo žingsnį, sukuria izoliuotą systemd vienetą ir laukia sistemos būklės, kol pažymės jį kaip paruoštą — žr. Įdiegimas ir atnaujinimai. Tada sujungiame kiekvieno agento OAuth tapatybę ir susiejame departamento medžio ACL.

Saugumas ir apribojimai

Tik vidiniams darbuotojų IM — ne klientų daugiakanalis.
Tarp-agentinis žmogaus panašus OAuth tapatumas — agentai nėra bendrieji botų paskyros.
Departamentų medžio ACL — gerbia jūsų organizacijos struktūrą.
Idempotentinis pristatymas — Markdown paverčiamas į BB-kodą ir niekada nesiunčiamas du kartus.
Tik tekstinis įeinantis; be klaviatūrų/temų.
Šeimininko vietinis — veikia po systemd, ne konteineryje.