Max Bot
Узлы Max Bot позволяют использовать бота MAX в ваших сценариях на Nodul. С их помощью можно получать события из чатов, отправлять и редактировать сообщения, управлять файлами и получать информацию о чатах. Для работы нужен бот, зарегистрированный в MAX, и его токен доступа.
Только для ИП и юрлиц РФ
На данный момент создание ботов в MAX доступно только для индивидуальных предпринимателей и юридических лиц, являющихся резидентами РФ. Физические лица зарегистрировать бота не могут.
Создание бота
Боты в MAX создаются через @MasterBot. Откройте диалог с @MasterBot в приложении MAX, отправьте команду /create и следуйте инструкциям. После регистрации отправьте /get_token, чтобы получить токен доступа. Подробнее читайте в документации MAX для разработчиков.
Подключение
В подключении задаётся Max Access Token - токен доступа к API бота MAX. Создайте подключение один раз, затем выбирайте его в поле Создать авторизацию в любом узле Max Bot.
Укажите токен
Вставьте Max Access Token из @MasterBot и задайте понятное имя подключения.
Авторизуйтесь
Нажмите Авторизоваться. Подключение сохранится и появится в списке.
Общие шаги по полям Select и Map см. в Настройка узлов приложений.
Триггеры
Новое событие (Инстант)
Универсальный триггер для всех событий бота в MAX. В поле Типы событий выберите из выпадающего списка нужные события, на которые должен срабатывать триггер.
При Запустить один раз триггер ждёт следующее событие. Если за отведённое время ничего не пришло, подставляются тестовые данные, чтобы можно было продолжить настройку сценария.
| Поле | Описание |
|---|---|
| Название | Подпись узла на холсте (по умолчанию можно оставить «Без названия»). |
| Создать авторизацию | Выберите авторизацию из списка или создайте новую по примеру выше. |
| Типы событий | Мультивыбор: при каких событиях запускать сценарий. |
Полный список типов событий:
| В интерфейсе | ID |
|---|---|
| Новое сообщение | message_created |
| Сообщение изменено | message_edited |
| Сообщение удалено | message_removed |
| Обратный вызов сообщения | message_callback |
| Чат создан | chat_title_changed |
| Бот добавлен в чат | bot_added |
| Диалог размьючен (включены уведомления) | dialog_unmuted |
| Бот запущен | bot_started |
| Бот удалён из чата | bot_removed |
| Бот остановлен | bot_stopped |
| Пользователь удалён из чата | user_removed |
| Пользователь добавлен в чат | user_added |
| Диалог очищен | dialog_cleared |
| Диалог удален | dialog_removed |
| Диалог замьючен (отключены уведомления) | dialog_muted |
Действия
Как получить Chat ID
ID чата и ID пользователя можно получить из вывода триггера Новое событие (Инстант). Запустите триггер, отправьте боту любое сообщение и посмотрите данные в выводе узла: там будут идентификаторы чата и пользователя, которые можно передать через Map в следующий узел.
Обычно Chat ID лежит по пути data.message.recipient.chat_id в выводе триггера. В поле узла это будет выглядеть примерно так: {{$номер_узла.data.message.recipient.chat_id}}.