Плагін Bitrix24

Плагін Bitrix24

v1.0.x · абноўлена 2026-06-26

Плагін Bitrix24 падключае вашага агента да Bitrix24 як унутраны імгненны абмен паведамленнямі для супрацоўнікаў. Супрацоўнікі пішуць агенту гэтак жа, як яны пісалі б калегу, і агент адказвае ўнутры чата Bitrix24.

[!WARNING] Bitrix24 тут — гэта унутраны IM-канал для супрацоўнікаў — як Telegram або Slack для персаналу. Гэта не кліенцкі амніканал: тут няма Open Lines, няма чаргі тыкетаў і няма эскалацыі на аператара. Не выкарыстоўвайце гэты плагін як фронт для лініі падтрымкі кліентаў.

Плагін працуе host-native і размаўляе са шлюзам праз кантракт . Паводзіны канала для канчатковага карыстальніка апісаны на старонцы канала Bitrix24; гэтая старонка ахоплівае сам плагін.

Факты

Field	Value
Версія	1.0.0
Порт	8810
Асяроддзе выканання	host-native

Што гэта

Двухбаковы мост паміж чатам Bitrix24 і AiHummer. Агент з’яўляецца як чалавекападобная ідэнтычнасць у Bitrix24 — кожны агент аўтэнтыфікуецца ўласнай OAuth-ідэнтычнасцю замест агульнага бот-акаўнта — таму размовы адчуваюцца як размова з калегам. Доступ кіруецца ACL па дрэве аддзелаў арганізацыі, таму ахоп агента паважае структуру вашага Bitrix24.

Як гэта выкарыстоўваецца

Уваходныя: pull-полер падхоплівае новыя паведамленні і перанакіроўвае іх на агульны ўваходны эндпойнт шлюза, дзе маршрутызатар вызначае мэтавага агента.
Выходныя: адказы адпраўляюцца праз ідэмпатэнтны крок Deliver канектара, які канвертуе Markdown агента ў BB-code Bitrix24 і гарантуе, што паведамленне не будзе адпраўлена двойчы.

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

Падтрымліваныя магчымасці

Плагін падтрымлівае багатыя, чалавекападобныя паводзіны ў чаце:

рэакцыі
рэдагаванне і выдаленне паведамленняў
індыкатары набору тэксту
@-згадванні
медыя

Абмежаванні

[!WARNING] Чалавекападобная мадэль наўмысна не ўключае некаторыя бот-функцыі Bitrix24:

Няма інтэрактыўных клавіятур / кнопак і няма threads.

Уваходныя медыя і голас не перанакіроўваюцца — уваходныя толькі тэкставыя. Ідэнтычнасць у стылі калегі прымае і адказвае на тэкст; укладанні і галасавыя нататкі, адпраўленыя агенту, не транслююцца ў ход размовы.

Усталяванне

Усталюйце Bitrix24 у адзін клік з маркетплэйса ў адмін-інтэрфейсе. Host-native дэплоер спампоўвае плагін, выконвае яго крок усталявання, рэндэрыць ізаляваны systemd-юніт і чакае стану здароўя, перш чым пазначыць яго гатовым — гл. Усталяванне і абнаўленні. Затым вы падключаеце OAuth-ідэнтычнасць кожнага агента і супастаўляеце ACL па дрэве аддзелаў.

Бяспека і абмежаванні

Толькі ўнутраны IM для супрацоўнікаў — не кліенцкі амніканал.
Чалавекападобная OAuth-ідэнтычнасць на кожнага агента — агенты не з’яўляюцца агульнымі бот-акаўнтамі.
ACL па дрэве аддзелаў — ахоп паважае структуру вашай арганізацыі.
Ідэмпатэнтны Deliver — Markdown рэндэрыцца ў BB-code і ніколі не адпраўляецца двойчы.
Толькі тэкставыя ўваходныя; няма клавіятур/threads.
Host-native — працуе пад systemd, а не ў кантэйнеры.