Плагін Bitrix24

Плагін Bitrix24

v1.1.x · абноўлена 2026-07-05

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

[!WARNING] Bitrix24 тут з’яўляецца унутраны канал імгненных паведамленняў для супрацоўнікаў — як Telegram або Slack для персаналу. Гэта не кліентская шматканальная сувязь: няма адкрытых ліній, няма чарга квіткоў і адсутнасць эскалацыі аператара. Не выкарыстоўвайце гэты плагін для працы з лінія падтрымкі кліентаў

Плагін працуе непасрэдна на хосте і камунікуе з шлюзам праз aihummer.connector.v1 кантракт. Паводзіны канала канцавага карыстальніка знаходзяцца на старонцы канала Бітрыкс24Гэтая старонка прысвечана самаму плагіну.

Факты

Поле	Кошт
Версія	1.0.0
Порт	8810
Час выканання	хазяін-гаспадар

Што гэта

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

Акрамя OAuth-ідэнтыфікатараў, падтрымліваюцца і іншыя шляхі прадастаўлення: аўтаматычнае стварэнне акаўнтаў агента праз увайсці адміністратара партала (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) і прывязка да папярэдне створаных карыстальнікаў Bitrix24 па фіксаваных ідэнтыфікатарах (BITRIX24_AGENT_USER_IDS).

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

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

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

Падтрымліваемыя функцыі

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

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

Межы

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

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

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

Устаноўка

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

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

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