Для интеграции с мессенджером MAX необходимо создать бота в кабинете партнера. После создания бота вы получите имя бота и секретный ключ — они понадобятся для настройки интеграции на вашем сайте.
Создание бота
На данный момент создание бота в мессенджере MAX доступно только для ИП и юридических лиц. Физическим лицам регистрация недоступна.
Если вы подходите под эти требования — подайте заявку в кабинете партнёра MAX и дождитесь модерации. После прохождения модерации вы сможете создать бота и получить данные для интеграции.
Требования к сертификату
Для работы уведомлений через MAX на сервере обязательно должен быть установлен российский корневой сертификат Минцифры: Russian Trusted Root CA. (Статья в ГосУслугах: https://www.gosuslugi.ru/landing/crt) . Если у вас на сервере не стоит сертификат, то просто скачайте его по ссылке Russian Trusted Root CA, далее откройте файл через любой редактор, скопируйте всё содержимое и вставьте в поле Сертификат в настройках мессенджера на вашем сайте.
Без этого сертификата сервер не сможет обмениваться данными с API MAX, и уведомления не будут доставляться.
Важное замечание о SSL-сертификате сайта
Если на вашем сайте используется самоподписанный сертификат, это может быть причиной того, что уведомления не приходят. MAX не сможет корректно доставлять webhook-события на ваш сервер.
Для работы необходим:
- Платный SSL-сертификат от любого удостоверяющего центра, либо
- Бесплатный сертификат Lets Encrypt — его достаточно, он полностью поддерживается.
Самоподписанные сертификаты для интеграции с MAX не подходят.
Настройка уведомлений
Уведомления подключаются для каждого пользователя отдельно. Управляются они в карточке пользователя в админ панели. Также любой пользователь может подключить уведомления у себя в профиле на сайте.
Чтобы подключить уведомления, нужно:
- Подписаться на бота. Без подписки система не будет знать, куда отправлять уведомления.
- Выбрать типы уведомлений, которые система будет отправлять в MAX. Без выбора этих пунктов уведомления приходить не будут.
Назначать, какие уведомления будут приходить другим пользователям админ панели, может только супер админ.
Пошаговое подключение
- Перейдите в настройки своего профиля в админ панели.
- Выберите метод отправки уведомлений — MAX.
- Подпишитесь на бота.
После подписки в чате бота появится сообщение об успешной привязке бота. Если сообщение не отобразилось:
- Перейдите в мессенджер MAX и отправьте любое сообщение боту.
- Заново нажмите /start.
- Повторите подписку на бота в настройках профиля.
Если уведомления не приходят
Если вы выполнили все шаги, но сообщения не приходят, и вы уверены, что в настройках правильно указаны имя бота и секретный ключ, — проблема в сертификате вашего сайта.