Инструкция по настройке связи чата Мессенджера с чатом MAX или Telegram

Назначение документа

В документе описана настройка связи чата Мессенджера с чатом MAX или Telegram.

Создание связи между чатами приложений предоставляет:

Возможность коммуникации пользователей корпоративного сервиса Мессенджер c физлицами или пользователями из других компаний без Мессенджера.
Возможность переписки и обмена файлами в групповых чатах, в которых состоят пользователи Мессенджера , MAX и Telegram.

Документ предназначен для использования конечными пользователями.

Верхнеуровневое описание взаимодействия

Общая схема взаимодействия при установке связи между чатами:

Взаимодействие между чатами выполняется с помощью сервиса Pigeon, который осуществляет перенаправление сообщений из бота Мессенджера в боты MAX или Telegram и в обратном направлении.

Общее описание взаимодействия:

При создании связи между чатами создается отдельный мост для каждого соединения. Все созданные связи (мосты) хранятся в хранилище соединений между чатами -- Tarantool.
Передача и получение сообщений осуществляется через ботов, между которыми установлена связь.
При отправке сообщений бот отправляет запрос в Router для получения данных установленной связи между чатами из Tarantool.
После получения данных из Tarantool, Router отправляет сообщение боту мессенджера, с которым установлена связь.

Ограничения и допущения

Cвязь может быть создана:

Только из Мессенджера.
Только администратором чата Мессенджера.
Только с одним чатом MAX или только с одним чатом Telegram.

Общие ограничения:

В MAX нет обсуждений, поэтому сообщения из обсуждений не передаются.
Ответы на сообщения пересылаются как новые сообщения в связанный чат.
Реакции на сообщения не пересылаются в связанный чат.

Редактирование сообщения:

Передается из Мессенджера как отдельное сообщение.
Изменения текста сообщений в MAX или Telegram не передается в Мессенджер.

Пересылка файлов ограничена следующими объемами:

Из MAX в Мессенджер -- не более 52 Мб.
Из Мессенджер в MAX -- не более 200 Мб.
Из Мессенджер в Telegram -- не более 50 Мб.
Из Telegram в Мессенджер -- не более 52 Мб.

Создание связи между чатами

Чтобы создать связь между чатами:

Создайте групповой чат в MAX или Telegram (или используйте существующий).
Добавьте в чат MAX или Telegram чат-бота VK Teams bot и выдайте права администратора:
- для MAX: https://max.ru/xJYTI8a_bot.
- для Telegram: в строке поиска введите имя чат-бота VK Teams bot.
Получите идентификатора чата MAX или Telegram:
```
/get_chat_id
```
Отправьте полученный идентификатор пользователю Мессенджера, с которым необходимо установить связь.
В Мессенджере создайте новый групповой чат (или используйте существующий) и отключите в настройках возможность создания новых обсуждений:
Добавьте в чат Мессенджера бота Bridgebot и выдайте права администратора.
Выполните в чате Мессенджера команду для связи с чатом в MAX или Telegram:

Для связи с чатом MAX:
```
/create_max_link <max_chat_id>
```
Для связи с чатом Telegram:
```
/create_tg_link <tg_chat_id>
```
где и — идентификатор, полученный от пользователя MAX или Telegram. Обязательно поставьте тире в начале идентификатора:
Если все действия выполнены правильно, в чате Мессенджера от бота придет сообщение об успешном создании связи между чатами:

Примечание

При отсутствии активной связи с чатом Мессенджера на каждое сообщение в чате от бота будет приходить оповещение об отсутствии связи с другим чатом.

Удаление связи между чатами

Чтобы удалить связь между чатами:

Выполните в чате Мессенджера, MAX или Telegram команду /delete_link для разрыва существующей связи.
Если все прошло успешно, от бота придет сообщение об удалении связи между чатами:
Удалите бота из чата.

Примечание

Если бот не будет удален из чата после удаления связи с чатом MAX или Telegram, то на каждое сообщение, отправленное в чате, будет приходить оповещение от бота об отсутствии связи с другим чатом.