Триггеры
Как выбрать, на что ответит бот: слово в сообщении, команду, кнопку, оплату или событие с сайта.
На этой странице
Триггер отвечает на вопрос «Что должно произойти, чтобы бот выполнил реакцию?». Например, человек написал /help, нажал кнопку или оплатил счёт.
В разделе Триггер редактора можно включить несколько вариантов. Достаточно любого из них: команда /help или слово «помощь». Это объединение называется «ИЛИ». Если ответ нужен только некоторым людям или в определённых чатах, добавьте условия.
Текстовое сообщение
Срабатывает на текст или подпись к медиа. В поле «Что искать» выбирается режим:
- Ключевые слова: список слов/фраз. Параметр «Совпадение»: содержит, точное совпадение, начинается с, регулярное выражение; плюс флажок «Учитывать регистр». Не больше 100 ключевых слов в одном триггере и 200 символов в слове (см. Лимиты платформы); для больших словарей используйте коллекции.
- Ссылка: сообщение содержит URL.
- Email: содержит адрес почты.
- Упоминание (@username): содержит упоминание.
- Любой текст: любое текстовое сообщение.
Команда
Срабатывает на slash-команды. В поле «Команды (без «/»)» перечислите имена, например help, menu. Бот откликнется на /help и /menu.
Команда /start
Ссылка https://t.me/your_bot?start=promo запускает бота с дополнительным значением promo. Его можно использовать, чтобы отличить посетителей рекламной акции от остальных. В поле «Метка в ссылке запуска» введите только promo, без адреса и без start=. Пустое поле означает «реагировать на любой /start».
Нажатие inline-кнопки (callback)
Срабатывает, когда человек нажимает кнопку под сообщением, передающую событие боту. У такой кнопки есть техническое значение callback_data, которое может отличаться от видимой надписи. Поле «Данные кнопки (callback_data)» задаёт искомое значение, а «Совпадение» способ поиска: точное, начинается с, содержит или регулярное выражение. Кнопка-ссылка лишь открывает адрес и этот триггер не запускает.
Медиа
Срабатывает на вложения выбранных типов: Фото, Видео, Видеосообщение, Документ, Аудио, Голосовое, GIF, Стикер, Кубик, Игра, Опрос, Контакт, Геолокация, Место, Альбом.
Системное событие
Срабатывает на события чата: Вступил по ссылке, Добавлен в чат, Покинул чат, Удалён из чата, Сменил статус, Заявка на вступление, Реакция на сообщение, Счётчик реакций. Полезно для приветствий, модерации и приёма заявок.
Для событий участников Telegram можно использовать {{system.subject_id}} и другие подстановки системных событий. Затронутый участник и инициатор события могут различаться: {{user_id}} относится к инициатору. Если одним сообщением добавили нескольких участников, событие обрабатывается отдельно для каждого.
Кроме событий чата есть системные события платформы:
-
Метка истекла (
label_expired): у подписчика закончился срок временной метки. В реакции доступны{{event.label_name}},{{event.label_id}}и{{event.expired_at}}.Метка снимается не сразу: пока реакция выполняется, истёкшая метка ещё числится за подписчиком, и условие «есть метка» её увидит. Снимается она только после успешной обработки события, поэтому если реакция завершилась ошибкой, метка остаётся на месте и попытка повторится.
Событие приходит без чата: оно сообщает о подписчике, а не о сообщении в чате. Действие «Отправить сообщение» доставляется подписчику в личку, а
{{chat_id}}в подстановках остаётся пустым. «Изменить права» работает, если явно указать «Чат» (chat_id), например чат закрытого клуба; без него обработка завершается ошибкой и попытка будет повторена. Остальные действия, которым нужен чат события и у которых нет собственной явной цели, для этого события не выполняются.
Ответ и пересланное
- Ответ (reply) на сообщение: срабатывает, когда сообщение является ответом на другое.
- Пересланное сообщение: срабатывает, когда пользователь пересылает сообщение из другого чата.
Каждое N-е сообщение
Срабатывает на каждое N-е сообщение пользователя (поле «Каждое сообщение №»). Подходит для периодических подсказок или антифлуда.
По расписанию (даты)
Срабатывает в указанные моменты времени (список дат). Запланированная реакция рассылается активным подписчикам по наступлении срока: см. Рассылки.
Платёж
Срабатывает, когда меняется судьба счёта, выставленного ботом. Задаются Статус платежа (Оплачен, Не удался, Возвращён), Касса и Минимальная сумма, коп. Это вторая половина сценария «оплата → доступ», подробности: в статье Платежи и баланс.
Событие клиента / сайта
Срабатывает на событие клиента или сайта с указанным именем. Платформа сама записывает событие referral.joined, когда новый подписчик приходит по ссылке ?start=ref_<user_id>. Свойства события: referrer_tg_user_id – ID пригласившего, referrals_count – текущее общее число приглашённых им подписчиков, start_payload – метка в ссылке запуска нового подписчика.
Реакция с этим триггером выполняется от лица новичка, поэтому обычное действие «Отправить сообщение» отправит сообщение новичку. {{ctx.referrer_id}} и {{event.referrer_tg_user_id}} можно использовать в полях и контенте, поддерживающих подстановки, но сами по себе они не меняют адресата. Прямого динамического получателя у действия send_message нет. {{ctx.referrer_id}} также доступен отдельно в контексте самого первого /start новичка.
Входящий веб-запрос (вебхук)
Срабатывает на HTTP-запрос извне. Включите этот триггер и сохраните реакцию: после сохранения в поле Адрес появится готовый URL вебхука. Адрес создаётся автоматически для этой реакции, его можно скопировать, но нельзя изменить. Задайте Секретный токен для защиты и Метод (POST / GET / PUT / ANY). Данные запроса попадают в контекст выполнения и доступны в действиях через {{ctx.поле}}. Подробнее: Веб-запросы и вебхуки.
Что дальше
- Условия и чаты: сузьте срабатывание по аудитории и месту.
- Действия: что бот делает в ответ.