Skip to content

Подключение MAX ​

Через бота в мессенджере MAX можно отправлять массовые рассылки, сообщения триггерных цепочек и сервисные (транзакционные) сообщения. Например, одноразовые коды в MAX обходятся дешевле SMS, но MAX есть не у всех клиентов, поэтому для кодов его удобно использовать в каскаде вместе с SMS.

Как клиент подписывается ​

Бот не может написать человеку первым. Клиент должен сам открыть бота и запустить его. Дальше:

  1. Бот отправляет приветственное сообщение и просит поделиться телефоном — кнопкой с текстом из настройки Текст кнопки запроса телефона.
  2. Клиент делится контактом, и платформа ищет его в базе клиентов проекта по телефону.
  3. Если клиент найден, его идентификатор в MAX сохраняется в профиле, а бот отправляет сообщение об успешной подписке. Если не найден — ответ, если клиент не найден.

Шаг 1. Создайте бота ​

Боты в MAX создаются на платформе для бизнеса business.max.ru. Создать бота может только организация: юридическое лицо или ИП.

  1. Зарегистрируйте организацию на платформе и дождитесь ее подтверждения.
  2. Создайте бота: укажите название и описание.
  3. Дождитесь, пока бот пройдет модерацию.
  4. Скопируйте токен бота в разделе интеграции бота.

Интерфейс платформы MAX может меняться

Точные названия разделов и правила модерации сверяйте с документацией MAX для партнеров.

Один бот — одна система

Бот передает события только на один адрес (вебхук). Если бот уже работает с другой системой, после подключения к платформе подписки на события перейдут к ней. Для рассылок лучше завести отдельного бота.

Шаг 2. Настройте канал в платформе ​

  1. Откройте Коммуникации → Настройки → MAX и нажмите Изменить настройки.
  2. Заполните поля:
ПолеЧто вводить
Токен ботаТокен бота из кабинета MAX. Без токена канал не работает. При редактировании оставьте поле пустым, чтобы не менять токен
Приветственное сообщениеПервое сообщение клиенту после запуска бота. До 4096 символов
Текст кнопки запроса телефонаТекст кнопки, которой клиент делится телефоном, например «Поделиться номером». До 100 символов
Сообщение об успешной подпискеОтвет клиенту, когда он найден и подписан. До 4096 символов
Ответ, если клиент не найденОтвет, если клиента с таким телефоном нет в базе проекта. До 4096 символов
  1. Сохраните настройки.

Шаг 3. Зарегистрируйте вебхук ​

Вебхук — адрес, по которому MAX сообщает платформе, что клиент запустил или остановил бота. Без него платформа не узнает о новых подписчиках.

  1. Откройте Коммуникации → Настройки → MAX.
  2. Нажмите Зарегистрировать вебхук.

В строке Вебхук появится статус «Зарегистрирован». Если появилась ошибка «MAX отказался выполнить операцию с вебхуком», проверьте токен бота.

Чтобы отключить бота от платформы, нажмите Удалить вебхук. Удалить токен бота можно только после удаления вебхука.

Сообщения ​

  • Сообщение — текст или текст с одной картинкой.
  • В тексте можно использовать HTML-теги <b>, <i>, <u>, <s>, <a>, <code>, <pre>, <mark>, <blockquote>, заголовки <h1>–<h4>, а также Liquid-переменные.
  • Кнопок у сообщений MAX нет.
  • Ссылки получают UTM-метки и сокращаются.

Ограничения и отписка ​

  • Платформа отправляет до 25 сообщений в секунду на бота. Если MAX просит подождать, платформа делает паузу и продолжает отправку.
  • Если клиент заблокировал бота или чат не найден, платформа отписывает клиента от рассылок в MAX.
  • Если MAX не принял конкретное сообщение (например, слишком длинный текст или недоступная картинка), это мягкий отказ: клиент остается подписанным.

Где используется канал ​

Как проверить ​

  1. Запустите своего бота в MAX и поделитесь телефоном. Телефон должен быть в вашем профиле в базе клиентов проекта.
  2. Отправьте тестовое сообщение из карточки рассылки: в поле Идентификатор в MAX укажите свой идентификатор в MAX.