Нода-триггер
Что такое нода-триггер
Нода-триггер — это нода, которая запускается автоматически при наступлении определённого события в канале или группе, а не по команде пользователя.
Примеры использования:
- Приветствовать новых участников канала или группы.
- Реагировать на определённые сообщения или слова в группе.
- Обрабатывать реакции на публикации.
- Отправлять уведомление при редактировании сообщения.
Добавление триггера
- На холсте нажмите флажок для добавления триггера.
- В настройках ноды выберите тип события.
- Укажите источник — конкретный канал или группу (или «любой»).
- Добавьте блоки, которые бот должен выполнить при срабатывании.
- Опубликуйте сценарий.
Типы событий
| Событие | Описание |
|---|---|
| Новый участник | Пользователь вступил в группу или канал |
| Выход участника | Пользователь покинул группу |
| Новое сообщение | Отправлено новое сообщение в группу |
| Редактирование сообщения | Сообщение было отредактировано |
| Новый пост в канале | Опубликован пост в канале |
| Редактирование поста | Пост в канале отредактирован |
| Реакция на сообщение | Пользователь поставил реакцию |
| Отзыв реакции | Реакция убрана |
| Закреплено сообщение | Сообщение закреплено в группе |
| Создан опрос | В группу добавлен Telegram-опрос |
| Повышение/понижение участника | Изменился статус участника (admin/member) |
Переменные payload
При срабатывании триггера в переменные автоматически записывается информация о событии. Набор переменных зависит от типа события.
Для события «Новый участник»:
| Переменная | Значение |
|---|---|
{{payload.user_id}} |
ID нового участника |
{{payload.username}} |
Username (если есть) |
{{payload.first_name}} |
Имя |
{{payload.chat_id}} |
ID группы/канала |
Для события «Новое сообщение»:
| Переменная | Значение |
|---|---|
{{payload.text}} |
Текст сообщения |
{{payload.from_id}} |
ID отправителя |
{{payload.from_username}} |
Username отправителя |
{{payload.message_id}} |
ID сообщения |
Полный список переменных для каждого типа события отображается прямо в редакторе триггера.
Статистика срабатываний
На карточке ноды-триггера на холсте отображается счётчик — сколько раз триггер уже сработал. Это помогает отслеживать активность и находить популярные события.
Советы
- Используйте блок «Условие» после триггера, чтобы фильтровать события (например, реагировать только на сообщения с определённым словом).
- Для приветствия новых участников добавляйте небольшую задержку в несколько секунд — это выглядит естественнее.
- Убедитесь, что бот является администратором группы/канала — без прав администратора события не поступают.
- Для чтения сообщений в группах у бота должен быть отключен приватный режим через @BotFather > Ваш бот > Bot Settings > Group privacy > Turn off