Межпортальные чаты 2.0: единое пространство переписки для компаний с несколькими порталами Битрикс24

#bitrix24 #api #integration #webdev

Межпортальные чаты 2.0: единое пространство переписки для компаний с несколькими порталами Битрикс24

Введение

Когда у компании два и более портала Битрикс24, переписка между ними превращается в ручную работу. Сотрудники копируют сообщения, пересылают файлы через сторонние мессенджеры, дублируют задачи в разных системах. На практике это означает, что до 30% рабочего времени поддержки и проектных команд уходит не на работу, а на перекладывание информации между порталами.

Приложение «Межпортальные чаты 2.0» решает эту проблему на уровне инфраструктуры: оно связывает чаты разных порталов так, что сообщения, файлы и задачи передаются автоматически. Пользователи продолжают работать в привычном интерфейсе Битрикс24 — в чатах, открытых линиях и коллабах, — а приложение обеспечивает маршрутизацию, доставку и защиту от дублирования.

В этой статье разберём, как устроена связка порталов, какие сценарии покрывает приложение, как работает синхронизация задач и какие ошибки допускают при внедрении.

Интеграция с CRM Битрикс24

Приложение устанавливается как стандартное приложение Маркетплейса и регистрирует собственный коннектор открытых линий с идентификатором swebs_chat_v_chat2. После установки в интерфейсе появляется два раздела: «Клиентский» и «Партнёрский» — каждый со своим набором настроек.

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

Интеграция затрагивает следующие сущности Битрикс24:

Открытые линии (imconnector) — приложение регистрирует коннектор, через который сообщения клиента попадают в очередь оператора на портале партнёра.
Чат-боты (imbot) — боты v2 создаются и настраиваются через API, используются для маршрутизации сообщений между порталами.
Чаты и групповые чаты (im.chat) — стандартные чаты Битрикс24, в которые добавляются боты для пересылки сообщений.
Коллабы (collab) — поддержка коллаб как получателя сообщений добавлена в последних версиях; бот добавляется вручную пользователем.
Задачи (tasks.task) — в контуре Task Sync создаются и синхронизируются задачи между порталами.

Приложение работает как в десктопной версии Битрикс24, так и в мобильном приложении. Для мобильных устройств реализовано адаптивное поведение: вместо нестабильных слайдеров используется прямой переход на страницы, что даёт предсказуемый UX.

Автоматизация межпортальной переписки

Что заменяет приложение

До внедрения общение между порталами выглядит так: сотрудник на портале А пишет сообщение, делает скриншот или копирует текст, открывает сторонний мессенджер, пересылает коллеге на портале Б. Тот вручную создаёт задачу, прикрепляет файл, отвечает — и цикл повторяется в обратную сторону. При нескольких активных проектах между одними и теми же порталами эта механика множится и порождает ошибки: сообщение ушло не туда, файл потерялся, задачу забыли продублировать.

После настройки приложения:

сообщение, отправленное в чат с ботом на портале А, автоматически появляется в открытой линии или целевом чате на портале Б;
ответ с портала Б возвращается в исходный чат портала А;
файлы передаются вместе с сообщениями, с опциональным перехостингом на принимающий портал;
дубликаты сообщений отсекаются на уровне вебхуков (защита от парных событий ONIMBOTMESSAGEADD / ONIMBOTV2MESSAGEADD);
петли эха при пересылке файлов между ботами блокируются до попадания в чат.

Режимы маршрутизации

Приложение поддерживает три сценария маршрутизации:

Клиент → Открытая линия партнёра. Классическая сервисная модель: клиент пишет в чат с ботом на своём портале, сообщение приходит в открытую линию на портале партнёра. Оператор отвечает — ответ возвращается клиенту. Подходит для техподдержки, аутсорсинговых колл-центров и сервисных компаний.
Чат ↔ Чат (бот ↔ бот). Двусторонняя синхронизация между групповыми чатами. На обеих сторонах создаются боты, связываются между собой, и сообщения из одного чата автоматически попадают в другой. Подходит для проектных команд, работающих в разных порталах над общими задачами.
Коллаба как получатель. Новый сценарий: сообщения маршрутизируются в коллабу на принимающей стороне. Бот добавляется в коллабу вручную — это ограничение API Битрикс24, а не приложения. После добавления бот полноценно участвует в переписке коллабы.