Как собирать сценарий

Сценарий - это цепочка узлов на холсте. Вы добавляете узлы, соединяете их линиями, и данные проходят слева направо от узла к узлу. Эта страница объясняет механику: как соединять узлы, как они передают данные друг другу и как выстроить рабочий процесс сборки.

Добавление и соединение узлов

Чтобы добавить первый узел - нажмите Добавить узел в центре пустого холста или кнопку + на панели.

Чтобы добавить следующий узел и сразу соединить его с предыдущим - нажмите на коннектор (стрелка на правой стороне узла). Список узлов откроется уже с готовой связью: выбранный узел добавится и сразу подключится.

Или нажмите кнопку Добавить узел в нижней панели - тогда узел добавится на холст без соединения с другими узлами.

Узлы со свободными коннекторами магнитятся друг к другу: потяните один к другому - связь создастся автоматически.

Связь можно протянуть вручную от одного узла к другому. Если связь уже есть - не нужно удалять и создавать заново: потяните её начало или конец к другому узлу, и она переподключится.

Чтобы удалить связь - кликните на ней правой кнопкой мыши и выберите Удалить.

Контекстное меню на связи с кнопкой удаления

Как получить первые данные в сценарий

Если в сценарии стоит триггер приложения (Gmail, Telegram, Slack и т.д.), нужно получить от него данные, прежде чем настраивать следующие узлы. Есть два способа.

Способ 1: запустить только триггер. Наведите на узел-триггер, нажмите на него правой кнопкой мыши и выберите Запустить узел один раз. Узел попытается получить последнее событие из подключённой системы. В некоторых случаях API вернёт тестовое (sample) сообщение - этого достаточно, чтобы увидеть структуру данных и начать настройку следующих узлов.

Способ 2: запустить весь сценарий. Нажмите Запустить один раз в нижнем левом меню - сценарий запустится полностью и будет ожидать реального события в триггере подключённой системы. Как только вы вручную создадите это событие (отправите письмо, сообщение и т.д.), триггер его поймает и данные пройдут по всей цепочке.

Вы также можете в любой момент запустить вручную любой экшн в цепочке и получить от него данные - независимо от триггера.

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

Как посмотреть данные выполнения узла

После того как узел запустился, рядом с ним появляется зелёный кружок. Кликните на него - откроется панель с вкладками Input, Output, Log и Error.

Самая ценная вкладка - Output: здесь собраны все данные, которые вернул сервис на ваш запрос. Именно их вы будете использовать в следующих узлах. Например, для триггера Telegram там уже есть ID отправителя, ID чата, текст сообщения и другие поля.

Зелёный кружок на узле Telegram и открытая панель с вкладкой Output - развёрнутые поля с данными: update_id, message, from, chat

Как подставить данные дальше по сценарию

Предположим, триггер получил сообщение из Telegram и мы хотим передать его текст в ChatGPT. Кликните в нужное поле узла - откроется окно с вкладкой «Данные», где доступны переменные из всех предыдущих узлов цепочки. Напишите текст запроса, раскройте нужный узел и кликните на переменную - она вставится прямо в то место, где стоит курсор.

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

Чтобы переменная появилась в «Данных», предыдущий узел должен быть запущен хотя бы один раз. Если вкладка «Данные» пустая - сначала запустите нужный узел через Run Node Once.

Если запустить узел, в полях которого стоят переменные из незапущенных предыдущих узлов, на месте этих переменных придёт null. Это может привести к ошибке или к неправильному результату. Всегда запускайте узлы по порядку: сначала тот, из которого берёте данные, потом тот, который их использует.

В примере ниже: добавляем узел Telegram для отправки ответа, передаём в поле Chat ID переменную из триггера, а в поле с текстом - ответ ChatGPT.

Поля, помеченные красной звёздочкой, обязательны для заполнения. Без них узел выдаст ошибку. Заполняйте их в первую очередь.

Названия полей обычно совпадают с названиями нужных данных. Если поле называется Chat ID - туда нужно подставить значение chat_id из предыдущего узла. Так работает с большинством стандартных идентификаторов: chat_id, user_id, request_id и другими. Ищите в «Данных» переменную с таким же именем.

Подход к сборке

Спланируйте сценарий: определите, какие узлы нужны и в каком порядке.
Добавьте нужные узлы на холст.
Начните настройку с первого узла: заполните поля и запустите его - ПКМ → Запустить узел один раз.
Кликните на кружок рядом с выполненным узлом и проверьте выходные данные: вернул ли узел то, что ожидалось. Если нет - измените настройки и запустите снова.
Настройте следующий узел: подставьте нужные данные из предыдущих узлов через вкладку «Данные» и запустите его.
Проверьте его Output так же, как в шаге 4.
Повторяйте шаги 5-6 до конца цепочки.

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

Операторы

Иногда данные нужно не просто передать дальше, а преобразовать: привести дату к нужному формату, собрать строку из нескольких переменных, посчитать длину текста. Для этого используются операторы.

Кликните в любое поле узла и перейдите на вкладку Operators - она находится рядом с «Данными». Там собраны все операторы по группам: сравнения, математика, работа со строками, датами и массивами.

Вкладка Operators в панели поля: список операторов по группам - Compare, Math, Functions, Date

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

Узел SetVariables: поле Value с операторами toUpper, formatDate и length, рядом Output с результатом - Hello, IVAN! Today is 14.04.2026. Message length: 11 chars.

Значения now, today и timestamp доступны в любом поле без предварительного запуска узлов.

→ Подробнее об операторах

Ветвление: фильтры и условия

Операторы также используются для фильтрации и маршрутизации: условие на связи между узлами - это оператор сравнения, который решает, пойдут ли данные по этой ветке.

В Nodul нет отдельных узлов для фильтрации и маршрутизации - таких как if, filter, split, merge и подобных. Всё это настраивается прямо на связях между узлами.

Один узел может иметь несколько исходящих связей. На каждой задаётся условие - ветка сработает только если оно выполнилось. Если условие не выполнилось, данные по этой ветке не пройдут.

Нажмите на связь между узлами - откроется панель, где задаётся условие. В примере ниже две ветки: одна срабатывает если amount больше 100, другая - если меньше.

Панель настройки фильтра на связи с двумя ветками по значению amount

Вот как это работает в действии: при значении 150 срабатывает первая ветка, при 50 - вторая.

Если на связи не задано условия - данные пройдут по ней всегда. Если у узла несколько связей без условий - выполнятся все ветки одновременно.

Полный список операторов и примеры работы с ними - в разделе Основы операторов.

Резервная связь. Если ни одно условие на исходящих связях не выполнилось, сработает резервная связь - ветка «для всех остальных случаев». Включается переключателем Fallback router в настройках связи.

Настройки связи с включённым переключателем Fallback router

Что дальше?

→ Виды сценариев

→ Если нет нужной интеграции