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

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

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

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

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

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

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

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

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

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

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

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

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

1. Создайте групповой чат в MAX (или используйте существующий).

2. Добавьте в чат MAX чат-бота вашей организации и выдайте права администратора.

3. Получите идентификатора чата MAX, отправив в чат команду:

    
   /get_chat_id

4. Отправьте полученный идентификатор и токен бота пользователю Мессенджера.

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

   

2. Добавьте в чат Мессенджера бота Bridgebot и выдайте права администратора.

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

   Для связи с чатом MAX:

    
   /create_max_link <max_chat_id>

   где <max_chat_id> — идентификатор, полученный от пользователя MAX. Обязательно поставьте дефис в начале идентификатора:

   

4. Если все действия выполнены правильно, в чате Мессенджера от бота придет сообщение об успешном создании связи между чатами:

   

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

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

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

2. Если все прошло успешно, от бота придет сообщение об удалении связи между чатами:

   

3. Удалите бота из чата.

Технический писатель: Дерябин Дмитрий