Триггеры: как запускается ваш бот

Триггер — это событие, которое запускает сценарий: команда, сообщение, переход по ссылке. Блок — один шаг сценария на холсте.

Откройте любой сценарий: первый блок на холсте — Стартовый шаг. Это единственный блок, который нельзя удалить. Сценарий без входа не запустится никогда.

Блок — это список входов. В нём видна строка вида Триггеры: /start, /help, Диплинк: promo-…, кнопка Добавить триггер и раздел Когда... — другие сценарии, которые ведут сюда, у каждого есть кнопка Открыть.

Нажмите на блок — слева откроется редактор. Каждый триггер живёт в своей карточке: Триггер 1, Триггер 2. Сверху — поле Тип, снизу — переключатель Активен. Триггеров может быть сколько угодно, и выключение одного не трогает остальные.

Команда — самый частый тип. Слэш уже стоит перед полем, поэтому в поле Команда вы пишете help, а не /help.

Регистр не важен: /Help и /help — один и тот же триггер. Используйте строчные латинские буквы, цифры и подчёркивание, до 32 символов. Так требует Telegram, и от этого же зависит, попадёт ли команда в меню бота.

Ниже команды — поле Источник Telegram: Личные сообщения, Группа, Канал. Оставьте личные сообщения, пока бот не работает в группе. Если добавить Группу, появится поле Охват сообщений в группе с двумя вариантами — Упоминания, ответы и команды или Все сообщения группы. Чтобы ловить все сообщения, нужно ещё отключить боту Group Privacy в @BotFather (меню BotFather на английском):

1. Откройте в Telegram @BotFather и отправьте /mybots.
2. Выберите бота, затем Bot Settings → Group Privacy → Turn off.
3. Если бот всё ещё видит только упоминания, удалите его из группы и добавьте снова.

Эти же шаги редактор показывает под полем.

Выберите Сообщение — появится Фильтр сообщения (необязательно). Оставьте поле пустым, и сценарий запустится на любое сообщение. Заполните — и сценарий запустится только при точном совпадении текста. Это и есть вход по ключевому слову: меню поймает меню и ничего больше.

У триггеров сообщения и команды есть блок Сохранить в переменные (необязательно). Он раскладывает то, что триггер уже знает — Текст сообщения, Команда — по переменным контакта. Первое, что человек написал, сохраняется ещё до вашего первого ответа.

Кнопке триггер не нужен вовсе. Внутри одного сценария кнопка просто соединяется со следующим блоком на холсте. Если следующий шаг живёт в другом сценарии, поставьте блок Переход к сценарию и укажите нужный сценарий.

Поэтому у Стартового шага есть раздел Когда...: в нём перечислены все сценарии, чей «Переход к сценарию» ведёт сюда, и кнопка Открыть рядом с каждым. На стороне триггера ничего настраивать не нужно — этот список просто показывает изнутри, кто ещё умеет запускать этот сценарий.

Диплинк — ссылка, которая открывает чат с ботом и сразу передаёт ему метку. Выглядит он так: t.me/yourbot?start=КОД. Человек нажимает ссылку, открывается чат, и бот сразу получает код. Один бот по-разному встречает гостя из рекламы, аудиторию партнёра и того, кто отсканировал QR-код с листовки.

Выберите Диплинк / параметр запуска и ответьте на вопрос Какие ссылки запускают этот триггер?:

• Любой параметр — всё, что идёт после ?start=
• Начинается с… — Префикс, например promo-
• Точное совпадение… — один конкретный код

В поле Ваша ссылка уже собрана готовая ссылка и стоит кнопка Копировать — вручную ничего склеивать не нужно. То, что идёт после префикса, приходит как Параметр запуска: сопоставьте его с переменной контакта в блоке Сохранить в переменные (необязательно) — и используйте {{promo_code}} в сообщениях. Переменные вставляются в текст плашками через окно выбора переменных, скобки вручную не набирают.

Реферальная ссылка — тот же механизм, только настроенный заранее: он ловит ссылки, начинающиеся с ref--, и вдобавок определяет, кто пригласил человека.

Новый участник чата запускает сценарий, когда кто-то вступает в группу с ботом. Обычно там живёт приветствие группы или капча.

Установленные модули добавляют свои пункты в тот же список Тип — в группу Установленные модули. Например, модуль Telegram приносит триггер на изменение участника и триггер на пост в канале. Набор зависит от того, что вы установили, — подробнее в статье Модули: Таблицы, AI, платежи и другие сервисы.

Нажмите Опубликовать — и, когда бот запущен, FlowCastle читает текущее меню команд из Telegram, добавляет в него ваши команды-триггеры и записывает обратно. Никому не нужно вызывать /setcommands в BotFather.

Четыре важных момента:

• Слияние только добавляет. Команды, которые вы задали сами в BotFather, остаются; совпавшая по имени команда заменяется вашей; ничего не удаляется — даже команда удалённого сценария.
• Подпись рядом с командой — это название сценария. Называйте сценарии так, как хотите видеть меню.
• Команды, которые Telegram не примет (заглавные буквы, пробелы, больше 32 символов), в меню не попадут. Сам триггер при этом работает.
• Если синхронизация не удалась, публикация всё равно проходит. Меню — это витрина, отвечает боту триггер.

Если один и тот же /start могут обработать несколько сценариев, побеждает самое точное совпадение:

1. диплинк с точным кодом
2. диплинк с префиксом
3. диплинк с любым параметром запуска
4. обычная команда /start

Значит, ссылка с promo- запустит сценарий кампании, а голый /start — приветствие. Думать о порядке сценариев не нужно.

Осторожность нужна в одном случае — при ничьей. Если два сценария ловят один и тот же /start или одну и ту же свою команду, победит один, а второй не запустится никогда — молча, без предупреждения в редакторе. Держите одну команду на один сценарий, а если двум путям нужен общий вход, используйте блок «Переход к сценарию».

Бот запускается. Теперь научите его слушать и запоминать ответы: Как задать вопрос и сохранить ответ.