Bitrix24
Bitrix24 — это внутренний мессенджер (IM) для сотрудников — та же роль, которую для персонала играют Telegram или Slack. Агент AiHummer появляется внутри вашего корпоративного Bitrix24 как коллега, которому сотрудники могут писать и которого могут упоминать.
Канал поставляется как коннектор из встроенного Marketplace и работает host-native. Он настраивается в Admin UI, как любой другой канал.
[!NOTE] Канал Bitrix24 требует активной лицензии Starter, Business или Enterprise. На тарифе Community установка коннектора возвращает HTTP 402 «требуется апгрейд» (код
plan_limit) — подробнее в Лицензировании.
[!WARNING] Bitrix24 здесь — строго внутренний мессенджер для сотрудников. Это не клиентский омниканал, не Открытые линии (Open Lines) Bitrix24, не очередь тикетов и не поверхность для эскалации на оператора. Не используйте его для маршрутизации внешних клиентских диалогов.
Человекоподобная личность агента
Каждый агент подключается со своей человекоподобной OAuth-личностью, поэтому в Bitrix24 он выглядит как отдельный человек, а не как обезличенный бот-интеграция. Видимость учитывает оргструктуру через ACL по дереву отделов — агент видит и участвует только там, где его личности разрешено, следуя той же иерархии отделов, что и сотрудники.
Помимо OAuth-личностей, коннектор поддерживает и другие способы provisioning:
автосоздание учётных записей агентов от имени администратора портала
(BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) и привязку к заранее
созданным пользователям Bitrix24 по фиксированным id
(BITRIX24_AGENT_USER_IDS).
Порты и рантайм
Коннектор слушает один порт:
| Порт | Назначение |
|---|---|
| 8810 | Сервис коннектора (health, эндпоинт Deliver и OAuth consent) |
Как ходят сообщения
Bitrix24 не пушит входящие события в AiHummer — коннектор забирает их сам.
- Входящие — pull-поллер читает новые сообщения и отправляет их в gateway на
/v1/inbound/generic. - Исходящие — ответы доставляются через контракт Deliver
aihummer.connector.v1. Markdown агента конвертируется в BB-code Bitrix24, а доставка идемпотентна, поэтому повторная отправка никогда не создаёт дубликат сообщения.
Что поддерживается
Канал покрывает взаимодействия, которые соответствуют человекоподобной личности сотрудника:
- Реакции, редактирование и удаление сообщений.
- Индикаторы набора текста (typing).
- @-упоминания.
- Медиа в исходящих сообщениях.
[!WARNING] Некоторые возможности в стиле Telegram намеренно не поддерживаются в человекоподобной модели:
- Нет интерактивных клавиатур и кнопок и нет тредов.
- Входящие медиа и голос не пересылаются — входящие только текст.
Проектируйте сценарии агента на этом канале вокруг текстового взаимодействия.
Куда дальше
- Об установке коннекторов: Marketplace.
- Для интерактивных клавиатур и опросов используйте Telegram или MAX.
- Лежащий в основе API приёма см. в Generic inbound.