Интеграция с MAX
Получайте уведомления о новых заявках в мессенджер MAX — в личные сообщения или групповой чат. MAX — российский мессенджер от VK с поддержкой ботов.
Что понадобится
Ссылка на раздел «Что понадобится»- Аккаунт в MAX
- 5-10 минут времени
Шаг 1. Создайте бота в MAX
Ссылка на раздел «Шаг 1. Создайте бота в MAX»Бот — это специальный аккаунт MAX, который будет отправлять вам уведомления.
-
Откройте MAX и найдите @MasterBot (официальный бот для создания ботов)
-
Отправьте команду
/newbot -
Следуйте инструкциям: придумайте имя и username бота
-
MasterBot пришлёт вам токен — строку для доступа к API
Важно: Сохраните токен — он понадобится на следующем шаге. Не делитесь им с посторонними.
Важно:
Подробная документация по созданию ботов: dev.max.ru/docs-api
Шаг 2. Получите Chat ID
Ссылка на раздел «Шаг 2. Получите Chat ID»Chat ID — это адрес, куда бот будет отправлять сообщения.
Вариант А: Уведомления в личные сообщения
Ссылка на раздел «Вариант А: Уведомления в личные сообщения»- Найдите своего бота в MAX (по username)
- Напишите ему любое сообщение (например,
/start) - Используйте API-метод
/chatsс токеном бота, чтобы получить список чатов — ваш Chat ID будет в ответе
Вариант Б: Уведомления в групповой чат
Ссылка на раздел «Вариант Б: Уведомления в групповой чат»- Создайте группу в MAX (или используйте существующую)
- Добавьте бота в группу
- Напишите любое сообщение в группу
- Используйте API-метод
/chatsс токеном бота — Chat ID группы будет в ответе
Совет:
Для получения Chat ID можно использовать curl:
curl -H "Authorization: ВАШ_ТОКЕН" https://platform-api.max.ru/chatsВ ответе найдите нужный чат и скопируйте значение chat_id.
Шаг 3. Настройте интеграцию в Поптимайзер
Ссылка на раздел «Шаг 3. Настройте интеграцию в Поптимайзер»-
Откройте попап в редакторе
-
Нажмите «Интеграции» в верхнем меню
-
Нажмите «Добавить интеграцию»
-
Выберите «MAX»
-
Заполните форму:
- Название — как интеграция будет отображаться в списке (например, «Уведомления в команду»)
- Токен бота — вставьте токен из шага 1
- Chat ID — вставьте Chat ID из шага 2
-
Нажмите «Создать»
Шаг 4. Настройте шаблон сообщения
Ссылка на раздел «Шаг 4. Настройте шаблон сообщения»По умолчанию сообщение выглядит так:
Новая заявка!
test@example.com
Иван Иванов
+7 999 123-45-67
26.01.2025, 15:30Вы можете изменить шаблон. Доступные переменные:
| Переменная | Что подставится |
|---|---|
{{data.email}} | Email из формы |
{{data.name}} | Имя из формы |
{{data.phone}} | Телефон из формы |
{{timestamp}} | Дата и время |
Пример кастомного шаблона:
Новый лид с сайта!
{{data.name}}
{{data.email}}
{{data.phone}}
Комментарий: {{data.message}}
Время: {{timestamp}}Совет: Названия переменных должны совпадать с атрибутом name полей в вашей форме.
Важно:
MAX поддерживает форматирование HTML и Markdown. По умолчанию используется HTML — вы можете использовать теги <b>, <i>, <a> в шаблоне.
Шаг 5. Проверьте маппинг полей
Ссылка на раздел «Шаг 5. Проверьте маппинг полей»После настройки шаблона сообщения внизу формы появится блок маппинга полей. Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:
- Совпадающие поля (зелёная точка) — переменная найдена в форме попапа
- Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе
- Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне
Совет:
Если видите оранжевые предупреждения — проверьте, что в попапе есть все нужные поля формы, или уберите лишние переменные из шаблона.
Шаг 6. Протестируйте
Ссылка на раздел «Шаг 6. Протестируйте»- Найдите созданную интеграцию в списке
- Нажмите кнопку «Тест»
- Проверьте MAX — должно прийти тестовое сообщение
Если сообщение не пришло:
- Проверьте правильность токена и Chat ID
- Убедитесь, что бот добавлен в чат (если отправляете в группу)
- Убедитесь, что вы написали боту хотя бы одно сообщение (для личных чатов)
Готово!
Ссылка на раздел «Готово!»Теперь при каждой отправке формы вы будете получать уведомление в MAX.
Частые вопросы
Ссылка на раздел «Частые вопросы»Можно ли отправлять в несколько чатов?
Ссылка на раздел «Можно ли отправлять в несколько чатов?»Да. Создайте несколько MAX-интеграций с разными Chat ID и привяжите их к попапу.
Сообщения не приходят в группу
Ссылка на раздел «Сообщения не приходят в группу»- Убедитесь, что бот добавлен в группу
- Убедитесь, что бот имеет права на отправку сообщений
- Проверьте Chat ID — используйте API-метод
/chatsдля получения корректного ID
Как изменить формат сообщения?
Ссылка на раздел «Как изменить формат сообщения?»Откройте интеграцию на редактирование и измените шаблон. Изменения применятся сразу.
Чем MAX отличается от Telegram?
Ссылка на раздел «Чем MAX отличается от Telegram?»- MAX использует другой Bot API (platform-api.max.ru)
- Создание бота через @MasterBot (не @BotFather)
- Токен передаётся в заголовке Authorization
- Поддерживаются форматы html и markdown
Полезные ссылки:
Нужна помощь с настройкой? Напишите нам на support@poptimizer.ru — поможем разобраться.
Следующие шаги:
- Настройка Telegram — уведомления в Telegram
- Настройка Webhook — интеграция с CRM и другими сервисами