поптимайзер Docs

Интеграция с MAX

Получайте уведомления о новых заявках в мессенджер MAX — в личные сообщения или групповой чат. MAX (ранее VK Teams) — корпоративный мессенджер с поддержкой ботов.

Что понадобится

  • Аккаунт в MAX
  • 5-10 минут времени

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

Бот — это специальный аккаунт MAX, который будет отправлять вам уведомления.
  1. Откройте MAX и найдите @MasterBot (официальный бот для создания ботов)
Поиск MasterBot в MAX Скриншот: Поиск @MasterBot в MAX
  1. Отправьте команду /newbot
  2. Следуйте инструкциям: придумайте имя и username бота
  3. MasterBot пришлёт вам токен — строку для доступа к API
Получение токена от MasterBot Скриншот: Диалог с MasterBot — сообщение с токеном бота
Важно: Сохраните токен — он понадобится на следующем шаге. Не делитесь им с посторонними.
[!NOTE] Подробная документация по созданию ботов: dev.max.ru/docs-api

Шаг 2. Получите Chat ID

Chat ID — это адрес, куда бот будет отправлять сообщения.

Вариант А: Уведомления в личные сообщения

  1. Найдите своего бота в MAX (по username)
  2. Напишите ему любое сообщение (например, /start)
  3. Используйте API-метод /chats с токеном бота, чтобы получить список чатов — ваш Chat ID будет в ответе

Вариант Б: Уведомления в групповой чат

  1. Создайте группу в MAX (или используйте существующую)
  2. Добавьте бота в группу
  3. Напишите любое сообщение в группу
  4. Используйте API-метод /chats с токеном бота — Chat ID группы будет в ответе
[!TIP] Для получения Chat ID можно использовать curl:
curl -H "Authorization: ВАШ_ТОКЕН" https://platform-api.max.ru/chats
В ответе найдите нужный чат и скопируйте значение chat_id.

Шаг 3. Настройте интеграцию в Поптимайзер

  1. Откройте попап в редакторе
  2. Нажмите «Интеграции» в верхнем меню
  3. Нажмите «Добавить интеграцию»
  4. Выберите «MAX»
Выбор MAX интеграции Скриншот: Форма создания интеграции с выбранной карточкой «MAX»
  1. Заполните форму:
    • Название — как интеграция будет отображаться в списке (например, «Уведомления в команду»)
    • Токен бота — вставьте токен из шага 1
    • Chat ID — вставьте Chat ID из шага 2
Форма настройки MAX интеграции Скриншот: Заполненная форма MAX интеграции
  1. Нажмите «Создать»

Шаг 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 полей в вашей форме.
[!NOTE] MAX поддерживает форматирование HTML и Markdown. По умолчанию используется HTML — вы можете использовать теги <b>, <i>, <a> в шаблоне.

Шаг 5. Проверьте маппинг полей

После настройки шаблона сообщения внизу формы появится блок маппинга полей. Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:
  • Совпадающие поля (зелёная точка) — переменная найдена в форме попапа
  • Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе
  • Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне
[!TIP] Если видите оранжевые предупреждения — проверьте, что в попапе есть все нужные поля формы, или уберите лишние переменные из шаблона.

Шаг 6. Протестируйте

  1. Найдите созданную интеграцию в списке
  2. Нажмите кнопку «Тест»
  3. Проверьте MAX — должно прийти тестовое сообщение
Тестовое сообщение в MAX Скриншот: Тестовое сообщение от бота в MAX
Если сообщение не пришло:
  • Проверьте правильность токена и Chat ID
  • Убедитесь, что бот добавлен в чат (если отправляете в группу)
  • Убедитесь, что вы написали боту хотя бы одно сообщение (для личных чатов)

Готово!

Теперь при каждой отправке формы вы будете получать уведомление в MAX.

Частые вопросы

Можно ли отправлять в несколько чатов?

Да. Создайте несколько MAX-интеграций с разными Chat ID и привяжите их к попапу.

Сообщения не приходят в группу

  1. Убедитесь, что бот добавлен в группу
  2. Убедитесь, что бот имеет права на отправку сообщений
  3. Проверьте Chat ID — используйте API-метод /chats для получения корректного ID

Как изменить формат сообщения?

Откройте интеграцию на редактирование и измените шаблон. Изменения применятся сразу.

Чем MAX отличается от Telegram?

  • MAX использует другой Bot API (platform-api.max.ru)
  • Создание бота через @MasterBot (не @BotFather)
  • Токен передаётся в заголовке Authorization
  • Поддерживаются форматы html и markdown
Полезные ссылки:
Нужна помощь с настройкой? Напишите нам на support@poptimizer.ru — поможем разобраться.
Следующие шаги: