Перейти к содержанию

Автоматизация с MAX

Получайте события MAX, отвечайте сообщениями с кнопками и отправляйте файлы.

Что это

Узел Событие MAX запускает сценарий по сообщениям, нажатиям кнопок, комментариям и изменениям чата. Узел MAX выполняет выбранное действие бота.

Как сделать

  1. Подключите бота MAX в нужном окружении.
  2. Добавьте Событие MAX, выберите подключение и типы событий. Например, Новое сообщение и Нажата кнопка.
  3. При необходимости ограничьте события чатом, пользователем, командой или данными нажатой кнопки. Все заполненные фильтры должны совпасть.
  4. Добавьте узел MAX → Отправить сообщение. Выберите одного получателя: чат или пользователя.
  5. Подставьте ID получателя из панели данных события и укажите текст ответа. ID сохраняйте строками, чтобы не потерять длинное число.
  6. Проверьте настройки, сохраните и опубликуйте сценарий. Дождитесь подтверждения подписки MAX.

Кнопки и файлы

В поле Кнопки сообщения добавляйте строки и кнопки. Доступны нажатие, ссылка, запрос контакта, запрос геопозиции, мини-приложение, сообщение и копирование. Заполните данные выбранного типа. Кнопка «Сообщение» отправляет свой текст.

Меняйте порядок стрелками или перетаскиванием строк. Предпросмотр показывает раскладку. Режим JSON позволяет редактировать структуру; при ошибке сохраняется последняя корректная клавиатура. Допускается до 30 строк и 7 кнопок в строке; со ссылкой, мини-приложением, контактом или геопозицией — до 3.

Чтобы отправить вложение, сначала выполните Загрузить вложение из Files. Выберите бакет и готовый файл в текущем окружении. Затем подставьте полученное вложение в действие отправки сообщения. Файл, который ещё загружается или проверяется, выбрать нельзя.

Другие действия

Меню действия содержит операции для сообщений, комментариев, команд бота, файлов, закреплённых сообщений, участников и администраторов чата. Форма показывает поля выбранной операции. Для действий управления чатами боту нужны соответствующие права.

В числовые поля, включая время и количество, можно подставить данные события, например {{ payload.timestamp }}. При чтении сообщений или комментариев указывайте границы времени в миллисекундах Unix, например 1791100800000. Для сообщений также доступны параметры from (до времени) и to (после времени). Чтобы переслать сообщение без нового текста, укажите ссылку вида {"type":"forward","mid":"mid.…"}. При редактировании пустой текст или пустой список вложений явно очищает соответствующее содержимое.

Длинные сообщения нужно разделять: MAX принимает текст длиной до 4000 символов. Для нескольких сообщений используйте цикл и задержку; соблюдайте ограничение MAX на частоту отправки в один чат.

Что дальше

Отправьте настоящее сообщение боту или нажмите кнопку и откройте историю запусков. Пример payload в редакторе помогает настроить поля; он не подтверждает доставку из MAX.

При повторной доставке события новый запуск не создаётся. Agnostic автоматически задаёт ключ повторного выполнения для каждого действия в запуске и возвращает уже известный результат при повторе. Если результат доставки неизвестен, сначала проверьте чат; новый запуск может создать дубликат.

Частые проблемы

ПроблемаЧто сделать
Событие не запускает сценарийПроверьте подписку, окружение, тип события и все фильтры.
Ответ уходит не тудаУкажите одного получателя и возьмите ID из нужного события.
Кнопка не сохраняетсяЗаполните текст и обязательные данные её типа; проверьте лимит кнопок в строке.
Файл не готовДождитесь завершения загрузки и проверки в Files.
Доставка неизвестнаПроверьте чат перед повторной отправкой.

Связанные статьи