Автоматизация с MAX
Получайте события MAX, отвечайте сообщениями с кнопками и отправляйте файлы.
Что это
Узел Событие MAX запускает сценарий по сообщениям, нажатиям кнопок, комментариям и изменениям чата. Узел MAX выполняет выбранное действие бота.
Как сделать
- Подключите бота MAX в нужном окружении.
- Добавьте Событие MAX, выберите подключение и типы событий. Например, Новое сообщение и Нажата кнопка.
- При необходимости ограничьте события чатом, пользователем, командой или данными нажатой кнопки. Все заполненные фильтры должны совпасть.
- Добавьте узел MAX → Отправить сообщение. Выберите одного получателя: чат или пользователя.
- Подставьте ID получателя из панели данных события и укажите текст ответа. ID сохраняйте строками, чтобы не потерять длинное число.
- Проверьте настройки, сохраните и опубликуйте сценарий. Дождитесь подтверждения подписки MAX.
Кнопки и файлы
В поле Кнопки сообщения добавляйте строки и кнопки. Доступны нажатие, ссылка, запрос контакта, запрос геопозиции, мини-приложение, сообщение и копирование. Заполните данные выбранного типа. Кнопка «Сообщение» отправляет свой текст.
Меняйте порядок стрелками или перетаскиванием строк. Предпросмотр показывает раскладку. Режим JSON позволяет редактировать структуру; при ошибке сохраняется последняя корректная клавиатура. Допускается до 30 строк и 7 кнопок в строке; со ссылкой, мини-приложением, контактом или геопозицией — до 3.
Чтобы отправить вложение, сначала выполните Загрузить вложение из Files. Выберите бакет и готовый файл в текущем окружении. Затем подставьте полученное вложение в действие отправки сообщения. Файл, который ещё загружается или проверяется, выбрать нельзя.
Другие действия
Меню действия содержит операции для сообщений, комментариев, команд бота, файлов, закреплённых сообщений, участников и администраторов чата. Форма показывает поля выбранной операции. Для действий управления чатами боту нужны соответствующие права.
В числовые поля, включая время и количество, можно подставить данные события, например {{ payload.timestamp }}. При чтении сообщений или комментариев указывайте границы времени в миллисекундах Unix, например 1791100800000. Для сообщений также доступны параметры from (до времени) и to (после времени). Чтобы переслать сообщение без нового текста, укажите ссылку вида {"type":"forward","mid":"mid.…"}. При редактировании пустой текст или пустой список вложений явно очищает соответствующее содержимое.
Длинные сообщения нужно разделять: MAX принимает текст длиной до 4000 символов. Для нескольких сообщений используйте цикл и задержку; соблюдайте ограничение MAX на частоту отправки в один чат.
Что дальше
Отправьте настоящее сообщение боту или нажмите кнопку и откройте историю запусков. Пример payload в редакторе помогает настроить поля; он не подтверждает доставку из MAX.
При повторной доставке события новый запуск не создаётся. Agnostic автоматически задаёт ключ повторного выполнения для каждого действия в запуске и возвращает уже известный результат при повторе. Если результат доставки неизвестен, сначала проверьте чат; новый запуск может создать дубликат.
Частые проблемы
| Проблема | Что сделать |
|---|---|
| Событие не запускает сценарий | Проверьте подписку, окружение, тип события и все фильтры. |
| Ответ уходит не туда | Укажите одного получателя и возьмите ID из нужного события. |
| Кнопка не сохраняется | Заполните текст и обязательные данные её типа; проверьте лимит кнопок в строке. |
| Файл не готов | Дождитесь завершения загрузки и проверки в Files. |
| Доставка неизвестна | Проверьте чат перед повторной отправкой. |