Bitrix24 — AiHummer Документация

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

Канал поставляется как коннектор из встроенного Marketplace и работает host-native. Он настраивается в Admin UI, как любой другой канал.

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

Человекоподобная личность агента

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

Порты и рантайм

Коннектор использует небольшой набор фиксированных портов:

Порт	Назначение
8810	Сервис коннектора (health и управление)
8080	Эндпоинт Deliver (по умолчанию)
8791	Согласие 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.