Плагин Bitrix24

Плагин Bitrix24

v1.2.x · обновлено 2026-07-21

Поддерживаются внутренние чаты Bitrix24. Открытые линии, очередь клиентских обращений и передача оператору не поддерживаются.

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

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

Плагин работает напрямую в Linux (без контейнеров) и общается со шлюзом по контракту aihummer.connector.v1. Поведение канала для конечного пользователя — на странице канала Bitrix24; эта страница про сам плагин.

Факты

Поле	Значение
Версия	1.0.0
Порт	8810
Среда	без контейнеров (systemd)

Что это такое

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

Кроме OAuth-учётных записей, поддерживаются и другие пути заведения: автосоздание учётных записей агентов через администратора портала (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) и привязка к заранее созданным пользователям Bitrix24 по фиксированным id (BITRIX24_AGENT_USER_IDS).

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

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

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

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

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

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

Ограничения

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

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

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

Установка

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

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

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