Перейти к содержанию

MAX

MAX — российская цифровая платформа, которая объединяет в себе сервисы для решения повседневных задач и мессенджер для комфортного общения.

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

Следующие шаги описывают порядок настройки интеграции MAX с сервисом Webim.

Предварительные условия

У Вас есть бизнес-аккаунт в MAX, создан чат-бот и получен токен (access_token) для интеграции.

Для hosted-клиентов:

  • С сервера Webim доступен внешний ресурс platform-api2.max.ru:443 (исходящее HTTPS-соединение).

  • Сервер Webim доступен из интернета по HTTP/HTTPS для приёма вебхуков от MAX (достаточно входящих 80 и 443).

  • На сервере Webim в доверенные добавлены сертификаты Минцифры РФ (Russian Trusted CA). Без них исходящие HTTPS-запросы в API MAX завершаются ошибкой CERTIFICATE_VERIFY_FAILED.

Доступность канала MAX зависит от тарифа. Если канал MAX не отображается в настройках каналов общения, проверьте, что в Вашем тарифе доступно подключение каналов мессенджеров, и при необходимости обратитесь к Вашему аккаунт-менеджеру.

Создание чат-бота

  1. Чтобы создать бот в MAX, Вы сначала должны подключиться к платформе MAX для партнёров, создать и верифицировать профиль организации. Инструкцию по созданию профиля организации можно найти по этой ссылке.

  2. После создания профиля организации перейдите на платформу именно по этой ссылке: https://business.max.ru/self/?utm_source=webim.

  3. В разделе Чат-бот и мини-приложение нажмите Создать.

  4. Заполните данные в настройках бота (его карточке) и нажмите Создать.

Чат-бот создан и теперь находится на модерации. После прохождения модерации Вам станет доступен токен бота, который необходимо будет скопировать и вставить в настройки канала в Панели управления Webim.

Токен можно найти на платформе в разделе Интеграция → Получить токен.

Настройка интеграции

  1. В Панели управления Webim откройте Настройки → Каналы общения.

  2. В группе MAX нажмите Добавить. Откроется форма Добавление канала MAX.

  3. Заполните настройки канала:

    • В поле Название канала введите имя, под которым канал будет виден оператору.

    • Вставьте токен из буфера обмена в поле Токен аутентификации бота.

    • В поле Ответное сообщение на /start можно указать текст, который бот отправит на команду /start, если поле заполнено.

    • Чек-бокс Начать диалог на /start начинает диалог вместе с командой /start. Если чек-бокс выключен, диалог начнётся с первого сообщения посетителя.

    • Чек-бокс Измененная ссылка на кнопке устанавливает, будет ли кнопка MAX перенаправлять на max://max.ru/<bot> вместо https://max.ru/<bot>. По такой ссылке открывается не страница в браузере, а приложение MAX, что удобнее при использовании мобильных устройств.

    • Чек-бокс Системные сообщения передаёт в MAX системные сообщения Webim.

    • Выбор отдела: Не нужен или Обязателен. Если выбор не нужен, укажите отдел в поле Обращение для отдела. Если обязателен — отметьте отделы в поле Доступные для выбора отделы.

    • Внешний идентификатор — идентификатор канала для бота ЦРТ. Подробнее — в разделе Каналы общения.

    • Автоотключение при ошибках — сколько подряд невосстановимых ошибок допускается до отключения канала. 0 оставляет канал включённым.

    • Чек-бокс Использовать прокси включает блок прокси.

  4. Проверьте все поля формы и нажмите кнопку Сохранить.

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

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

Для hosted-установок отдельно проверьте, что с сервера Webim проходит TLS-проверка к platform-api2.max.ru: в логах Chat Backend ошибка SSLCertVerificationError / unable to get local issuer certificate обычно означает, что не добавлены сертификаты Минцифры.

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

Голосовые сообщения

Посетители могут отправлять голосовые сообщения в MAX; в РМО оператор их прослушивает. Запись и отправка голосовых оператором в чатах MAX недоступны. Ограничения по каналам см. в таблице возможностей.