Appearance
Подключение MAX
Через бота в мессенджере MAX можно отправлять массовые рассылки, сообщения триггерных цепочек и сервисные (транзакционные) сообщения. Например, одноразовые коды в MAX обходятся дешевле SMS, но MAX есть не у всех клиентов, поэтому для кодов его удобно использовать в каскаде вместе с SMS.
Как клиент подписывается
Бот не может написать человеку первым. Клиент должен сам открыть бота и запустить его. Дальше:
- Бот отправляет приветственное сообщение и просит поделиться телефоном — кнопкой с текстом из настройки Текст кнопки запроса телефона.
- Клиент делится контактом, и платформа ищет его в базе клиентов проекта по телефону.
- Если клиент найден, его идентификатор в MAX сохраняется в профиле, а бот отправляет сообщение об успешной подписке. Если не найден — ответ, если клиент не найден.
Шаг 1. Создайте бота
Боты в MAX создаются на платформе для бизнеса business.max.ru. Создать бота может только организация: юридическое лицо или ИП.
- Зарегистрируйте организацию на платформе и дождитесь ее подтверждения.
- Создайте бота: укажите название и описание.
- Дождитесь, пока бот пройдет модерацию.
- Скопируйте токен бота в разделе интеграции бота.
Интерфейс платформы MAX может меняться
Точные названия разделов и правила модерации сверяйте с документацией MAX для партнеров.
Один бот — одна система
Бот передает события только на один адрес (вебхук). Если бот уже работает с другой системой, после подключения к платформе подписки на события перейдут к ней. Для рассылок лучше завести отдельного бота.
Шаг 2. Настройте канал в платформе
- Откройте Коммуникации → Настройки → MAX и нажмите Изменить настройки.
- Заполните поля:
| Поле | Что вводить |
|---|---|
| Токен бота | Токен бота из кабинета MAX. Без токена канал не работает. При редактировании оставьте поле пустым, чтобы не менять токен |
| Приветственное сообщение | Первое сообщение клиенту после запуска бота. До 4096 символов |
| Текст кнопки запроса телефона | Текст кнопки, которой клиент делится телефоном, например «Поделиться номером». До 100 символов |
| Сообщение об успешной подписке | Ответ клиенту, когда он найден и подписан. До 4096 символов |
| Ответ, если клиент не найден | Ответ, если клиента с таким телефоном нет в базе проекта. До 4096 символов |
- Сохраните настройки.
Шаг 3. Зарегистрируйте вебхук
Вебхук — адрес, по которому MAX сообщает платформе, что клиент запустил или остановил бота. Без него платформа не узнает о новых подписчиках.
- Откройте Коммуникации → Настройки → MAX.
- Нажмите Зарегистрировать вебхук.
В строке Вебхук появится статус «Зарегистрирован». Если появилась ошибка «MAX отказался выполнить операцию с вебхуком», проверьте токен бота.
Чтобы отключить бота от платформы, нажмите Удалить вебхук. Удалить токен бота можно только после удаления вебхука.
Сообщения
- Сообщение — текст или текст с одной картинкой.
- В тексте можно использовать HTML-теги
<b>,<i>,<u>,<s>,<a>,<code>,<pre>,<mark>,<blockquote>, заголовки<h1>–<h4>, а также Liquid-переменные. - Кнопок у сообщений MAX нет.
- Ссылки получают UTM-метки и сокращаются.
Ограничения и отписка
- Платформа отправляет до 25 сообщений в секунду на бота. Если MAX просит подождать, платформа делает паузу и продолжает отправку.
- Если клиент заблокировал бота или чат не найден, платформа отписывает клиента от рассылок в MAX.
- Если MAX не принял конкретное сообщение (например, слишком длинный текст или недоступная картинка), это мягкий отказ: клиент остается подписанным.
Где используется канал
- Массовые рассылки: Коммуникации → Массовые рассылки → MAX.
- Триггерные цепочки: шаблоны канала MAX в Коммуникации → Триггерные цепочки → Шаблоны → MAX.
- Транзакционные рассылки: Коммуникации → Сервисные сообщения → MAX. MAX может быть одним из каналов каскада.
Как проверить
- Запустите своего бота в MAX и поделитесь телефоном. Телефон должен быть в вашем профиле в базе клиентов проекта.
- Отправьте тестовое сообщение из карточки рассылки: в поле Идентификатор в MAX укажите свой идентификатор в MAX.