Интеграция c Max ботом

Регистрация на платформе Max и получение токена

Подключение к платформе MAX для партнёров и её сервисам — чат-ботам, мини-приложениям, каналам — пока доступно для ограниченного списка юрлиц и ИП, которые разместили приложение в RuStore или зарегистрировались на МСП.РФ

Платформа MAX для партнёров позволяет выстраивать удобную коммуникацию с клиентами в мессенджере MAX

Для начала работы с мессенджером Max, вам сначала необходимо пройти регистрацию и верификацию по ИНН

Верификацию может пройти только владелец организации (единоличный исполнительный орган) или представитель с правом первой или единственной подписи

Документация разработчика по регистрации и верификации https://dev.max.ru/docs/maxbusiness/connection

После регистрации и получения токена, можете перейти к настройке интеграции со стороны vsDesk

Сертификаты НУЦ Минцифры и MAX API

Начиная с версии 14.07.09 используется API MAX по адресу https://platform-api2.max.ru. Для корректной работы на сервере должны быть установлены доверенные сертификаты НУЦ Минцифры.

При установке на Ubuntu, Astra Linux, РЕД ОС сертификаты ставятся автоматически.
При обновлении с предыдущих версий выполните: sudo bash lib/install_russian_trusted_certs.sh
Для офлайн-сетей: sudo RUSSIAN_CERTS_OFFLINE=1 bash lib/install_russian_trusted_certs.sh

Обновление вебхука после патча

После обновления системы на 14.07.09:

Удалите текущий вебхук кнопкой Удалить вебхук.
Сохраните настройки.
Задайте вебхук заново кнопкой Задать вебхук.

Система должна работать по HTTPS с валидным SSL-сертификатом.

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

В системе vsDesk настройка интеграции с Max ботом находится в разделе Настройки.

Параметры настройки похожи на аналогичные Telegram боту:

Токен доступа MAX бота - этот токен вы должны получить на предыдущем этапе.

URL страницы вебхука - автоматически подставляется корректный URL, для работы с ботом Max, система должна работать по HTTPS протоколу и иметь SSL сертификат (валидный или самоподписанный).

Сообщение приветствия - текст, который будет отображаться при первом обращении к боту или по команде /start.

Задать вебхук / Удалить вебхук - кнопки необходимые для регистрации и удаления вебхука.

Так же доступны команды для бота:

/getme - команда показывающая id чата для исполнителей, чтобы моно было ввести свои данные в настройках профиля пользователя и включить уведомления в бот MAX.

/help - команда для получения информации о сервисе vsDesk.

Функционал бота

Функционал Max бота аналогичен функционалу всех остальных ботов системы.