# 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 для партнёров, создать и верифицировать профиль организации. Инструкцию по созданию профиля организации можно найти по [этой ссылке](https://dev.max.ru/docs/maxbusiness/connection).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    * **Внешний идентификатор** — идентификатор канала для бота **ЦРТ**. Подробнее — в разделе [Каналы общения](https://webim.ru/kb/11.0/channels/#external-id).

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

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

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

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

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

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

Если же у Вас всё же возникли сложности с настройкой, обратитесь, пожалуйста, в службу [технической поддержки](mailto:support@webim.ru) **Webim**. При обращении прикрепите всю необходимую информацию, которую Вы указывали выше при настройке канала **MAX** в **Панели управления Webim**.

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

Посетители могут отправлять голосовые сообщения в **MAX**; в РМО оператор их прослушивает. Запись и отправка голосовых оператором в чатах **MAX** недоступны. Ограничения по каналам см. в [таблице возможностей](https://webim.ru/kb/11.0/channels/channels-functions.html).

---

Источник: https://webim.ru/kb/11.0/channels/social-network-messengers/max.html
