Bitrix24

> [!IMPORTANT] > Поддерживаются внутренние чаты Bitrix24. Открытые линии, очередь клиентских > обращений и передача оператору не поддерживаются. **Bitrix24 — это внутренний мессенджер (IM) для сотрудников** — та же роль, которую для персонала играют Telegram или Slack. Агент AiHummer появляется внутри вашего корпоративного Bitrix24 как коллега, которому сотрудники могут писать и которого могут упоминать. Канал поставляется как **коннектор из встроенного [Маркетплейса](/v1.0/marketplace/overview-tiers)** и устанавливается напрямую в Linux, без контейнеров. Он настраивается в админ-панели, как любой другой канал. > [!NOTE] > Канал Bitrix24 требует активной лицензии **Starter**, **Business** или > **Enterprise**. На тарифе Community установка коннектора возвращает > **HTTP 402 «требуется повышение тарифа»** (код `plan_limit`) — подробнее в > [Лицензировании](/v1.0/commercial/licensing). > [!WARNING] > Bitrix24 здесь — строго **внутренний мессенджер для сотрудников**. Это **не** > клиентский омниканал, **не** Открытые линии (Open Lines) Bitrix24, **не** > очередь клиентских обращений и **не** поверхность для передачи диалога > оператору. Не используйте его для маршрутизации внешних клиентских диалогов. ## Отдельная учётная запись агента Каждый агент подключается со своей **отдельной OAuth-учётной записью, поэтому в Bitrix24 агент отображается как отдельный коллега, а не как общий бот**. Доступ соответствует организационной структуре через **ACL по дереву отделов** — агент видит и участвует только там, где его учётной записи разрешено, следуя той же иерархии отделов, что и сотрудники. Помимо OAuth-учётных записей, коннектор поддерживает и другие способы provisioning: **автоматическое создание учётных записей агентов от имени администратора портала** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) и привязку к **заранее созданным пользователям Bitrix24 по фиксированным id** (`BITRIX24_AGENT_USER_IDS`). ## Порты и среда выполнения Коннектор слушает один порт: | Порт | Назначение | |---|---| | 8810 | Сервис коннектора (проверка работоспособности, endpoint Deliver и OAuth consent) | ## Как ходят сообщения Bitrix24 не отправляет входящие события в AiHummer сам — коннектор **забирает** их. - **Входящие** — pull-опрос читает новые сообщения и отправляет их в шлюз на `/v1/inbound/generic`. - **Исходящие** — ответы доставляются через контракт **Deliver** `aihummer.connector.v1`. **Markdown агента конвертируется в BB-code Bitrix24**, а доставка **идемпотентна**, поэтому повторная отправка не создаёт дубликат сообщения. ## Что поддерживается Канал покрывает взаимодействия, которые соответствуют модели «агент — отдельный сотрудник»: - Реакции, **редактирование** и **удаление** сообщений. - Индикаторы **набора текста** (typing). - **@-упоминания**. - **Медиа** в исходящих сообщениях. > [!WARNING] > Некоторые возможности в стиле Telegram намеренно **не** поддерживаются в > модели отдельной учётной записи: > > - **Нет интерактивных клавиатур и кнопок** и **нет тредов**. > - **Входящие текст, медиа и голос пересылаются** — изображения, аудио, голос и файлы. > > Проектируйте сценарии агента на этом канале вокруг текстового взаимодействия. ## Куда дальше - Об установке коннекторов: [Маркетплейс](/v1.0/marketplace/overview-tiers). - Для интерактивных клавиатур и опросов используйте [Telegram](/v1.0/channels/telegram) или [MAX](/v1.0/channels/max). - Лежащий в основе API приёма см. в [Универсальном входящем вебхуке](/v1.0/channels/generic-inbound).