Bitrix24 įskiepis

v1.4.x · atnaujinta 2026-10-14

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.

Toliau aprašytai medijai ir bendram OAuth reikia pasirašyto Core 1.4.15 ir atskirai pasirašyto 1.1.1 jungiklio po paskelbimo kataloge ir atnaujinimo. Įdiegtas 1.1.0 nepatvirtina šių galimybių prieinamumo.

Faktai

Laukas	Vertė
Versija	1.1.1
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ą.

Atskirus portalo naudotojus nustatykite BITRIX24_AGENT_USER_IDS, portalą – BITRIX24_PORTAL. Maršrutizavimas pagal skyrius riboja darbuotojų prieigą; agento paskyra nepakeičia užduoties iniciatoriaus. Pasirinktinai esamas automatinis paruošimas naudoja BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Nurodytose versijose BITRIX24_VAULT_CONNECTIONS parenka esamą, galiojantį, autonominį OAuth prisijungimo duomenį, priklausantį jo savininkui. Naudokite palaikomą savąjį saugyklos/ryšių valdymą; tą patį duomens ID naudokite įrankių susiejimuose. Tikrasis savininkas registruoja veikiantį jungiklį jo darbo srityje per /v1/admin/connections/channel su atskiru connection-token raktu. endpoint ir apiKey pagal agento naudotojo ID įrašykite slaptame BITRIX24_VAULT_CONNECTIONS nustatyme, niekada ne agento profilyje ar užklausose. Tik saugykla atnaujina žetonus; įrankiai tikrina iniciatorių ir bendrinimą. Žr. OAuth2.

Kaip tai naudojama

Įvestis: apklausos procesas skaito pranešimus. Medija atsisiunčiama baitais ir registruojama per /v1/inbound/media; agentas gauna media_id, ne tik URL ar failo metaduomenis.
Išvestis: Deliver konvertuoja Markdown į BB-code ir įkelia tikrus baitus per im.v2.File.upload. Medijos patvirtinimui reikia tikrų FILE_ID ir pranešimų ID; tekstas ar nuoroda nėra failo kvitas.

Atnaujindami išsaugokite patvarų pristatymo žurnalą. Pakartota patvirtinta operacija grąžina ankstesnį kvitą. Daliniai ar nežinomi padariniai automatiškai nesiunčiami dar kartą; prieš kartodami juos patikrinkite.

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

Palaikomos funkcijos

Reakcijos ir @-paminėjimai.
Rašymo indikatorius ir atsakymai, kai paskyra bei teikėjas palaiko im.dialog.writing ir REPLY_ID.
Gaunami vaizdai, garsas, balsas ir failai pagal pirmiau nurodytus versijų reikalavimus.
Pranešimų redagavimas/šalinimas tik senoms integracijoms su atskira boto tapatybe; įprastiems OAuth naudotojams šios galimybės neskelbiamos.

Apribojimai

[!WARNING] Interaktyvios klaviatūros, mygtukai ir gijos nepalaikomi.

Sukurtas ar paruoštas failas nėra patvirtintas pristatymas. Daliniai, nepavykę ir nežinomi rezultatai turi likti matomi.

Į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ą.
Šeimininko vietinis — veikia po systemd, ne konteineryje.