Fórmulas
Calcula importes y descuentos o elige un resultado según una condición. Aprende cuándo escribir una expresión en un mensaje y cuándo usar la acción Cálculo.
En esta página
Las fórmulas ayudan al bot a calcular y elegir valores. Por ejemplo, si el precio es 500 y la cantidad es 3, {{= price * qty}} produce 1500. Antes debes guardar price y qty en los parámetros del cliente o en los datos temporales de la reacción actual.
Para un cálculo sencillo, escribe una expresión directamente en el mensaje. Si necesitas trabajar con listas, fechas o funciones con nombres en ruso, añade la acción Cálculo. GetMyBot usa dos lenguajes de fórmulas con sintaxis distinta:
- Expresiones: lenguaje breve para operaciones aritméticas, comparaciones y texto sencillo. Funciona en
{{= expresión}}dentro del texto, en el modo Fórmula de la acción Cálculo y en las condiciones de una tabla de decisiones. - Fórmula avanzada: lenguaje parecido al de una hoja de cálculo. Admite listas, datos JSON, fechas, hashes (valores de comprobación de texto),
LAMBDAy nombres de funciones en ruso. Funciona en el modo Advanced formula de la acción Cálculo, en la verificación de respuestas mediante fórmula y en el comprobador de fórmulas.
Dónde funcionan las fórmulas
| Lugar | Lenguaje |
|---|---|
{{= expresión}} en el texto de un mensaje | Expresiones |
Cálculo, modo Fórmula (expr) | Expresiones |
Cálculo, modo Tabla de decisiones (rules) | Expresiones en las condiciones «cuando»; «entonces» y el valor por defecto son texto con sustituciones {{...}} |
Cálculo, modo Advanced formula (formula) | Fórmula avanzada |
| Verificación de respuesta Coincide con la fórmula | Fórmula avanzada |
Comprobador de fórmulas (test_formula) | Fórmula avanzada |
Acción Cálculo
Tiene tres modos; en cada acción se elige exactamente uno:
- Fórmula (
expr): una expresión. - Tabla de decisiones (
rules+default): reglas «cuando → entonces». Devuelve el valor de la primera regla cuya condición sea verdadera; si ninguna coincide, devuelve el valor por defecto. - Advanced formula (
formula): una fórmula escrita en el lenguaje completo.
Elige dónde guardar el resultado: en los datos temporales de la reacción, ctx (campo Guardar en contexto, save_to_ctx), o en la ficha del cliente (campo Guardar en parámetro, save_to_param). Puedes guardarlo en ambos, pero al menos uno es obligatorio. Por ejemplo, si lo guardas en ctx con la clave discount, podrás insertarlo como {{ctx.discount}}.
Límites: cada expresión, condición o valor de una regla puede ocupar hasta 4096 bytes; una fórmula avanzada, hasta 16384 bytes. Una tabla puede tener como máximo 64 reglas. La longitud se mide en bytes: una letra cirílica ocupa 2 bytes.
Ejemplo de parámetros de la acción con una fórmula avanzada:
{"type":"compute","params":{"formula":"IF({total} > 1000; \"mayorista\"; \"minorista\")","save_to_ctx":"segment"}}
Expresiones
Sintaxis
- Operadores: aritmética
+ - * / %, comparaciones== != < > <= >=, lógica&& || !, condicióncondición ? sí : noy paréntesis( ). - Valores escritos en la expresión: números (
42,3.14), texto entre comillas ("hola"o'hola') y valores lógicos (true,false). - Datos: escribe el nombre sin llaves. Se busca entre los parámetros del suscriptor y en
ctx:price * qty,ctx.total,param.total. Un nombre desconocido devuelve una cadena vacía. - Funciones:
nombre(argumento1, argumento2), con los argumentos separados por comas.
Funciones
Solo están disponibles estas funciones, escritas en minúsculas: len, upper, lower, trim, concat, round, floor, ceil, abs, min, max. min y max aceptan exactamente dos argumentos; concat acepta cualquier cantidad. Tanto len como LEN en la fórmula avanzada cuentan los caracteres tal como los percibe una persona: una letra acentuada, una bandera o un emoji formado por varios puntos de código, como la familia 👨👩👧👦, cuentan como un solo carácter.
Las expresiones no admiten nombres de funciones en ruso. Si {{= }} contiene una función desconocida, la construcción queda sin cambios en el texto.
Fórmula avanzada
Sintaxis de la fórmula avanzada
- Argumentos separados por punto y coma:
IF({total} > 1000; "mayorista"; "minorista"). - Operadores: aritmética
+ - * /, unión de texto&y comparaciones= != <> < > <= >=. Para la igualdad se usa un solo=. La lógica se expresa con las funcionesAND,ORyNOT. - Cadenas entre comillas dobles o simples.
""dentro de una cadena no sirve para escapar una comilla. Si necesitas comillas dentro del texto, como en un atributo HTML, usa el otro tipo:"<a href='tg://user?id=" & r.user_id & "'>perfil</a>". - Datos entre llaves simples:
{clave}toma un valor dectx;{text}y{answer}contienen el texto del mensaje recibido;{user:clave}toma un parámetro del suscriptor y{global:clave}uno global del bot. - LAMBDA:
LAMBDA(r; expresión)define cómo procesar cada elemento de una lista enFILTER,FOREACH,ARRAYFINDyREDUCE. Accede a los campos de un objeto JSON con un punto, por ejemplo,r.user_id. - Resultado: se convierte en texto. Para conservar una lista, guárdala con
TOJSONy recupérala en otra fórmula conFROMJSON. - Nombres de funciones: no distinguen entre mayúsculas y minúsculas y admiten alias en ruso.
Funciones de la fórmula avanzada
La forma principal de cada nombre está en inglés. Entre paréntesis aparece su alias en ruso, cuando existe. Estas funciones solo están disponibles en la fórmula avanzada.
Matemáticas
SUM (СУММ), AVERAGE (СРЗНАЧ), MAX (МАКС), MIN (МИН), MOD (ОСТАТ), POW (СТЕПЕНЬ), SQRT (КОРЕНЬ), PI (ПИ), ROUND (ОКРУГЛ), CEIL (ОКРВВЕРХ), FLOOR (ОКРВНИЗ), TRUNC (ОТБР), ABS, RANDBETWEEN (СЛУЧМЕЖДУ).
Texto
LEN (ДЛСТР), LEFT (ЛЕВСИМВ), RIGHT (ПРАВСИМВ), MID (ПСТР), LOWER (СТРОЧН), UPPER (ПРОПИСН), UPPERFIRST (ПРОПИСНПЕРВ), REPEAT (ПОВТОР), CONCAT (СЦЕПИТЬ), SUBSTITUTE (ПОДСТАВИТЬ), FIND (НАЙТИ), SEARCH (ПОИСК), FIELD (ПОЛЕ), TRIM, LTRIM, RTRIM, PADLEFT, PADRIGHT, SPLIT, JOIN, STARTSWITH, ENDSWITH, CONTAINS, NL.
Lógica
IF (ЕСЛИ), AND (И), OR (ИЛИ), NOT (НЕ), EMPTY, ISNUMBER (ЕЧИСЛО), COALESCE.
Listas
SORT, RSORT, UNIQUE, FILTER, FOREACH, REDUCE, INDEX, SLICE, COUNTA (СЧЁТЗ), COUNTUNIQUE, ARRAYADD, ARRAYREMOVE, ARRAYREPLACE, ARRAYFIND, PAIRUP (СОСТАВИТЬПАРЫ).
PAIRUP(items; idField; seed [; tagsField]) distribuye participantes en parejas para un «café aleatorio». Si el número de participantes es impar, un grupo tendrá tres personas. La función intenta separar a quienes comparten etiquetas, indicadas como cadena "|a|b|" o como lista. Con los mismos datos y el mismo seed, el reparto se repite. Los límites son 10 000 participantes y 64 etiquetas por persona; consulta Límites de la plataforma. En listas grandes con muchas etiquetas compartidas puede ser imposible evitar todas las coincidencias, pero nadie se queda sin grupo. La acción Buscar registros lee hasta 10 000 filas por vez y el resultado de una fórmula avanzada puede ocupar hasta 4 MB.
Fecha y hora
TODAY (СЕГОДНЯ), NOW (ТДАТА), DATEADD, DATESUB, DATEDIF (РАЗНДАТ), DATEFORMAT, DATEVALUE, WEEKDAY (ДЕНЬНЕД).
JSON
TOJSON, FROMJSON, JSONPATH, JP, JSONOBJECT, JSONARRAY, KEYS, VALUES.
Criptografía y codificación
HASH (ХЭШ), TOBASE64, FROMBASE64, FROMJWT, FROMJWK.
Parámetros
PARAMID, PARAMREPLACE, PARAMREMOVE.
Ejemplos
Expresiones en el texto:
- Importe del pedido:
{{= price * qty}}. - Un tercio del importe, redondeado:
{{= round(total / 3)}}. - Condición:
{{= param.total > 1000 ? "mayorista" : "minorista"}}. - Construir un texto:
{{= concat("Pedido n.º ", ctx.order_id)}}.
Fórmulas avanzadas en la acción Cálculo:
- Descuento del 10 %:
ОКРУГЛ({user:total} * 0.9). - Tamaño de una lista en
ctx:СЧЁТЗ(FROMJSON({items})). - Orden seudoaleatorio estable para los registros que Buscar registros guardó en
ctxbajo la claverows: el orden se repite mientras no cambie la «sal».
{"type":"compute","params":{"formula":"TOJSON(SORT(FOREACH(FROMJSON({rows}); LAMBDA(r; HASH(\"sha256\"; r.user_id & \"-salt\") & \"|\" & r.user_id))))","save_to_ctx":"order"}}
Al verificar una respuesta con Coincide con la fórmula, la fórmula devuelve el texto del error; un resultado vacío significa que se acepta la respuesta. Por ejemplo: IF(ISNUMBER({answer}); ""; "Introduce un número").
Comprobar una fórmula
El comprobador evalúa fórmulas avanzadas y devuelve el resultado o un error de sintaxis sin guardar nada:
- En el editor: en la verificación de respuesta Coincide con la fórmula, introduce un ejemplo en Ejemplo de respuesta y pulsa Verificar.
- Por API:
POST /api/bots/{botID}/reactions/test-formulacon el cuerpo{"formula": "…", "sample_text": "…"}. - Por MCP: la herramienta
test_formulacon los camposbot_id,formulaysample.
La respuesta contiene ok (indica que la fórmula se evaluó), result, error y matches (true si el resultado está vacío, es decir, si la respuesta pasaría la verificación).
La fórmula se evalúa en un contexto vacío: ctx, los parámetros del suscriptor y los parámetros globales están vacíos, por lo que {clave} y {user:clave} devuelven una cadena vacía. Solo está disponible el texto de ejemplo mediante {text}, {answer} o {received_message}. El comprobador no evalúa expresiones ({{= }}), el modo Fórmula ni las tablas de decisiones.
Qué sigue
- Sustituciones y fórmulas: variables
{{...}}, contextoctxy parámetros. - Acciones: la acción Cálculo y las tablas de decisiones.
- Mensajes y botones: fórmulas en el texto y verificación de respuestas en los pasos de diálogo.
- Colecciones y datos: datos con los que trabajan las fórmulas.
- Límites de la plataforma: tamaños permitidos de fórmulas y tablas de decisiones.