Гайд
- 1
Когда это нужно
Обычно бот отвечает тому, кто ему пишет. Но иногда нужно сообщить что-то ещё и кому-то другому.
Вот три ситуации, которые встречаются чаще всего:
- Кто-то что-то отправил, и это должен увидеть человек. Заказ, адрес кошелька, заявка, обращение в поддержку. Никто не следит за чатом бота — нужно, чтобы это попало во входящие вашей команды.
- Нужна копия. Каждая заполненная форма, каждый платёж, каждая ошибка — в лог-канал или внутреннюю группу, чтобы осталась запись.
- Админ должен подтвердить или отклонить. Заявка ждёт, пока кто-то не нажмёт кнопку, и нажатие должно что-то запускать.
У FlowCastle есть четыре механизма для этого, и они не взаимозаменяемы:
- Сервисное уведомление — одностороннее уведомление вашей команде. Самый простой вариант, работает из любого канала, ничего не нужно настраивать.
- Уведомить по тегу — сообщение от вашего бота каждому контакту с тегом, например
admin. Может включать отправленные данные. Без кнопок. - Куда отправить — одно сообщение из сценария, доставленное в чат, который вы укажете, вместо текущего. Кнопки допускаются.
- По аудитории — целый сценарий, который выполняется для других контактов, отобранных фильтром, вместе с дальнейшими шагами.
Ни для одного из них не нужен второй бот и не нужно действие с собственным кодом, которое вызывает Telegram API с токеном другого бота. Если вы тянетесь к этому — вы идёте не туда.
- 2
Сервисное уведомление — самый простой способ
Это встроенное действие, и оно закрывает большинство случаев. Добавьте узел «Действие», добавьте Сервисное уведомление — и всё готово. В меню добавления действия оно описано так: Уведомить вашу команду через сервисный бот и email — работает из любого канала.
В редакторе одно поле — Сообщение — с плейсхолдером Текст для вашей команды…. Под ним:
Уведомление придёт вашей команде через сервисный Telegram-бот и email — получателям не нужно быть подписчиками этого бота. Каждый участник управляет переключателем «Сервисные уведомления» в настройках уведомлений приложения.
Кто получает. Участники команды вашего приложения — те, у кого есть доступ к рабочему пространству, — у кого включён переключатель «Сервисные уведомления» в настройках уведомлений. По умолчанию он включён. Никто за пределами рабочего пространства уведомление не получит.
Как приходит. Через собственный сервисный Telegram-бот FlowCastle и по email, а также веб-пуш, если он включён. Поэтому это работает из любого канала: веб-чата, почты, MTProto-аккаунта или операции, которая выполняется вообще без контакта. Ваш бот в доставке не участвует, поэтому получателю не нужно было его запускать.
Переменные работают. Текст — обычный шаблон, поэтому
Новый заказ от {{sysvar|firstName}}или любая ссылка{{var|…}}разрешится перед отправкой. Текст рендерится один раз, в контексте контакта, который запустил сценарий.Одинаковые сообщения объединяются. Если один и тот же текст отправляется дважды в течение 60 секунд, доставится только первый. Персонализируйте сообщение — добавьте в него имя, номер заказа или сумму — и дойдёт каждое.
Где его возможности заканчиваются:
- Уведомление доходит только до участников вашей команды. Направить его в произвольный чат, канал или человеку нельзя.
- Без кнопок. Только текст.
- Одностороннее. В сценарий ничего не возвращается. Ответ в сервисном боте до вашего бота не доходит.
- 3
Уведомить по тегу — оповещайте админов через своего бота
Если те, кого нужно оповестить, — контакты этого бота (они хотя бы раз его запускали), следующий по простоте вариант — действие Уведомить по тегу. В меню добавления действия оно описано так: Отправить сообщение всем контактам с тегом (например, админам).
Дайте админам тег (например,
admin) в разделе «Контакты». Добавьте действие, выберите тег, напишите сообщение. Когда сценарий доходит до этого шага, бот отправляет текст каждому контакту с этим тегом.Два отличия от «Сервисного уведомления»:
- Сообщение идёт через вашего бота — админы видят его в том же чате, где обычно пользуются ботом, и для этого они должны быть его контактами. Участники команды, которые ни разу не запускали бота, ничего не получат.
- Отправленные данные сразу в тексте. Текст рендерится один раз, в контексте контакта, который запустил сценарий, поэтому
Новый PU Prime UID от {{sysvar|firstName}}: {{var|…}}покажет значения клиента, а не админа.
Где заканчиваются возможности: только текст, без кнопок, и в сценарий ничего не возвращается. Если контакт заблокировал бота, отправка ему не удастся, а остальным сообщения всё равно уйдут.
- 4
Отправить одно сообщение в конкретный чат
Откройте любой блок сообщения и прокрутите до раздела Куда отправить. Он определяет, куда уйдёт именно это сообщение:
- В чат, откуда пришло сообщение (по умолчанию)
- Видно только отправителю (в группах)
- Ответом на входящее сообщение
- В личку отправителю
- Себе в «Избранное» — только для MTProto-аккаунтов (юзерботов)
- В другой чат — с полем @username или ID чата
Здесь нужен вариант «В другой чат». Подсказка говорит об этом прямо:
Для обычного бота: бот должен состоять в этом чате (или человек должен был запустить бота).
То есть: добавьте бота в лог-канал или внутреннюю группу, затем вставьте
@usernameили числовой ID чата. Поле принимает переменные, так что адресат может браться из переменной, а не быть зашитым в текст.Весь раздел «Куда отправить» появляется только когда в приложении есть Telegram-бот. Без него маршрутизировать некуда.
Кнопки тоже работают. Добавьте к сообщению кнопки «Подтвердить» / «Отклонить» и отправьте его в чат админа. Когда админ нажмёт одну из них, сценарий продолжится с целевого блока этой кнопки — от имени админа, в его чате и его сессии, а не от имени того, кто вызвал отправку. Для согласования это ровно то, что нужно: следующие блоки (подтверждение, тег, изменение переменной) выполняются для админа. Когда сообщение с кнопками направлено в другой чат, редактор показывает подсказку под «Куда отправить», чтобы вы не забыли, чья сессия продолжается.
Что это значит на практике:
- Чтобы подтвердить или отклонить кого-то, сценарий должен знать, кого. Продолжение после кнопки выполняется в контексте админа, поэтому данных отправителя там по умолчанию нет — заранее скопируйте нужное (его Telegram ID, отправленное значение) в переменную уровня приложения.
- Чат должен быть доступен боту: группа или канал, где бот состоит, либо человек, который его запустил.
Итого «Куда отправить» закрывает одно сообщение в место, которое вы можете назвать, — лог-канал, внутренняя группа, личный чат одного админа, — с кнопками или без. Когда получатели — это «все с тегом
admin», а не один ID чата, или когда для них нужно выполнить несколько шагов, читайте следующий раздел.Настройки доставки зашиваются в бота при публикации. Измените их и опубликуйте бота заново, прежде чем ждать нового поведения.
- 5
Несколько шагов или кнопки: сценарии по аудитории
Когда получатель — не один чат, который можно назвать, а набор контактов (все админы, все модераторы региона, все контакты с тегом) или когда для каждого из них нужно выполнить несколько шагов, сценарий должен реально выполниться для этих людей. Для этого нужен режим «По аудитории».
Это переключатель на панели редактора сценария. Включите его — и сценарий перестаёт быть привязан к контакту, который сейчас общается с ботом:
Сценарии по аудитории могут выполняться для любого набора контактов, который подходит под фильтр получателей, а не только для контакта, который сейчас взаимодействует с ботом. Это режим Автоматизации и он не создаёт рассылку в разделе Рассылки.
Рядом с переключателем — кнопка «Настроить фильтр получателей», которая открывает панель «Получатели». Под заголовком «Фильтр» написано: Отправлять рассылку только контактам, которые соответствуют этим условиям. Условия собираются так же, как в узле «Условие», а в подвале панели — счётчик, сколько контактов подходит прямо сейчас.
Условия могут опираться на:
- Переменные контакта — всё, что вы сохраняете на контакте.
- Данные контакта —
platformId,username,email,phone,firstName,lastNameиtags. - Цели — достигнута / не достигнута, когда-либо или за период.
Чтобы найти ровно одного админа, есть два надёжных способа:
{{sysvar|platformId}}Равно его числовому Telegram user ID, или{{sysvar|tags}}Содержит тег, который вы дали только ему. В любом случае админ должен быть контактом бота — он должен был хотя бы раз его запустить, иначе строки контакта нет и фильтр никого не находит.Как это сделать
- Создайте второй сценарий. Назовите его, например, «Уведомить админа».
- Включите «По аудитории» и настройте фильтр получателей так, чтобы он находил только этого админа. Не давайте этому сценарию собственный триггер — в него попадают из другого места.
- Внутри разместите сообщение с кнопками «Подтвердить» / «Отклонить» и всё, что должно происходить после их нажатия.
- В основном сценарии добавьте узел «Переход к сценарию». В поле «Целевой сценарий» укажите «Уведомить админа». Подсказка к нему: Переводит контакт сразу в другой сценарий — как телепортация в другую часть бота.
Что происходит при выполнении
Когда основной сценарий доходит до перехода, FlowCastle применяет фильтр получателей и запускает сценарий уведомления по одному разу на каждый найденный контакт, в его собственном контексте — с его чатом, его сессией, его переменными.
Так сообщение с кнопками доставляется админу тем же ботом, а когда админ нажимает «Подтвердить», нажатие продолжает работу внутри сессии админа, и дальше сценарий уведомления выполняется уже там. Ни второго бота, ни вебхука, ни собственного кода.
Контакт, который всё это запустил, идёт вместе как исходный контакт. Фильтр получателей может читать его переменные через токен
{{sourceVar|<variable-id>}}— так строится фильтр вроде «найти контакта, чей Telegram id равен id, который сценарий только что записал». Пикера для этого токена в редакторе нет — его вписывают в поле значения условия вручную, и работает он только в фильтре получателей, а не в тексте сообщения самого сценария уведомления. Чтобы отправленные данные попали в сообщение админу, запишите их в переменную уровня приложения в основном сценарии и читайте её оттуда. - 6
Какой вариант выбрать?
Сервисное уведомление Уведомить по тегу Куда отправить → В другой чат По аудитории Кто получает Участники команды вашего рабочего пространства Каждый контакт бота с этим тегом Один чат, который вы укажете: группа, канал или человек, запустивший бота Любые контакты, подходящие под фильтр получателей Показывает данные отправителя? Да Да Да, в сообщении; после нажатия кнопки — нет Только то, что вы скопировали в переменную приложения Кнопки? Нет Нет Да — нажатие продолжает сценарий от имени контакта чата-получателя Да Несколько шагов? Нет, одно уведомление Нет, одно сообщение Одно сообщение; кнопки могут продолжить сценарий Да, целый сценарий Получатель должен быть контактом бота? Нет Да Только для личного чата; для группы или канала — нет Да Нужен второй бот? Нет Нет Нет Нет Простое правило: уведомить себя или команду → Сервисное уведомление. Уведомить админов, которые пользуются ботом, вместе с деталями → Уведомить по тегу. Одно сообщение в чат, который вы можете назвать, с кнопками или без → Куда отправить. Много получателей по фильтру или несколько шагов для каждого → По аудитории.
- 7
Что дальше
Все эти способы работают через узлы, которые вы добавляете на холст, — а вот весь остальной список того, что бот умеет делать между сообщениями: Узел «Действие»: всё, что умеет ваш бот