Поля и выражения
Поля шагов бывают двух видов: выражения (условие, значение переменной, параметр действия) и текст с подстановками (сообщение боту, промпт для ИИ, строка лога). Оба вида редактор проверяет на лету и подсказывает доступные переменные.
Выражения
Заголовок раздела «Выражения»Выражение записывается на JavaScript (точнее, TypeScript — тот же язык с типами). Несколько примеров:
| Где | Пример |
|---|---|
| Условие «Если» | order.total > 1000 && order.status === 'paid' |
| Значение переменной | message.text.trim().toLowerCase() |
| Действие | items.push({ name, price: Number(priceText) }) |
| Число миллисекунд для паузы | 60 * 60 * 1000 |
Строки берутся в кавычки ('новый'), сравнение — ===, «и» / «или» / «не» — && / || / !.
Текст с подстановками
Заголовок раздела «Текст с подстановками»В полях, которые уходят человеку или модели, пишется обычный текст, без кавычек. Значения подставляются через
${…}:
Здравствуйте, ${message.from.firstName}! Ваш заказ №${order.id} на сумму ${order.total} ₽ принят.Перенос строки в таком поле — это перенос строки в сообщении.
Переменные и подсказки
Заголовок раздела «Переменные и подсказки»В каждом поле доступны переменные, объявленные выше по схеме: параметры функции, данные события триггера
(например, message), переменные из «Новая переменная», результаты шагов интеграций и переменные циклов, если шаг
внутри цикла. Редактор подсказывает их имена и поля по мере ввода (Ctrl+Space открывает подсказку вручную).
Кроме переменных, в любом выражении есть функция dayjs для работы с датами — см. Даты и время.
Типы данных
Заголовок раздела «Типы данных»Тип переменной выбирается из списка: число, строка, логическое значение, список, объект — или структура из раздела
Типы проекта. Структура описывает форму данных (например, «Заказ» с полями id, items, total): после этого
редактор знает поля переменной этого типа и подсказывает их. Сами структуры ничего не хранят — это только описание.
Интеграции добавляют свои типы, например сообщение Telegram или строку таблицы базы данных.
Редактор проверяет поля в фоне, пока вы работаете:
- поле с ошибкой подчёркивается красным, а наведение на подчёркивание показывает текст ошибки;
- икона с ошибкой обводится красным (с предупреждением — жёлтым);
- в правом верхнем углу холста появляется метка «N ошибок»: каждый клик по ней показывает следующую икону с ошибкой;
- число ошибок видно и на вкладке документа, даже если он сейчас не открыт.
Код проекта
Заголовок раздела «Код проекта»Проект → Код показывает код, в который превращаются ваши схемы. Клик по строке открывает иконку, из которой она получилась. Это полезно, чтобы понять ошибку компиляции или убедиться, что шаг делает то, что задумано.
Названия функций
Заголовок раздела «Названия функций»Названия функций и триггеров становятся именами в коде, поэтому пишутся латиницей в стиле camelCase: sendReminder,
onNewOrder. Пробелы, кириллица и знаки препинания не допускаются. Названия документов уникальны в проекте.