Плагин Bitrix24

Плагин Bitrix24 подключает вашего агента к Bitrix24 как внутренний мессенджер для сотрудников. Сотрудники пишут агенту так же, как написали бы коллеге, а агент отвечает прямо в чате Bitrix24.

[!WARNING] Bitrix24 здесь — это внутренний мессенджер для сотрудников, как Telegram или Slack для персонала. Это не клиентский омниканал: нет Открытых линий, нет очереди тикетов и нет эскалации на оператора. Не используйте этот плагин как фронт клиентской поддержки.

Плагин работает host-native и общается с gateway по контракту . Поведение канала для конечного пользователя — на странице канала Bitrix24; эта страница про сам плагин.

Факты

Поле	Значение
Версия	1.0.0
Порт	8810
Среда	host-native

Что это такое

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

Как используется

Входящее: pull-поллер забирает новые сообщения и пересылает их на generic-эндпоинт входящих gateway, где роутер определяет целевого агента.
Исходящее: ответы отправляются через идемпотентный шаг Deliver коннектора, который конвертирует Markdown агента в BB-code Bitrix24 и гарантирует, что сообщение не будет отправлено дважды.

сотрудник ─▶ чат Bitrix24 ─▶ pull-поллер ─▶ gateway (роутер · ход) ─▶ Deliver (Markdown→BB-code, идемпотентно) ─▶ Bitrix24

Поддерживаемые возможности

Плагин поддерживает богатое, человекоподобное поведение в чате:

реакции
редактирование и удаление сообщений
индикаторы набора текста
@-упоминания
медиа

Ограничения

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

Нет интерактивных клавиатур / кнопок и нет тредов.

Входящие медиа и голос не пересылаются — входящее только текст. Идентичность в стиле коллеги принимает и отвечает на текст; вложения и голосовые сообщения, отправленные агенту, в ход не передаются.

Установка

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

Безопасность и ограничения

Только внутренний мессенджер для сотрудников — не клиентский омниканал.
Человекоподобная OAuth-идентичность на каждого агента — агенты не общие bot-аккаунты.
ACL по дереву подразделений — охват уважает вашу оргструктуру.
Идемпотентный Deliver — Markdown рендерится в BB-code и не отправляется дважды.
Входящее только текст; нет клавиатур/тредов.
Host-native — работает под systemd, не в контейнере.