Plugin Bitrix24

Plugin Bitrix24

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

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.

Fapte

Câmp	Valoare
Versiune	1.0.0
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.

Pe lângă identitățile OAuth, sunt acceptate și alte căi de aprovizionare: crearea automată a conturilor de agenți printr-un login de administrator al portalului (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) și legarea la utilizatori Bitrix24 pre-creați prin id-uri fixe (BITRIX24_AGENT_USER_IDS).

Cum este folosit

Intrare: un preluator preia mesaje noi și le redirecționează către punctul de intrare generic al gateway-ului, unde routerul rezolvă agentul țintă.
Ieșire: răspunsurile sunt trimise prin idempotentul conectorului Livra pas, care convertește Markdown-ul agentului în Bitrix24 Cod BB ș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 suportate

Pluginul suportă un comportament de chat bogat, asemănător omului:

reacții
editare și ștergere mesaj
indicatori de tastare
@-mențiuni
media

Limite

[!WARNING] Modelul asemănător omului face intenționat nu includeți un bot Bitrix24 caracteristici:

Fără tastaturi / butoane interactive și niciun fir.

Media și voce inbound nu sunt redirecționate — intrare este doar text. A identitatea de tip coleg primește și răspunde la text; atașamente și voce notițele trimise către agent nu sunt transmise într-un tur.

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.
Livrare idempotentă — Markdown este redat în BB-code și nu este niciodată trimis de două ori.
Doar text; fără tastaturi/firuri.
Gazdă-nativ — rulează sub systemd, nu într-un container.