Referencia de funciones#

Una función se llama así: {{ nombre(argumento1, argumento2) }}. Los argumentos son texto entre comillas, números, variables ($nombre) y, en las expresiones, los resultados de otras funciones.

Las funciones marcadas como simples funcionan en todos los lugares donde funcionan las plantillas. Las demás solo funcionan en los textos de los mensajes, en las condiciones y en la configuración de algunos bloques: consulta Dónde funcionan las plantillas.

Texto#

Todas las funciones de esta sección son simples.

Matemáticas#

Todas las funciones de esta sección son simples. La suma, la resta, la multiplicación, la división y las potencias se escriben con operadores: consulta Aritmética.

Funciones obsoletas#

Estas funciones siguen funcionando, pero en los textos nuevos usa operadores: es más corto y más claro.

Por ejemplo, en lugar de {{ sum($precio, $envio) }} escribe {{ $precio + $envio }}.

Fecha y hora#

Advertencia

La hora se calcula en UTC. Si hace falta, añade tu diferencia horaria, por ejemplo para UTC+1: {{ date("H:i", "+1 hour") }}.

Ejemplos:

Hoy es {{ date("d.m.Y") }}
Nos vemos el {{ date("d.m.Y", "+3 days") }}
Tu cita se ha movido al {{ modifyDateTime($fecha_cita, "d.m.Y", "d.m.Y", "+1 day") }}
Acceso hasta el {{ modifyUnixTime(time(), "+30 days", "d.m.Y") }}

Caracteres de formato principales:

El desplazamiento se escribe en inglés: "+1 day", "-2 hours", "+1 month", "next friday".

Todas las funciones de esta sección son simples.

Nota

En flujos antiguos a veces se usa un signo de interrogación como comodín: {{ date("d.m.Y", "+? days", $dias) }}: ? se sustituye por el siguiente argumento. Sigue funcionando, pero en las expresiones es más fácil unir texto: {{ date("d.m.Y", "+" ~ $dias ~ " days") }}.

Condiciones#

{{ printByCondition($puntos, ">=", 100, "¡El regalo es tuyo!", "Sigue acumulando") }}
{{ printByExistsCondition($telefono, "Teléfono guardado", "Déjanos tu teléfono") }}

Las dos funciones son simples. En las expresiones es más práctico el operador de condición: {{ $puntos >= 100 ? "¡El regalo es tuyo!" : "Sigue acumulando" }}.

Datos del contacto y del bot#

Advertencia

printGlobalVariables() muestra todas las variables globales. No la uses en mensajes a los contactos si tus variables globales guardan claves o contraseñas.

Variables#

Estas funciones escriben el resultado en una variable del contacto y no muestran nada.

Los términos son números o nombres de variables entre comillas, al menos dos: {{ setSumVariablesIntoVariable("result", "precio", "envio", 100) }}.

Para los cálculos es más cómodo el bloque «Operación con variable», que también admite expresiones.

Listas#

En la plantilla, un campo del registro se escribe entre llaves simples: {Nombre}, {Precio}. En getListRows puedes insertar una variable del contacto en la plantilla: {$ciudad}.

{{ getListRows("6523f0c2a1b2c3d4e5f60718", "{Nombre} — {Precio} €", 5, "Precio", "asc") }}

El bot solo lee las listas que pertenecen a su propietario.

Programa de referidos#

Las funciones de esta sección no son simples. Las variantes obsoletas con Telegram en el nombre (getTelegramInviteLink y otras) funcionan igual.

Textos distintos para cada app de mensajería#

El texto dentro de la función solo se muestra a los contactos de esa app de mensajería; el resto ve un espacio vacío:

Escríbenos{{ messageToTelegram(" en Telegram: @example_support") }}{{ messageToWeb(" directamente en este chat") }}

Las funciones de esta sección no son simples. En una expresión, una función de este tipo debe ir sola: no puede estar dentro de una condición ni de otra función.