Триггеры

Триггер — это событие, на которое откликается реакция. В разделе Триггер редактора можно включить несколько типов сразу: они объединяются по «ИЛИ» — реакция сработает, если выполнен любой из включённых триггеров. Дополнительные ограничения (метки, параметры, чаты) задаются отдельно в Условиях.

Текстовое сообщение

Срабатывает на текст или подпись к медиа. В поле «Что искать» выбирается режим:

  • Ключевые слова — список слов/фраз. Параметр «Совпадение»: содержит, точное совпадение, начинается с, регулярное выражение; плюс флажок «Учитывать регистр».
  • Ссылка — сообщение содержит URL.
  • Email — содержит адрес почты.
  • Упоминание (@username) — содержит упоминание.
  • Любой текст — любое текстовое сообщение.

Команда

Срабатывает на slash-команды. В поле «Команды (без «/»)» перечислите имена, например help, menu. Бот откликнется на /help и /menu.

Команда /start

Отдельный триггер на /start. Поле Payload ловит deep-link-параметр (/start <payload>); пустое значение — любой /start. Это основа для реферальных и кампанийных ссылок.

Нажатие inline-кнопки (callback)

Срабатывает на нажатие inline-кнопки. Поле «Данные кнопки (callback_data)» и «Совпадение» (точное, начинается с, содержит, регулярное выражение) определяют, какие кнопки ловить.

Медиа

Срабатывает на вложения выбранных типов: Фото, Видео, Видеосообщение, Документ, Аудио, Голосовое, GIF, Стикер, Кубик, Игра, Опрос, Контакт, Геолокация, Место, Альбом.

Системное событие

Срабатывает на события чата: Вступил по ссылке, Добавлен в чат, Покинул чат, Удалён из чата, Сменил статус, Заявка на вступление, Реакция на сообщение, Счётчик реакций. Полезно для приветствий, модерации и приёма заявок.

Ответ и пересланное

  • Ответ (reply) на сообщение — срабатывает, когда сообщение является ответом на другое.
  • Пересланное сообщение — срабатывает на форварды.

Каждое N-е сообщение

Срабатывает на каждое N-е сообщение пользователя (поле «Каждое сообщение №»). Подходит для периодических подсказок или антифлуда.

По расписанию (даты)

Срабатывает в указанные моменты времени (список дат). Запланированная реакция рассылается активным подписчикам по наступлении срока — см. Рассылки.

Входящий веб-запрос (вебхук)

Срабатывает на HTTP-запрос извне. Задаются Путь (полный URL формируется из адреса бота и пути), Секретный токен (для защиты) и Метод (POST / GET / PUT / ANY). Данные запроса попадают в контекст выполнения и доступны в действиях через {{ctx.поле}}. Подробнее — Веб-запросы и вебхуки.

Что дальше