AiHummer
Русский▾
ВойтиЛичный кабинет
v1.4.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналы/Bitrix24

Bitrix24

v1.4.x · обновлено 2026-10-14

Bitrix24 — это внутренний мессенджер (IM) для сотрудников — та же роль, которую для персонала играют Telegram или Slack. Агент AiHummer появляется внутри вашего корпоративного Bitrix24 как коллега, которому сотрудники могут писать и которого могут упоминать.

Канал поставляется как коннектор из встроенного Маркетплейса и устанавливается напрямую в Linux, без контейнеров. Он настраивается в админ-панели, как любой другой канал.

[!NOTE] Канал Bitrix24 требует активной лицензии Starter, Business или Enterprise. На тарифе Community установка коннектора возвращает HTTP 402 «требуется повышение тарифа» (код plan_limit) — подробнее в Лицензировании.

[!WARNING] Bitrix24 здесь — строго внутренний мессенджер для сотрудников. Это не клиентский омниканал, не Открытые линии (Open Lines) Bitrix24, не очередь клиентских обращений и не поверхность для передачи диалога оператору. Не используйте его для маршрутизации внешних клиентских диалогов.

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

Отдельная учётная запись агента

Укажите отдельных пользователей портала в 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.

Порты и среда выполнения

Порт Назначение
8810 Сервис коннектора на loopback: проверка работоспособности и Deliver

Как ходят сообщения

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

Сохраняйте долговечный журнал доставки при обновлении. Повтор подтверждённой операции возвращает прежнюю квитанцию. Частичный или неизвестный эффект автоматически не отправляется повторно; проверьте его перед повтором.

Что поддерживается

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

[!WARNING] Интерактивные клавиатуры, кнопки и треды не поддерживаются.

Созданный или подготовленный файл ещё не означает подтверждённую доставку. Частичные, неуспешные и неизвестные результаты должны оставаться видимыми.

Куда дальше