Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

Поля и выражения

Поля шагов бывают двух видов: выражения (условие, значение переменной, параметр действия) и текст с подстановками (сообщение боту, промпт для ИИ, строка лога). Оба вида редактор проверяет на лету и подсказывает доступные переменные.

Выражение записывается на 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. Пробелы, кириллица и знаки препинания не допускаются. Названия документов уникальны в проекте.