Документация / Интеграция с Max / Уведомления в Max из других сервисов

Уведомления в Max из других сервисов

max

Интеграция с MAX Уведомления позволяет автоматически отправлять уведомления в MAX Messenger — менеджерам, в групповой чат или лично клиентам. Работает в трёх сценариях: при регистрации, после вебинара и при оплате. Ниже — как подключить, настроить правила и какие данные можно передавать.

Подключение

  1. В Vakas-tools перейдите в Сервисы и доступы → Добавить сервис → MAX уведомления.
  2. Укажите название подключения (произвольное, для вашего удобства).
  3. Введите токен бота из настроек MAX Messenger.
  4. Нажмите «Добавить сервис».
  5. Система проверит токен и, если бот найден, покажет сообщение «Бот успешно подключен: @имя_бота».

Как получить токен бота

  1. Откройте MAX Messenger.
  2. Перейдите в раздел «Чат-боты» → «Интеграция».
  3. Создайте нового бота или выберите существующего.
  4. Скопируйте токен из настроек бота.

Токен не истекает, пока вы не отзовёте его в настройках бота MAX.

Важно: пользователь должен написать боту первым. MAX Messenger не позволяет ботам писать первыми в личные сообщения. Прежде чем бот сможет отправить личное сообщение, получатель должен написать боту хотя бы одно сообщение. Для групповых чатов достаточно добавить бота в группу.

Правила, условия, действия

Интеграция работает через связку Правило → Условие → Действие.

1 Создайте Правило

Нажмите ➕ Добавить правило. Это «папка» для ваших настроек.

  • Хотите уведомлять обо всех событиях? → Оставьте правило без условий.
  • Нужны только определённые? → Добавьте условие внутри.

2 Настройте Условия (по желанию)

Условие — это фильтр: «О каких событиях уведомлять, а какие пропускать?».

Например, вы хотите получать уведомление только когда купили VIP-тариф:

  • Условие: Название тарифасодержитVIP
  • Теперь уведомление придёт только при оплате тарифа со словом «VIP» в названии. Остальные оплаты бот пропустит.

Ещё примеры:

  • Статус платежаравноОплачено → уведомлять только об успешных оплатах
  • Был на вебинареравноНет → уведомлять о тех, кто не пришёл

3 Назначьте Действия

Нажмите Действия. Пока вы не добавите конкретное действие, система просто пропустит событие и ничего не произойдёт.

Частая ошибка: если вы выбрали «содержит», но оставили поле значения пустым — правило не выполнится. Пустое поле значения = ошибка передачи.

Настройка сообщений через Telegram уведомления

Отправить сообщение

Отправляет текстовое сообщение в один или несколько чатов MAX Messenger.

Поле Обязательное Описание
Групповые чаты Нет Выберите один или несколько чатов из списка (CTRL для мультивыбора). Список подтягивается автоматически — бот покажет все группы, в которых он состоит.
Тип ручного ввода Нет Групповой чат (chat_id) или Личное сообщение (user_id). Используется, если чат не выбран из списка.
ID получателей вручную Нет Числовой ID чата или пользователя. Несколько — через запятую. Поддерживает шорткоды.
Текст сообщения Да Текст уведомления. Поддерживает шорткоды и форматирование.
Формат текста Нет HTML, Markdown или обычный текст. По умолчанию — HTML.

Для отправки нужен хотя бы один получатель: выбранный из списка групповой чат или ID, введённый вручную. Можно указать и то, и другое — сообщение уйдёт всем.

Можно добавить несколько действий «Отправить сообщение» — каждое отправится отдельно (разным получателям, с разным текстом).

Два способа указать получателя

Способ 1 — Выбор из списка. Подходит для групповых чатов. Бот автоматически покажет все группы, в которых он состоит. Выберите нужные (CTRL для нескольких).

Способ 2 — Ручной ввод ID. Подходит для личных сообщений и случаев, когда нужен динамический ID через шорткод.

  • Выберите тип: Личное сообщение (user_id) для персональных уведомлений или Групповой чат (chat_id) для групп.
  • Введите числовой ID или шорткод.

Форматирование текста

Формат Пример
HTML <b>жирный</b>, <i>курсив</i>, <a href="url">ссылка</a>, <code>код</code>
Markdown *жирный*, _курсив_, `код`, [ссылка](url)
Обычный текст Без форматирования

Если разметка некорректна (незакрытые теги, ошибки синтаксиса) — сообщение может отобразиться некорректно. Проверяйте форматирование перед сохранением.

Как узнать user_id для личных сообщений

  1. Попросите пользователя написать боту любое сообщение.
  2. Нажмите кнопку «Получить сообщения» в настройках сервиса.
  3. В списке найдите нужного пользователя и скопируйте его user_id.

В Vakas-tools вы настраиваете MAX уведомления в одном из трёх разделов (Вкладки Регистрации/Отчеты/Оплаты) — в зависимости от того, откуда приходят данные. От этого зависит, какие шорткоды можно использовать в полях.

Раздел «Регистрации»

Сюда попадают данные, когда человек зарегистрировался — на вебинар, курс, через форму на сайте.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#vebinar_time#} Дата и время вебинара
{#vebinar_time_hi#} Время вебинара (чч:мм)
{#vebinar_time_date#} Дата вебинара
{#bizon_url#} Индивидуальная ссылка Bizon365
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} UTM-метки
{#reg_field_ИМЯ_ПОЛЯ#} Любое поле из формы регистрации

Пример — уведомить менеджера о новой регистрации:

  • Отправить сообщение
    • Тип ручного ввода: Личное сообщение (user_id)
    • ID получателей: 123456789 (user_id менеджера)
    • Текст: Новая регистрация!\nИмя: {#name#}\nEmail: {#email#}\nТелефон: {#phone#}\nUTM: {#utm_source#}
    • Формат: HTML

Раздел «Отчёты»

Сюда попадают данные после вебинара — кто был, сколько смотрел, кликал ли по кнопке.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#city#} Город
{#vizit_vebinar#} Был на вебинаре (да/нет)
{#bil_minut#} Сколько минут был на вебинаре
{#finished#} Досмотрел до конца
{#clickFile#} Кликал по кнопке
{#clickBanner#} Кликал по баннеру
{#but_text#} Текст на кнопке
{#comments#} Комментарии на вебинаре
{#webinarId#} ID вебинарной комнаты
{#view_date_data#} Дата вебинара
{#view_date_data_hi#} Время вебинара
{#view#} / {#viewTill#} Смотрел с / досмотрел до (Unix)
{#view_date#} / {#viewTill_date#} Смотрел с / досмотрел до (текст)
{#web_p1#}, {#web_p2#}, {#web_p3#} Параметры Bizon365
{#comments_tag#} Метка: писал комментарий
{#clickFile_tag#} Метка: нажал кнопку
{#clickBanner_tag#} Метка: нажал баннер
{#finished_tag#} Метка: досмотрел до конца
{#report_field_ИМЯ_ПОЛЯ#} Любое поле из отчёта

Пример — уведомить о поведении участника в групповой чат:

  • Отправить сообщение
    • Групповые чаты: выберите нужный чат из списка
    • Текст: Участник: {#name#}\nБыл {#bil_minut#} мин.\nГород: {#city#}\nКликнул кнопку: {#clickFile#}\nДосмотрел: {#finished#}
    • Формат: HTML

Раздел «Оплаты»

Сюда попадают данные, когда человек оплатил или оформил заказ.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#payment_number#} Номер заказа
{#positions#} Название тарифа/продукта
{#costMoney#} Стоимость
{#leftCostMoney#} Осталось оплатить
{#payedMoney#} Уже оплачено
{#payment_status#} Статус платежа
{#paymentLink#} Ссылка на оплату
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} UTM-метки
{#pay_field_ИМЯ_ПОЛЯ#} Любое поле из данных оплаты

Пример — уведомить об оплате в группу:

  • Отправить сообщение
    • Групповые чаты: выберите чат из списка
    • Текст: <b>Оплата!</b>\n{#name#} оплатил {#costMoney#} руб.\nТариф: {#positions#}\nСтатус: {#payment_status#}
    • Формат: HTML

Готовые примеры настройки

Регистрация → уведомление менеджеру

Раздел: Регистрации

Действие Поля
Отправить сообщение Тип: Личное сообщение (user_id), ID: 123456789, Текст: Новая заявка!\nИмя: {#name#}\nТелефон: {#phone#}\nEmail: {#email#}, Формат: HTML

После вебинара → уведомление в группу

Раздел: Отчёты

Действие Поля
Отправить сообщение Групповые чаты: выберите из списка, Текст: {#name#} был на вебинаре {#bil_minut#} мин.\nКнопка: {#clickFile#}, Досмотрел: {#finished#}, Формат: HTML

Оплата → уведомления менеджерам и в группу

Раздел: Оплаты

Действие Поля
Отправить сообщение (1) Тип: Личное сообщение (user_id), ID: 111111111,222222222 (менеджеры), Текст: Оплата от {#name#}!\n{#costMoney#} руб. — {#positions#}\nТел: {#phone#}, Формат: HTML
Отправить сообщение (2) Групповые чаты: выберите из списка, Текст: <b>+{#costMoney#} руб.</b> — {#positions#}, Формат: HTML

Неоплаченный заказ → напоминание менеджеру

Раздел: Оплаты

Условие: payment_statusсодержитОжидает оплаты (или другой статус неоплаченного заказа)

Действие Поля
Отправить сообщение Тип: Личное сообщение (user_id), ID: 123456789 (менеджер), Текст: Неоплаченный заказ!\n{#name#} — {#positions#}\nСумма: {#costMoney#} руб.\nОсталось: {#leftCostMoney#} руб.\nСсылка на оплату: {#paymentLink#}, Формат: HTML

Используйте условие в правиле, чтобы отфильтровать только неоплаченные заказы по {#payment_status#}.

Персональное уведомление клиенту (динамический user_id)

Раздел: Оплаты

Действие Поля
Отправить сообщение Тип: Личное сообщение (user_id), ID: {#max_user_id#} (шорткод из данных клиента), Текст: Здравствуйте, {#name#}! Ваш заказ #{#payment_number#} подтверждён., Формат: HTML

User ID можно передавать через шорткод, если он хранится в данных клиента (например, в CRM).

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

Как узнать user_id пользователя?
Попросите пользователя написать боту любое сообщение. Затем в настройках сервиса нажмите кнопку «Получить сообщения» — вы увидите список пользователей с их user_id.
Как узнать chat_id группы?
Нажмите кнопку «Инфо о боте» в настройках сервиса. В разделе «Групповые чаты» будут перечислены все группы с их chat_id. Бот должен быть добавлен в группу.
Сообщение не отправляется в личку
Проверьте, что получатель написал боту хотя бы одно сообщение. Бот не может писать первым в личные сообщения.
Ошибка &laquo;Unauthorized &mdash; проверьте токен бота&raquo;
Токен невалиден или был отозван. Получите актуальный токен в настройках бота MAX (раздел «Чат-боты → Интеграция»).
Часть сообщений дошла, часть нет
Система отправляет каждому получателю отдельно. Если один ID невалиден — для него будет ошибка, остальные получат сообщение. Проверьте, что все получатели доступны боту.
Ошибка &laquo;Too Many Requests&raquo;
MAX API ограничивает частоту запросов — до 30 в секунду. Если у вас массовая рассылка, система отправит сообщения с небольшой задержкой.
Как отправить в групповой чат?
Добавьте бота в нужный групповой чат. После этого чат появится в списке при настройке действия — просто выберите его. Или нажмите «Инфо о боте», скопируйте chat_id и введите вручную.
Сообщение слишком длинное
MAX Messenger ограничивает длину сообщения 4000 символами. Разделите текст на несколько действий.
Можно ли отправлять файлы?
Нет, MAX Notification поддерживает только текстовые сообщения.
Теги отображаются как текст
Проверьте, что выбран правильный формат: для <b>текст</b> нужен HTML, для *текст* — Markdown.
Какой шорткод использовать?
Нажмите {--} рядом с полем — откроется список всех доступных шорткодов для вашего типа интеграции.
×