Межпортальные чаты и задачи 2.0

Как подключить MAX: Beta

Добавьте бота MAX, выберите чат и задайте направления обмена с Битрикс24.

Содержание руководства

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

Добавьте бота MAX

  1. Создайте бота MAX и получите его токен.
  2. В партнёрском разделе приложения найдите блок MAX.
  3. Добавьте бота: задайте имя и вставьте токен в соответствующее поле. Не отправляйте токен в чат поддержки.
  4. Проверьте статус подписки на события в списке ботов. Если есть ошибка, сначала устраните её; доступны проверка и принудительная переподписка.

Подготовьте чат MAX

Для бота, прошедшего модерацию, разрешите добавление в групповые чаты на платформе MAX для партнёров: «Чат-боты» → нужный бот → ⋮ → «Настройки» → «Приватность». Затем добавьте бота в нужную группу и назначьте администратором с правами чтения всех сообщений и отправки сообщений. Подготовка бота и права MAX.

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

Задайте направления

В настройках связки включите «Передавать сообщения в MAX», затем выберите бота и чат MAX.

Отдельно отметьте:

  • чьи сообщения дублировать в MAX: партнёра, клиента или обеих сторон;
  • куда доставлять входящие из MAX: партнёру, клиенту, обеим сторонам или никуда;
  • нужны ли подписи стороны и пометка [MAX] у сообщений.

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

Проверка и предупреждения

Отправьте новое сообщение с каждой включённой стороны и из MAX. Проверяйте только те направления, которые выбрали.

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

При сбое проверьте статус подписки бота, его права в группе, выбранный чат и направления. Для поддержки сохраните время теста и текст ошибки; токен передавать не нужно.