Блок «Действие»: всё, что умеет ваш бот

Блок «Сообщение» говорит, блок «Действие» — работает. Встроенные действия, которые можно добавить в сценарий, и зачем нужно каждое.

8 минут чтения·Обновлено: 2026-11-19

01Что делает блок «Действие»

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

Несколько действий всё же что-то отправляют, и это стоит знать. Уведомить по тегу пишет другим людям, Сервисное уведомление присылает сообщение вашей команде, Эмодзи-капча показывает пользователю задачку, Открыть Mini App присылает кнопку, а Запустить рассылку (только в операциях) отправляет рассылку многим людям. Остальные работают тихо, в фоне.

На холсте у блока два выхода: Далее и Неудача. Если действие не удалось — другой сервис не ответил, в коде ошибка, — сценарий может пойти по ветке Неудача, а не остановиться. Исключение — быстрая проверка, которая стоит в блоке одна: см. «Быстрые проверки» ниже.

Два блока «Действие» на холсте FlowCastle между приветствием и подтверждением

02Как добавить его на холст

  1. Нажмите круглую кнопку + в правом нижнем углу холста. Откроется меню Добавить со всеми видами блоков.
  2. Выберите Действие.

Можно и иначе: потяните связь от существующего блока и отпустите на пустом месте. Откроется то же меню, а новый блок сразу окажется соединённым.

Меню «Добавить» на холсте, среди видов блоков — «Действие»

03Несколько действий в одном блоке

Нажмите на блок — слева откроется редактор. Задайте Название блока — по нему вы узнаете блок на холсте. Затем наполните блок кнопкой Добавить действие. В заголовке панели видно количество: Действия (3) на скриншоте ниже.

Действия выполняются сверху вниз, одно за другим. Карандаш открывает действие на редактирование, корзина удаляет. Держите одну задачу на блок: «Сохранить ответ» и «Тег и уведомление» читаются на холсте куда лучше, чем один блок «Разное».

Редактор блока «Действие»: три действия в порядке выполнения

04Быстрые проверки: один вопрос «да или нет», два выхода

Некоторые действия задают один вопрос «да или нет» и ничего не меняют. Если поставить такое действие в блок одно, у блока появятся его собственные выходы. Блок «Условие» после него не нужен.

ДействиеВыходы
Telegram, Проверить участникаУчастник / НЕ участник
Telegram, Проверить буст каналаЕсть буст / Нет буста
Gmail, Найти и получить письмоНайдено / Не найдено
TomoAds, Получить рекламное сообщение (ручное размещение)Есть реклама / Нет рекламы
Проверить подпискуЕсть доступ / Нет доступа
Эмодзи-капчаПройдена / Не пройдена

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

Если от выхода нет связи, сценарий на этом просто заканчивается.

Если сама проверка не получилась (например, бот не админ канала), сценарий не пойдёт по выходу «НЕ…». Он пойдёт в запасной сценарий блока, а если его нет — в запасной сценарий приложения. Если нет ни того, ни другого, бот напишет человеку: «Не удалось проверить. Попробуйте позже.»

Новые блоки «Действие» создаются именно такими. Чтобы поставить в блок несколько действий, откройте Дополнительные параметры и включите Несколько действий. Выходы снова станут Далее и Неудача, а связи останутся на месте: первый выход станет «Далее», второй — «Неудача». Если добавить второе действие в блок с быстрой проверкой, редактор сначала спросит (Использовать несколько действий?). Чтобы вернуться к одному действию, сначала удалите лишние.

Блоки, которые вы собрали раньше, не меняются. У них по-прежнему Далее и Неудача.

05Меню действий

Кнопка Добавить действие открывает список действий. Создать новое — встроенные действия, они описаны ниже. Модули — действия установленных модулей. Сохранённые действия появляются, когда вы сохраните действие для повторного использования. Поиск сверху ищет сразу во всех трёх группах.

Меню «Добавить действие»: встроенный список, группа «Модули» и кнопка «Смотреть ещё»

06«Установить переменную» и «Прочитать переменные»

Переменная — это ячейка памяти бота с именем, например city.

Установить переменную записывает в неё значение: готовое, текст с плашками переменных из окна выбора переменных или результат предыдущего действия. Для чисел появляется поле Операция: можно увеличить или уменьшить счётчик, а не перезаписывать значение.

Прочитать переменные работает наоборот: достаёт значения переменных, чтобы следующие блоки могли их подставить. Читать можно и переменные другого контакта, не только текущего.

Действие «Установить переменную» в редакторе: переменная и значение

07«Задержка»

Задержка останавливает сценарий на заданный срок (секунды, минуты, часы) или до конкретной даты и времени. Короткая пауза между двумя сообщениями делает бота живее — человек успевает прочитать первое.

Для пауз длиннее нескольких минут лучше подходит цепочка, о ней ниже.

08«Внешний запрос», «API с резервом», Custom Code и AI Action

Внешний запрос берёт данные из другого сервиса через интернет. Технически это HTTP-запрос к API сервиса — адресу, через который с ним общаются программы. В действии задаются метод, адрес (URL), заголовки и тело запроса. Ответ попадает в результаты действия, и его можно подставить в следующее сообщение. Адрес должен начинаться с http:// или https:// и вести на публичный сервер. Частные и внутренние адреса не принимаются — ни в тесте в редакторе, ни в работающих ботах.

API с резервом делает то же самое, но с несколькими взаимозаменяемыми сервисами: опрашивает их по очереди, пока один не ответит, с повторами и кэшем.

Custom Code запускает ваш код на TypeScript, когда обычного запроса мало. AI Action отправляет модели один запрос и сохраняет ответ — это одно обращение, а не диалог. Названия этих двух действий в интерфейсе пока на английском. Для диалога есть отдельный блок: Блок «AI чат-агент»: ответы из вашей базы знаний.

Эти действия бывают долгими. Откройте в блоке Дополнительные параметры и включите Выполнять этот Action-блок в фоне. Сценарий приостановится перед блоком, долгая работа пойдёт в фоне, а потом сценарий продолжится. Переключатель доступен, только если в блоке есть AI, HTTP-запрос или Custom Code.

09Теги, уведомления и «Живой чат»

Добавить тег и Удалить тег помечают текущий контакт. Теги — основной способ делить людей на группы для рассылок и условий.

Уведомить по тегу отправляет сообщение всем контактам с этим тегом — так обычно зовут админов. Сервисное уведомление пишет вашей команде в Telegram и на почту и работает из любого канала. Начать диалог передаёт разговор человеку: открывает переписку в разделе Живой чат и назначает её команде или оператору. Бот отвечает, пока кто-то из команды не напишет; чтобы он замолкал сразу при передаче, включите Бот замолкает сразу (как это работает).

10Цепочки: подписать и отписать

Подписать на цепочку добавляет контакт в цепочку напоминаний по таймеру. Шаги идут в фоне, поэтому сценарий продолжается сразу, а не ждёт.

Отписать от цепочки убирает контакт и отменяет оставшиеся шаги. Ставьте это действие на ветку, где человек уже сделал то, о чём вы напоминали, — иначе напоминания продолжат приходить.

11«Установить язык»

Установить язык выбирает, на каком языке бот говорит с этим контактом, — из языков вашего приложения. Подробнее — в статье Мультиязычные боты: один бот, много языков.

12«Записать событие»

Записать событие отмечает, что текущий контакт дошёл до важного момента: начал, заполнил анкету, попросил человека, оплатил. Это видно в разделе Аналитика → События — там и понятно, доходят ли люди до конца сценария, над которым вы просидели полдня.

Давайте событиям короткие и постоянные названия, например qualification_completed. Если переименовать событие позже, история разделится надвое. Включите «Только в первый раз для контакта» для момента, который бывает один раз, например для первой покупки. Для момента, который может повториться, например «попросил человека», оставьте выключенным.

Из событий складываются и этапы лидов. На странице Лиды события, которые люди проходят в одном порядке, становятся этапами, а одно из них можно сделать успехом. Этапом не обязано быть каждое событие: их выбирают в «Настройке этапов». Подробнее — в статье Лиды: чей ход с каждым клиентом.

13Заказы

Создать заказ создаёт заказ для текущего контакта с суммой и валютой. Обновить заказ меняет статус существующего, Удалить заказ удаляет заказ по его номеру (id).

Это учётная половина покупки: она фиксирует, что заказали. Сами деньги принимает блок «Приём оплаты» — это отдельный вид блока в меню Добавить. Про него есть статья Приём оплаты в Telegram: Stars и платёжные провайдеры.

Создать заказ в магазине, Подготовить оплату и Подтвердить оплату магазина нужны для оформления заказа в Mini App магазина. Они работают только в сценариях, которые запускает этот Mini App, так что без магазина их можно не трогать.

14«Открыть Mini App» и «Эмодзи-капча»

Открыть Mini App присылает кнопку, которая открывает мини-приложение внутри Telegram: можно отдать задачу веб-странице и вернуться с результатом.

Эмодзи-капча показывает сетку «нажмите нужный эмодзи» и пропускает дальше только тех, кто прошёл проверку. Это стандартный способ не пускать спам-ботов в группу.

15Только в операциях

Операции — это сценарии, которые запускаются по расписанию, без человека в чате. Два действия есть только там:

  • Запустить рассылку создаёт и отправляет рассылку. Сообщением служит сценарий-рассылка, а его собственная аудитория — исходный список получателей. Фильтр, который вы добавляете здесь, только сужает этот список.
  • Защита операции останавливает операцию, если условие не выполняется. Это проверка на всякий случай перед отправкой.

16Действия из установленных модулей

Всё перечисленное встроено в платформу. Установленный модуль добавляет свои действия в это же меню — они собраны в группе Модули по модулям. Например, Google Таблицы добавляют Добавить строку, Обновить строку и Удалить строку. Внутри блока они ведут себя как обычные действия.

Кнопка Смотреть ещё внизу меню открывает маркетплейс модулей, не выходя из редактора. Как их устанавливать и настраивать — в статье Модули: Таблицы, AI, платежи и другие сервисы.

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

17Что дальше

Большая часть действий, которые вам в итоге понадобятся, приходит из модулей — с них и продолжим.

Модули: Таблицы, AI, платежи и другие сервисы

Похожие гайды

Ещё гайды, чтобы продолжить с этой темы.

Попробуйте в своём боте

Соберите это на бесплатном тарифе, пока шаги свежи в памяти. Карта не нужна.

Создать бота бесплатно