Формулы
Как рассчитать сумму, скидку или выбрать ответ по условию. Когда достаточно формулы в тексте, а когда нужно действие «Вычисление».
На этой странице
Формулы помогают боту считать и выбирать значения. Например, если цена равна 500, а количество равно 3, подстановка {{= price * qty}} даст 1500. Значения price и qty нужно заранее сохранить в параметрах клиента или во временных данных текущей реакции.
Для простого расчёта напишите выражение прямо в сообщении. Для работы со списком, датами или функциями на русском языке добавьте действие «Вычисление». В GetMyBot используются два языка, их синтаксис различается:
- Выражения: короткий язык для арифметики, сравнений и простых строк. Работает в
{{= выражение}}прямо в тексте, в режиме «Формула» действия «Вычисление» и в условиях таблицы решений. - Расширенная формула: похожа на формулы электронных таблиц. Поддерживает списки, данные в формате JSON, даты, хэши (контрольные значения текста),
LAMBDAи русские названия функций. Работает в режиме «Расширенная формула» действия «Вычисление», в проверке ответа по формуле и в тестере.
Где работают формулы
| Где | Язык |
|---|---|
{{= выражение}} в тексте сообщения | выражения |
«Вычисление», режим «Формула» (expr) | выражения |
«Вычисление», режим «Таблица решений» (rules) | выражения в условиях «когда»; «тогда» и значение по умолчанию – обычный текст с подстановками {{...}} |
«Вычисление», режим «Расширенная формула» (formula) | расширенная формула |
| Проверка ответа «Соответствует формуле» | расширенная формула |
Тест формулы (test_formula) | расширенная формула |
Действие «Вычисление»
У действия три режима, в одном действии выбирается ровно один:
- Формула (
expr): одно выражение. - Таблица решений (
rules+default): список правил «когда → тогда». Возвращается значение первого правила, чьё условие истинно, иначе значение по умолчанию. - Расширенная формула (
formula): формула на полном языке.
Укажите, куда сохранить результат: во временные данные текущей реакции, ctx (поле «Сохранить в ctx», save_to_ctx), или в карточку клиента («Сохранить в параметр», save_to_param). Можно выбрать оба места, но хотя бы одно обязательно. Например, результат с ключом discount в ctx подставляется как {{ctx.discount}}.
Ограничения: выражение, условие и значение правила занимают до 4096 байт, расширенная формула до 16384 байт, правил не больше 64. Размер считается в байтах: буква кириллицы занимает 2 байта.
Пример параметров действия с расширенной формулой:
{"type":"compute","params":{"formula":"IF({total} > 1000; \"опт\"; \"розница\")","save_to_ctx":"segment"}}
Выражения
Синтаксис
- Операторы: арифметика
+ - * / %, сравнения== != < > <= >=, логика&& || !, тернарныйусловие ? да : нет, скобки( ). - Значения в самой формуле: числа (
42,3.14), текст в кавычках ("привет"или'привет'), логические значения (true,false). - Данные: имя пишется без фигурных скобок и ищется в параметрах подписчика и
ctx:price * qty,ctx.total,param.total. Неизвестное имя даёт пустую строку. - Вызов функции:
имя(аргумент1, аргумент2), аргументы через запятую.
Функции
Только эти, и только строчными буквами: len, upper, lower, trim, concat, round, floor, ceil, abs, min, max. min и max принимают ровно два аргумента, concat – любое число. len и LEN в расширенной формуле считают символы так, как их видит читатель: буква с ударением, флаг или эмодзи из нескольких кодовых точек (например, семья 👨👩👧👦) – это один символ.
Русских алиасов в выражениях нет. Если в {{= }} встретилась неизвестная функция, конструкция остаётся в тексте без изменений.
Расширенная формула
Синтаксис расширенной формулы
- Аргументы разделяются точкой с запятой:
IF({total} > 1000; "опт"; "розница"). - Операторы: арифметика
+ - * /, склейка строк&, сравнения= != <> < > <= >=(равенство – одинарный=). Логика – функциямиAND,OR,NOT. - Строки в двойных или одинарных кавычках.
""внутри строки не означает кавычку: если кавычка нужна внутри текста (например, в HTML-атрибуте), возьмите кавычки другого вида:"<a href='tg://user?id=" & r.user_id & "'>профиль</a>". - Данные подставляются в одинарных фигурных скобках:
{ключ}– значение изctx(а также{text}или{answer}– текст входящего сообщения),{user:ключ}– параметр подписчика,{global:ключ}– глобальный параметр бота. - LAMBDA:
LAMBDA(r; выражение)задаёт правило обработки каждого элемента списка дляFILTER,FOREACH,ARRAYFINDиREDUCE. Поля объекта JSON читаются через точку:r.user_id. - Результат превращается в текст. Список сохраняйте через
TOJSON, а в следующей формуле читайте черезFROMJSON. - Имена функций не зависят от регистра и понимают русские алиасы.
Функции расширенной формулы
Имена даны в каноничном (английском) виде; в скобках: русский алиас, если он есть. Эти функции доступны только в расширенной формуле.
Математика
SUM (СУММ), AVERAGE (СРЗНАЧ), MAX (МАКС), MIN (МИН), MOD (ОСТАТ), POW (СТЕПЕНЬ), SQRT (КОРЕНЬ), PI (ПИ), ROUND (ОКРУГЛ), CEIL (ОКРВВЕРХ), FLOOR (ОКРВНИЗ), TRUNC (ОТБР), ABS, RANDBETWEEN (СЛУЧМЕЖДУ).
Текст
LEN (ДЛСТР), LEFT (ЛЕВСИМВ), RIGHT (ПРАВСИМВ), MID (ПСТР), LOWER (СТРОЧН), UPPER (ПРОПИСН), UPPERFIRST (ПРОПИСНПЕРВ), REPEAT (ПОВТОР), CONCAT (СЦЕПИТЬ), SUBSTITUTE (ПОДСТАВИТЬ), FIND (НАЙТИ), SEARCH (ПОИСК), FIELD (ПОЛЕ), TRIM, LTRIM, RTRIM, PADLEFT, PADRIGHT, SPLIT, JOIN, STARTSWITH, ENDSWITH, CONTAINS, NL.
Логика
IF (ЕСЛИ), AND (И), OR (ИЛИ), NOT (НЕ), EMPTY, ISNUMBER (ЕЧИСЛО), COALESCE.
Списки
SORT, RSORT, UNIQUE, FILTER, FOREACH, REDUCE, INDEX, SLICE, COUNTA (СЧЁТЗ), COUNTUNIQUE, ARRAYADD, ARRAYREMOVE, ARRAYREPLACE, ARRAYFIND, PAIRUP (СОСТАВИТЬПАРЫ).
PAIRUP(items; idField; seed [; tagsField]) распределяет участников по парам для «random coffee». При нечётном числе участников одна группа будет из трёх. Участников с общими тегами (строка "|a|b|" или массив) функция старается развести по разным группам. Один и тот же seed при тех же входных данных даёт то же распределение. Лимиты: до 10 000 участников и 64 тегов у одного участника (см. «Лимиты»). Для больших списков с множеством общих тегов избежать всех пересечений может не получиться, но все участники попадут в группы. Действие «Найти записи» читает до 10 000 строк за раз, результат расширенной формулы может занимать до 4 МБ.
Дата и время
TODAY (СЕГОДНЯ), NOW (ТДАТА), DATEADD, DATESUB, DATEDIF (РАЗНДАТ), DATEFORMAT, DATEVALUE, WEEKDAY (ДЕНЬНЕД).
JSON
TOJSON, FROMJSON, JSONPATH, JP, JSONOBJECT, JSONARRAY, KEYS, VALUES.
Криптография и кодирование
HASH (ХЭШ), TOBASE64, FROMBASE64, FROMJWT, FROMJWK.
Параметры
PARAMID, PARAMREPLACE, PARAMREMOVE.
Примеры
Выражения в тексте:
- Сумма заказа:
{{= price * qty}}. - Треть суммы с округлением:
{{= round(total / 3)}}. - Условие:
{{= param.total > 1000 ? "опт" : "розница"}}. - Сборка строки:
{{= concat("Заказ №", ctx.order_id)}}.
Расширенная формула в действии «Вычисление»:
- Скидка 10%:
ОКРУГЛ({user:total} * 0.9). - Размер списка из
ctx:СЧЁТЗ(FROMJSON({items})). - Стабильный псевдослучайный порядок записей, которые действие «Найти записи» положило в
ctxпод ключомrows: порядок не меняется между запусками, пока не изменится «соль».
{"type":"compute","params":{"formula":"TOJSON(SORT(FOREACH(FROMJSON({rows}); LAMBDA(r; HASH(\"sha256\"; r.user_id & \"-salt\") & \"|\" & r.user_id))))","save_to_ctx":"order"}}
Проверка ответа «Соответствует формуле»: формула возвращает текст ошибки, а пустой результат означает, что ответ принят. Например, IF(ISNUMBER({answer}); ""; "Введите число").
Тест формулы
Тестер проверяет расширенную формулу и возвращает результат или ошибку синтаксиса, ничего не сохраняя:
- в редакторе: в блоке проверки ответа «Соответствует формуле» введите пример в поле «Пример ответа» и нажмите «Проверить»;
- по API:
POST /api/bots/{botID}/reactions/test-formulaс телом{"formula": "…", "sample_text": "…"}; - по MCP: инструмент
test_formulaс полямиbot_id,formulaиsample.
Ответ: ok (формула вычислилась), result, error и matches (true, если результат пустой, то есть ответ прошёл бы проверку).
Формула считается в пустом контексте: ctx, параметры подписчика и глобальные параметры пусты, поэтому {ключ} и {user:ключ} дают пустую строку. Доступен только пример текста: {text}, {answer} или {received_message}. Выражения ({{= }}, режим «Формула», таблица решений) тестером не проверяются.
Что дальше
- Подстановки и формулы: переменные
{{...}}, контекстctxи параметры. - Действия: действие «Вычисление» и таблицы решений.
- Сообщения и кнопки: формулы в текстах и проверка ответа в шагах диалога.
- Коллекции и данные: данные, над которыми считают формулы.
- Лимиты платформы: размеры формул и таблиц решений.