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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Давайте целям короткие и постоянные названия. Если переименовать цель позже, история разделится надвое.

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

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

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

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

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

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

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

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

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

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

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

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