Sustituciones y fórmulas
Añade el nombre del cliente, una respuesta o el total de un pedido a un mensaje. Aprende dónde se guardan los datos.
En esta página
Para llamar a una persona por su nombre, escribe ¡Hola, {{first_name}}!. Al enviar el mensaje, GetMyBot sustituye {{first_name}} por el nombre del remitente. Estas inserciones se llaman sustituciones. Funcionan en mensajes, ajustes de acciones y textos de botones. El botón Sustituciones del editor te ayuda a elegir una.
| Datos que necesitas | Ejemplo | Cuánto tiempo permanecen |
|---|---|---|
| Datos del mensaje recibido | {{text}}, {{first_name}} | Pertenecen al evento recibido |
| Datos guardados del cliente | {{param.email}} | Permanecen entre distintas ejecuciones |
| Resultado de una consulta o elección de un botón | {{ctx.product_id}} | Solo durante esta ejecución |
Por ejemplo, guarda la respuesta a «¿Cuál es tu correo?» en el parámetro email. En el mensaje siguiente escribe Enviaremos la confirmación a {{param.email}}. Una sustitución desconocida permanece tal como la escribiste. Para calcular un total, usa las fórmulas.
Datos del remitente
{{first_name}},{{last_name}}— nombre y apellido.{{username}}—@usernamedel usuario.{{user_id}}— ID numérico de Telegram.
Datos del evento y del chat
{{text}}(también{{received_message}}) — texto del mensaje entrante.{{message_id}}(también{{received_message_id}}) — ID del mensaje entrante.{{chat_id}},{{chat_title}}(también{{chat_name}}) — chat donde ocurrió el evento.{{topic_id}},{{topic_url}}— tema (para foros).
Eventos del sistema de Telegram
En eventos de entrada, salida, cambio de estado y solicitud de entrada se pueden usar sustituciones {{system.*}}. {{user_id}} identifica al autor del evento, por ejemplo un administrador; {{system.subject_id}} identifica al miembro afectado.
{{system.kind}},{{system.subject_id}},{{system.member_status}}: tipo de evento, ID del miembro y nuevo estado.{{system.invite_link}},{{system.invite_link_name}},{{system.creates_join_request}}: enlace de invitación, su nombre y si el enlace requiere una solicitud de entrada.{{system.via_join_request}},{{system.via_folder_link}}: entrada mediante solicitud aprobada o enlace de carpeta.{{system.is_premium}},{{system.is_bot}},{{system.is_member}}: indicadorestrueofalse;is_memberindica si sigue en el chat después del evento.{{system.bio}},{{system.user_chat_id}}: biografía y chat privado temporal del solicitante, si Telegram los proporciona.{{system.date}}: hora del evento de Telegram en segundos Unix, no la hora de procesamiento.
Si faltan datos, las sustituciones conocidas devuelven una cadena vacía o false; las desconocidas permanecen en el texto. La biografía y el nombre del enlace son datos externos: no los insertes como comandos ni marcado sin procesar. No publiques enlaces de invitación sin necesidad. Telegram permite usar {{system.user_chat_id}} durante cinco minutos como máximo, mientras la solicitud no esté procesada y otro administrador no haya contactado al solicitante. No lo guardes como dirección permanente ni lo uses como ID del miembro para moderar.
Origen e invitaciones
{{utm_source}},{{utm_medium}},{{utm_campaign}},{{utm_content}},{{utm_term}}: etiquetas que indican de dónde llegó una persona, por ejemplo una campaña publicitaria. Se reciben en el enlace de inicio del bot. La parte añadida después destart=se llama etiqueta de inicio o payload.{{referrals.count}}: número de suscriptores actuales y no fusionados que esta persona invitó con su enlace (https://t.me/<bot>?start=ref_{{user_id}}). Vale0si no hay ninguno. Solo cuentan los suscriptores nuevos; repetir/startmediante otro enlace no cambia el número.{{referrer_id}}: ID de quien invitó, vacío si la persona llegó por su cuenta.{{ctx.referrer_id}}: disponible en la primera reacción/startde una persona nueva que usó un enlace de invitación. Pertenece a ese inicio, no al eventoreferral.joined.
Las etiquetas UTM admiten utm_source=vk&utm_medium=cpc y el formato de Telegram utm_source-vk__utm_medium-cpc. Para cada clave se usa el primer valor no vacío. El ID de quien invita en ref=<ID> o ref_<ID> se interpreta por separado.
El origen se fija con el primer enlace de inicio que tenga una etiqueta no vacía. Otro /start no cambia el origen ni añade etiquetas UTM de un enlace nuevo. Si el primer enlace no tenía UTM, esos campos quedan vacíos. Una etiqueta cualquiera se guarda como origen sin valores UTM; un enlace sin etiqueta no fija el origen. Consulta Origen del suscriptor.
Por ejemplo, la reacción /start puede enviar Tu enlace: https://t.me/<bot>?start=ref_{{user_id}} – invitados: {{referrals.count}}. Otra reacción con el evento referral.joined procesa la invitación en nombre del suscriptor nuevo. El evento tiene referrer_tg_user_id, referrals_count y start_payload. Consulta Evento del cliente o del sitio para saber a quién se envía el mensaje.
Fecha y hora
{{date}}— fecha (YYYY-MM-DD),{{time}}— hora (HH:MM),{{datetime}}— fecha y hora.- Formato:
{{date:DD.MM.YYYY HH:mm}}— tokensYYYY,YY,MM,DD,HH,mm,ss.
Parámetros del usuario
{{param.clave}}(también{{params.clave}}o{{recipient.clave}}) — valor de un parámetro del suscriptor. Los parámetros se llenan con las acciones «Modificar parámetros», «Guardar mensaje» y las respuestas en el diálogo.{{label.nombre}}:1si el suscriptor tiene esa etiqueta (sin distinguir mayúsculas; también puedes usar su ID), o vacío si no la tiene. Sirve para texto condicional y botones ocultos.{{label.nombre.expires_at}}: fecha y hora de caducidad de una etiqueta temporal, en formatoYYYY-MM-DD HH:MM. Vacío si la etiqueta es permanente o no existe.{{label.nombre.days_left}}: días completos hasta que se quite la etiqueta, redondeados hacia arriba (0si ya caducó). Vacío si es permanente.
Contexto de ejecución (ctx)
Imagina el contexto como las notas que el bot utiliza durante una ejecución. Una acción busca productos y guarda el resultado en ctx.products; la siguiente usa esa lista para crear botones. Si necesitas recordar un valor en otra conversación, guárdalo en un parámetro del usuario.
{{ctx.clave}}(también{{context.clave}}) — valores temporales de la ejecución actual: datos del webhook entrante, resultados de acciones (solicitud web, consulta a fuente, IA), datos restaurados del botón (Carry), elementos de bucle.- En el bucle de lista, el elemento está disponible con su alias, por ejemplo
{{item.name}}.
Fórmulas
La construcción {{= expresión}} calcula una fórmula corta dentro del texto. El mismo lenguaje se usa en el modo Fórmula de la acción Calcular y en las condiciones de una tabla de decisiones. Permite usar parámetros y valores ctx por su nombre, operar con números, comparar valores y elegir entre dos resultados con ? :. Sus funciones son len, upper, lower, trim, concat, round, floor, ceil, abs, min y max.
Ejemplos: {{= price * qty}}, {{= round(total / 3)}}.
Las funciones de la fórmula avanzada (ROUND, IF, CONCAT, FILTER, HASH, entre otras) no funcionan dentro de {{= }}. Calcula el valor con la acción Calcular en el modo Fórmula avanzada e inserta el resultado con {{ctx.clave}}.
Sintaxis completa y lista de funciones en la sección Fórmulas.
HTML en las sustituciones
Los mensajes se envían con marcado HTML. Para que un valor sustituido no rompa el diseño (por ejemplo, cuando un nombre de usuario contiene <), los valores sustituidos se escapan de forma predeterminada: los caracteres HTML se convierten en texto seguro. Las etiquetas que escribes directamente en el texto de la reacción (<b>, <a>, …) se dejan intactas.
Si un valor ya contiene marcado listo (por ejemplo, un anuncio guardado en un parámetro con <b>...</b>) y quieres insertarlo tal cual, antepón & a la sustitución:
{{& key}}— inserción en bruto para las sustituciones{{...}}.{&user:key},{&recipient:key},{&global:key}— inserción en bruto para las sustituciones de namespace.
El prefijo & desactiva el escapado solo para esa sustitución concreta — tú respondes por la confianza en el origen del valor. Es mejor dejar escapados los tokens controlados por el suscriptor ({{first_name}}, …).
Al importar bots desde otros constructores, las sustituciones de namespace {user:…}/{recipient:…}/{global:…} se migran automáticamente a la forma en bruto {&…} — suelen contener valores con marcado listo, tal como funcionaba en el constructor de origen.
Importante sobre el formato
Las sustituciones {{...}} funcionan en textos, pies de foto, cuerpos de solicitudes y plantillas de botones. Da a los parámetros y claves de ctx nombres cortos en caracteres latinos (email, total, order_id) — así son más cómodos de insertar.
Qué sigue
- Fórmulas — sintaxis del DSL y lista completa de funciones.
- Mensajes y botones — dónde se aplican las sustituciones.
- Acciones — acciones que llenan los parámetros y
ctx. - Colecciones y datos — almacenamiento de datos entre ejecuciones.