Plugin-ul Bitrix24

v1.0.x · actualizat 2026-06-26

Plugin-ul Bitrix24 conectează agentul tău la Bitrix24 ca un canal intern de mesagerie instantanee pentru angajați. Personalul îi trimite mesaje agentului în același mod în care i-ar trimite mesaje unui coleg, iar agentul răspunde în chat-ul Bitrix24.

[!WARNING] Bitrix24 aici este un canal IM intern pentru angajați — ca Telegram sau Slack pentru personal. Nu este omnicanal pentru clienți: nu există Open Lines, nu există coadă de tichete și nu există escaladare către operator. Nu folosi acest plugin pentru a deservi o linie de asistență pentru clienți.

Plugin-ul rulează nativ pe gazdă și comunică cu gateway-ul prin contract. Comportamentul canalului pentru utilizatorul final se află pe pagina canalului Bitrix24; această pagină acoperă plugin-ul în sine.

Fapte

Câmp	Valoare
Versiune	1.0.0
Port	8810
Runtime	nativ pe gazdă

Ce este

O punte bidirecțională între chat-ul Bitrix24 și AiHummer. Agentul apare ca o identitate de tip uman în Bitrix24 — fiecare agent se autentifică cu propria identitate OAuth, în loc de un cont de bot generic — astfel încât conversațiile par o discuție cu un coleg. Accesul urmează ACL-ul pe arborele de departamente al organizației, astfel încât raza de acțiune a unui agent respectă structura ta Bitrix24.

Cum este folosit

Intrare: un poller de tip pull preia mesajele noi și le redirecționează către endpoint-ul de intrare generic al gateway-ului, unde router-ul rezolvă agentul țintă.
Ieșire: răspunsurile sunt trimise prin pasul idempotent Deliver al conectorului, care convertește Markdown-ul agentului în BB-code Bitrix24 și garantează că un mesaj nu este trimis de două ori.

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

Funcții acceptate

Plugin-ul acceptă un comportament de chat bogat, de tip uman:

reacții
editarea și ștergerea mesajelor
indicatori de tastare
@-mențiuni
media

Limite

[!WARNING] Modelul de tip uman nu include în mod intenționat unele funcții de bot Bitrix24:

Fără tastaturi/butoane interactive și fără fire de discuție.

Media și vocea de intrare nu sunt redirecționate — intrarea este doar text. O identitate de tip coleg primește și răspunde la text; atașamentele și notele vocale trimise către agent nu sunt transmise într-o tură.

Instalare

Instalează Bitrix24 cu un singur clic din marketplace în interfața de administrare. Deployer-ul nativ pe gazdă descarcă plugin-ul, execută pasul său de instalare, generează o unitate systemd izolată și așteaptă sănătatea înainte de a-l marca pregătit — consultă Instalare și actualizări. Apoi conectezi identitatea OAuth a fiecărui agent și mapezi ACL-ul pe arborele de departamente.

Securitate și limite

Doar IM intern pentru angajați — nu omnicanal pentru clienți.
Identitate OAuth de tip uman per agent — agenții nu sunt conturi de bot generice.
ACL pe arborele de departamente — raza de acțiune respectă structura organizației tale.
Deliver idempotent — Markdown-ul este redat în BB-code și niciodată trimis de două ori.
Intrare doar text; fără tastaturi/fire de discuție.
Nativ pe gazdă — rulează sub systemd, nu într-un container.