Plugin Bitrix24

Plugin Bitrix24

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

Pluginul Bitrix24 conectează agentul dumneavoastră la Bitrix24 ca un canal intern de mesagerie instant a angajaților. Personalul îi trimite mesaj agentului în același mod în care ar trimite mesaj unui coleg, iar agentul răspunde în chatul Bitrix24.

[!WARNING] Bitrix24 aici este un canal IM intern pentru angajați — precum Telegram sau Slack pentru personal. Este nu client omnicanal: nu există Linii Deschise, nu coadă de tichete și fără escaladare către operator. Nu utilizați acest plugin pentru a prelua linia de asistență pentru clienți.

Pluginul rulează nativ pe gazdă și comunică cu gateway-ul prin aihummer.connector.v1 contract. Comportamentul canalului utilizatorului final se află pe pagina canalului Bitrix24; această pagină acoperă pluginul în sine.

Comportamentul media și OAuth comun de mai jos necesită Core 1.4.15 semnat și conectorul 1.1.1 semnat separat, după publicarea în catalog și actualizare. Un conector 1.1.0 instalat nu confirmă disponibilitatea acestor funcții.

Fapte

Câmp	Valoare
Versiune	1.1.1
Port	8810
Timp de rulare	gazdă-nativ

Ce este

Un pod bidirecțional între chat-ul Bitrix24 și AiHummer. Agentul apare ca un identitate asemănătoare oamenilor în Bitrix24 — fiecare agent se autentifică cu propria identitate OAuth în loc de un cont generic de bot — astfel conversațiile par că vorbești cu un coleg. Accesul urmează organizația ACL arbore-departament, astfel încât raza de acțiune a unui agent respectă structura dvs. Bitrix24.

Configurați utilizatori dedicați ai portalului în BITRIX24_AGENT_USER_IDS și portalul în BITRIX24_PORTAL. Rutarea pe departamente limitează accesul angajaților; contul agentului nu înlocuiește inițiatorul sarcinii. Pregătirea automată existentă, opțională, folosește BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

În versiunile indicate, BITRIX24_VAULT_CONNECTIONS selectează o acreditare OAuth existentă, valabilă, autonomă, deținută de proprietarul ei. Folosiți gestionarea nativă acceptată a seifului/conexiunilor; reutilizați ID-ul acreditării în legăturile instrumentelor. Proprietarul real înregistrează conectorul activ în spațiul său de lucru la /v1/admin/connections/channel cu o cheie dedicată connection-token. Setați endpoint și apiKey după ID-ul utilizatorului agent în setarea secretă BITRIX24_VAULT_CONNECTIONS; nu le puneți în profiluri sau solicitări către agent. Numai seiful reînnoiește tokenurile; instrumentele verifică inițiatorul și partajarea. Consultați OAuth2.

Cum este folosit

Intrare: interogatorul citește mesajele. Media este descărcată ca octeți și înregistrată prin /v1/inbound/media; agentul primește media_id, nu doar un URL sau metadate.
Ieșire: Deliver convertește Markdown în BB-code și încarcă octeți reali prin im.v2.File.upload. Confirmarea media necesită FILE_ID și ID-uri de mesaje reale; textul sau linkul nu reprezintă o confirmare a fișierului.

Păstrați jurnalul durabil de livrare la actualizări. Repetarea unei operații confirmate returnează confirmarea anterioară. Efectele parțiale sau necunoscute nu sunt retrimise automat; verificați-le înainte de reîncercare.

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

Funcții suportate

Reacții și @-mențiuni.
Indicator de scriere și răspunsuri când contul și furnizorul acceptă im.dialog.writing și REPLY_ID.
Imagini, audio, voce și fișiere primite, cu cerințele de versiune de mai sus.
Editarea/ștergerea mesajelor numai pentru integrări vechi cu o identitate separată de bot; nu sunt declarate pentru utilizatori OAuth obișnuiți.

Limite

[!WARNING] Tastaturile interactive, butoanele și firele de discuție nu sunt acceptate.

Un fișier generat sau pregătit nu confirmă livrarea. Rezultatele parțiale, eșuate și necunoscute trebuie să rămână vizibile.

Instalare

Instalați Bitrix24 cu un singur clic din marketplace în interfața de administrare. Deployer-ul nativ al gazdei descarcă pluginul, rulează pasul său de instalare, redă o unitate systemd izolată și așteaptă să fie sănătos înainte de a-l marca ca pregătit — vezi Instalare și actualizări. Apoi conectați identitatea OAuth a fiecărui agent și mapați ACL-ul arborelui departamentului.

Securitate și limite

Doar IM pentru angajații interni — nu omnicanal pentru clienți.
Identitate OAuth asemănătoare cu cea umană pe agent — agenții nu sunt conturi bot generice.
ACL arbore-departament — respectă structura organizațională a organizației tale.
Gazdă-nativ — rulează sub systemd, nu într-un container.