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

Гайд

1. 1

   Стартовый шаг — начало любого сценария

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

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

   

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

   

2. 2

   Слэш-команды: /start и ваши собственные

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

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

   

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

3. 3

   Любое сообщение или одна точная фраза

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

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

4. 4

   Кнопкам из другого сценария триггер не нужен

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

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

5. 5

   Диплинки: своя ссылка для каждой кампании

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

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

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

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

   

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

6. 6

   События: новые участники и модули

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

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

7. 7

   Публикация обновляет меню команд

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

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

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

   Когда подходят сразу два триггера

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

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

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

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

9. 9

   Что дальше

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