Плагін Bitrix24

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

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

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

Апісаныя ніжэй медыя і агульнае OAuth-падключэнне патрабуюць падпісанага Core 1.4.15 і асобна падпісанага канектара 1.1.1 пасля публікацыі ў каталогу і абнаўлення. Усталяваны 1.1.0 не пацвярджае даступнасць гэтых магчымасцей.

Факты

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

Што гэта

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

Укажыце асобных карыстальнікаў партала ў BITRIX24_AGENT_USER_IDS, а партал — у BITRIX24_PORTAL. Маршрутызацыя па аддзелах абмяжоўвае допуск супрацоўнікаў; уліковы запіс агента не падмяняе ініцыятара задачы. Неабавязковае існуючае аўтаматычнае падключэнне выкарыстоўвае BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Пры ўказаных версіях BITRIX24_VAULT_CONNECTIONS выбірае існуючае дзейнае OAuth-падключэнне ў аўтаномным рэжыме, якое належыць уладальніку ўліковых даных. Выкарыстоўвайце падтрыманае кіраванне натыўным сховішчам і падключэннямі; той жа ID уліковых даных выбірайце ў прывязках інструментаў. Сапраўдны ўладальнік рэгіструе працоўны канектар у яго рабочай прасторы праз /v1/admin/connections/channel з асобным ключом connection-token. У сакрэтнай настройцы BITRIX24_VAULT_CONNECTIONS задайце endpoint і apiKey па ID карыстальніка-агента; не змяшчайце іх у профілі або запыты агенту. Толькі сховішча абнаўляе токены; інструменты захоўваюць праверкі ініцыятара і сумеснага доступу. Гл. OAuth2.

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

Уваходныя: апытанне чытае паведамленні. Медыя спампоўваецца байтамі і рэгіструецца праз /v1/inbound/media; агент атрымлівае media_id, а не толькі URL або звесткі пра файл.
Выходныя: Deliver ператварае Markdown у BB-code і загружае сапраўдныя байты праз im.v2.File.upload. Пацвярджэнне медыя патрабуе сапраўдных FILE_ID і ID паведамленняў; тэкст або спасылка не з’яўляюцца квітанцыяй файла.

Захоўвайце трывалы журнал дастаўкі пры абнаўленні. Паўтор пацверджанай аперацыі вяртае ранейшую квітанцыю. Частковыя або невядомыя эфекты аўтаматычна не адпраўляюцца паўторна; праверце іх перад паўторам.

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

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

Рэакцыі і @-згадкі.
Набор і адказы, калі акаўнт і платформа падтрымліваюць im.dialog.writing і REPLY_ID.
Уваходныя выявы, аўдыё, голас і файлы з улікам патрабаванняў да версій вышэй.
Рэдагаванне/выдаленне паведамленняў — толькі ў старых інтэграцый з асобнай ідэнтычнасцю бота; для звычайных OAuth-карыстальнікаў яны не абвяшчаюцца.

Межы

[!WARNING] Інтэрактыўныя клавіятуры, кнопкі і галінкі не падтрымліваюцца.

Створаны або падрыхтаваны файл яшчэ не пацвярджае дастаўку. Частковыя, няўдалыя і невядомыя вынікі павінны заставацца бачнымі.

Устаноўка

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

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

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