Base de conocimiento de GetMyBot

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), LAMBDA y 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

LugarLenguaje
{{= expresión}} en el texto de un mensajeExpresiones
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órmulaFó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ón condición ? sí : no y 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 funciones AND, OR y NOT.
  • 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 de ctx; {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 en FILTER, FOREACH, ARRAYFIND y REDUCE. 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 TOJSON y recupérala en otra fórmula con FROMJSON.
  • 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 ctx bajo la clave rows: 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-formula con el cuerpo {"formula": "…", "sample_text": "…"}.
  • Por MCP: la herramienta test_formula con los campos bot_id, formula y sample.

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