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 не отображается в настройках каналов общения, проверьте, что в Вашем тарифе доступно подключение каналов мессенджеров, и при необходимости обратитесь к Вашему аккаунт-менеджеру.
Создание чат-бота
-
Чтобы создать бот в MAX, Вы сначала должны подключиться к платформе MAX для партнёров, создать и верифицировать профиль организации. Инструкцию по созданию профиля организации можно найти по этой ссылке.
-
После создания профиля организации перейдите на платформу именно по этой ссылке: https://business.max.ru/self/?utm_source=webim.
-
В разделе Чат-бот и мини-приложение нажмите Создать.
-
Заполните данные в настройках бота (его карточке) и нажмите Создать.
Чат-бот создан и теперь находится на модерации. После прохождения модерации Вам станет доступен токен бота, который необходимо будет скопировать и вставить в настройки канала в Панели управления Webim.
Токен можно найти на платформе в разделе Интеграция → Получить токен.
Настройка интеграции
-
В Панели управления Webim откройте Настройки → Каналы общения.
-
В группе MAX нажмите Добавить. Откроется форма Добавление канала MAX.
-
Заполните настройки канала:
-
В поле Название канала введите имя, под которым канал будет виден оператору.
-
Вставьте токен из буфера обмена в поле Токен аутентификации бота.
-
В поле Ответное сообщение на /start можно указать текст, который бот отправит на команду
/start, если поле заполнено. -
Чек-бокс Начать диалог на /start начинает диалог вместе с командой
/start. Если чек-бокс выключен, диалог начнётся с первого сообщения посетителя. -
Чек-бокс Измененная ссылка на кнопке устанавливает, будет ли кнопка MAX перенаправлять на
max://max.ru/<bot>вместоhttps://max.ru/<bot>. По такой ссылке открывается не страница в браузере, а приложение MAX, что удобнее при использовании мобильных устройств. -
Чек-бокс Системные сообщения передаёт в MAX системные сообщения Webim.
-
Выбор отдела: Не нужен или Обязателен. Если выбор не нужен, укажите отдел в поле Обращение для отдела. Если обязателен — отметьте отделы в поле Доступные для выбора отделы.
-
Внешний идентификатор — идентификатор канала для бота ЦРТ. Подробнее — в разделе Каналы общения.
-
Автоотключение при ошибках — сколько подряд невосстановимых ошибок допускается до отключения канала.
0оставляет канал включённым. -
Чек-бокс Использовать прокси включает блок прокси.
-
-
Проверьте все поля формы и нажмите кнопку Сохранить.
После сохранения канал появится в списке подключённых каналов общения. Если посетитель напишет боту в MAX, в РМО будет создан новый диалог и назначен операторам согласно настройкам маршрутизации.
В случае, если в РМО сообщения не приходят, проверьте, пожалуйста, правильность настройки интеграции и, если это необходимо, повторите процедуру.
Для hosted-установок отдельно проверьте, что с сервера Webim проходит TLS-проверка к platform-api2.max.ru: в логах Chat Backend ошибка SSLCertVerificationError / unable to get local issuer certificate обычно означает, что не добавлены сертификаты Минцифры.
Если же у Вас всё же возникли сложности с настройкой, обратитесь, пожалуйста, в службу технической поддержки Webim. При обращении прикрепите всю необходимую информацию, которую Вы указывали выше при настройке канала MAX в Панели управления Webim.
Голосовые сообщения
Посетители могут отправлять голосовые сообщения в MAX; в РМО оператор их прослушивает. Запись и отправка голосовых оператором в чатах MAX недоступны. Ограничения по каналам см. в таблице возможностей.