Как установить связь чата Мессенджера с чатом MAX

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

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

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

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

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

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

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

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

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

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

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

Пересылка файлов:

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

Предварительные действия в MAX

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

Создайте групповой чат в MAX (или используйте существующий).
Добавьте в чат MAX чат-бота вашей организации и выдайте права администратора.

Примечание

Для создания чат-бота МAX воспользуйтесь документацией по cозданию чат-бота MAX.
Получите идентификатора чата MAX, отправив в чат команду:
```
/get_chat_id
```
Отправьте полученный идентификатор и токен бота пользователю Мессенджера.

Создание связи

В Мессенджере создайте новый групповой чат (или используйте существующий) и отключите в настройках возможность создания новых обсуждений:
Добавьте в чат Мессенджера бота Bridgebot и выдайте права администратора.
Выполните в чате Мессенджера команду для связи с чатом в MAX:

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

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

Примечание

Если при создании связи возникли проблемы, обратитесь к вашему администратору для проверки и настройки опции.

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

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

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

Примечание

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