Гайд
- 1
Что делает узел «Действие»
Узел «Сообщение» говорит с человеком. Узел «Действие» делает работу за кадром: сохраняет ответ, вызывает API, ставит тег, ждёт, запускает напоминания. Чаще всего в чате при этом не появляется ничего — сценарий просто идёт к следующему узлу.
Несколько действий всё же что-то отправляют, и это стоит знать. «Уведомить по тегу» пишет другим людям, «Сервисное уведомление» дёргает вашу команду, «Эмодзи-капча» показывает пользователю задачку, «Открыть Mini App» присылает кнопку. Остальные молчат.
На холсте у узла два выхода: «Далее» и «Неудача». Если действие не удалось — API недоступен, код упал, — сценарий может пойти по ветке «Неудача», а не остановиться.
- 2
Как добавить его на холст
Нажмите круглую кнопку + в правом нижнем углу холста. Откроется палитра «Добавить» со всеми видами узлов — выберите «Действие».
Можно и иначе: потяните связь от существующего узла и отпустите на пустом месте. Откроется та же палитра, а новый узел сразу окажется соединённым.
- 3
Несколько действий в одном узле
Кликните по узлу — откроется редактор. Задайте «Название узла», по которому вы узнаете его на холсте, и наполните узел кнопкой «Добавить действие». В заголовке панели видно количество: «Действия (3)» на скриншоте ниже.
Действия выполняются сверху вниз, одно за другим. Карандаш открывает действие на редактирование, корзина удаляет. Держите один смысл на узел: «Сохранить ответ» и «Тег и уведомление» читаются на холсте куда лучше, чем один узел «Разное».
- 4
Меню действий
Кнопка «Добавить действие» открывает каталог. «Создать новое» — встроенный список, он ниже. «Модули» — действия установленных модулей. «Сохранённые действия» появляются, когда вы сохраните действие для повторного использования. Поиск сверху фильтрует все три группы сразу.
- 5
«Установить переменную» и «Прочитать переменные»
«Установить переменную» записывает значение: фиксированное, текст с подстановками
{{variable}}из пикера переменных или результат предыдущего действия. Для чисел появляется поле «Операция»: можно увеличить или уменьшить счётчик, а не перезаписывать значение.«Прочитать переменные» работает наоборот: складывает переменные в результаты действия, чтобы дальше их можно было подставить. Читать можно и переменные другого контакта, не только текущего.
- 6
«Задержка»
«Задержка» останавливает сценарий на заданный срок (секунды, минуты, часы) или до конкретной даты и времени. Короткая пауза между двумя сообщениями делает бота живее — человек успевает прочитать первое.
Для пауз длиннее нескольких минут лучше подходит цепочка, о ней ниже.
- 7
«Внешний запрос», Custom Code и AI Action
«Внешний запрос» отправляет HTTP-запрос в любой API: метод, URL, заголовки, тело. Ответ попадает в результаты действия, и его можно подставить в следующее сообщение.
Custom Code запускает ваш код на TypeScript, когда обычного запроса мало. AI Action выполняет один промпт и сохраняет сырой результат — это один вызов, а не диалог.
Эти три бывают долгими. Откройте «Дополнительные параметры» на узле и включите «Выполнять этот Action-блок в фоне»: сценарий приостановится перед блоком, долгая работа пойдёт асинхронно, а потом выполнение продолжится. Переключатель доступен только там, где в блоке есть AI, HTTP-запрос или custom code.
- 8
Теги, уведомления и живой диалог
«Добавить тег» и «Удалить тег» помечают текущий контакт. Теги — основной способ делить людей на сегменты для рассылок и условий.
«Уведомить по тегу» отправляет сообщение всем контактам с этим тегом — так обычно зовут админов. «Сервисное уведомление» пишет вашей команде через сервисный бот и на почту и работает из любого канала. «Начать диалог» передаёт человеку: открывает переписку в живом диалоге и назначает её команде или оператору.
- 9
Цепочки: подписать и отписать
«Подписать на цепочку» добавляет контакт в цепочку напоминаний по таймеру. Шаги идут в фоне, поэтому сценарий продолжается сразу, а не ждёт.
«Отписать от цепочки» убирает контакт и отменяет оставшиеся шаги. Ставьте это действие на ветку, где человек уже сделал то, о чём вы напоминали, — иначе напоминания продолжат приходить.
- 10
«Установить аналитическую цель»
«Установить аналитическую цель» записывает событие цели для текущего контакта. Оно появляется в разделе Analytics → Goals — там и видно, доходят ли люди до конца сценария, над которым вы просидели полдня.
Давайте целям короткие и постоянные ключи. Переименование позже разрежет историю надвое.
- 11
Заказы
«Создать заказ» создаёт заказ для текущего контакта с суммой и валютой. «Обновить заказ» меняет статус существующего, «Удалить заказ» удаляет заказ по id.
Это учётная половина покупки: она фиксирует, что заказали. Сами деньги принимает узел «Приём оплаты» — отдельный вид узла в палитре «Добавить».
- 12
«Открыть Mini App» и «Эмодзи-капча»
«Открыть Mini App» присылает кнопку, которая открывает Telegram Mini App: можно отдать задачу веб-странице и вернуться с результатом.
«Эмодзи-капча» показывает сетку «нажмите нужный эмодзи» и пропускает дальше только тех, кто прошёл проверку. Это стандартный способ не пускать спам-ботов в группу.
- 13
Действия из установленных модулей
Всё перечисленное встроено в платформу. Установленный модуль добавляет свои действия в это же меню — они собраны в группе «Модули» по модулям: Google Sheets приносит Add Row и Find Row, и так далее. Внутри узла они ведут себя как обычные действия.
Кнопка «Смотреть ещё» внизу меню открывает маркетплейс модулей, не выходя из редактора. Как их устанавливать и настраивать — в статье Модули: Таблицы, AI, платежи и другие сервисы.
Эта страница — карта, а не руководство. Отдельные статьи про переменные, HTTP-запросы, код, AI, цепочки, теги, цели и капчу будут позже.
- 14
Что дальше
Большая часть действий, которые вам в итоге понадобятся, приходит из модулей — с них и продолжим.