Variables
Una variable es como una casilla con nombre donde guardas un dato del cliente para usarlo después. Por ejemplo: le preguntas su correo, lo guardas en una variable y más tarde lo metes dentro de un mensaje o lo usas para decidir qué hacer.
¿Qué es una variable?
Imagínate un post-it pegado al perfil de un cliente. Cada vez que el bot conversa con esa persona, puede leer el post-it y escribir cosas nuevas en él. Eso es una variable: un espacio para guardar información que después se reutiliza.
Ejemplo concreto: tu flujo le pregunta al cliente cuál es su correo electrónico. Cuando responde, el bot guarda el correo en una variable llamada email_cliente. Más adelante, en otro paso del flujo, usas ese correo para enviarle un mensaje personalizado: «Te enviamos la confirmación a {{conv.email_cliente}}».
¿Dónde se guarda? (los 3 lugares)
Cuando creas una variable tienes que decidir dónde se guarda. Hay tres opciones y la diferencia importa: define cuánto dura el dato y a quién pertenece.
Conversación
El dato se guarda solo durante esta conversación y desaparece cuando se cierra. Úsalo para datos del momento, como en qué paso del embudo está el cliente, qué producto está consultando o si ya leyó cierto aviso.
Cuándo usarla: intención actual, paso del flujo, una opción que eligió ahora.
Contacto
El dato se guarda en el contacto y queda disponible la próxima vez que te escriba, aunque pase un mes. Úsalo para información del cliente que persiste en el tiempo, como su correo, dirección, talla, plan contratado o preferencias.
Cuándo usarla: email, teléfono alternativo, dirección de envío, preferencias.
Bot (organización)
El dato se guarda a nivel de toda tu organización y es el mismo para todos los contactos. Úsalo para constantes del negocio que no cambian de cliente a cliente, como el teléfono de soporte, el link de pago, el horario de atención o el nombre de tu marca.
Cuándo usarla: teléfono de soporte, link de pago, horarios, mensajes default.
Consejo: si dudas dónde guardar algo, pregúntate: «¿esto sigue siendo verdad la próxima vez que el cliente me escriba?». Si la respuesta es sí, va en Contacto. Si es algo del momento, va en Conversación.
Crear una variable
- Ve a Automatizar → Variables en el menú lateral.
- Haz clic en Crear variable.
- Llena los campos:
- Título: el nombre legible que verás en la lista y en los flujos (ej. «Email del cliente»).
- Identificador: el nombre técnico con el que la referencias dentro de los mensajes. Se autorrellena del título (ej.
email_cliente). Solo puede tener minúsculas, números y guión bajo. - Dónde se guarda: elegir Conversación, Contacto o Bot (ver sección anterior).
- Tipo de dato: qué clase de información va adentro (texto, número, fecha, etc.). Ver más abajo.
- Descripción (opcional): una nota para tu equipo explicando para qué se usa esta variable.
- Haz clic en Crear variable. Listo, ya puedes usarla en tus flujos.
Cómo usarla en un mensaje
Para insertar el valor de una variable dentro de un mensaje, escribes su referencia entre llaves dobles. La sintaxis depende de dónde se guarda:
- Variables de Conversación:
{{conv.identificador}} - Variables de Contacto:
{{contact.identificador}} - Variables del Bot:
{{bot.identificador}}
Ejemplo de mensaje con tres variables:
Si el contacto se llama María, el mensaje se enviará así:
Consejo: dentro del editor de flujos no hace falta escribir las llaves a mano. Cualquier campo de texto tiene un botón «Insertar variable» que te muestra la lista y la pega por ti.
Tipos de dato
El tipo de una variable controla qué clase de información puede guardar. Elige el que mejor describa el dato:
- Texto — una palabra o frase. Es lo más común. Ejemplo: nombre, email, dirección.
- Número — cantidades, montos, edades. Ejemplo:
250(monto a pagar),3(cantidad de productos). - Sí / No — una bandera con dos estados. Ejemplo:
ya_pago= sí o no. - Fecha — un día y hora. Ejemplo: fecha de cita, fecha de vencimiento.
- Lista — una opción dentro de un set fijo. Ejemplo: talla = S/M/L/XL, color = rojo/verde/azul.
- JSON — datos complejos para usuarios avanzados (objetos, listas). Solo úsalo si sabes qué es.
Variables vivas en una conversación
Cuando abres una conversación con un cliente, el panel derecho tiene un tab «Variables». Ahí puedes ver en tiempo real qué valores tiene el contacto y la conversación, y editarlos a mano si necesitas destrabar un flujo.
Esto es útil cuando un flujo se quedó esperando un dato y el cliente no responde: puedes rellenar la variable manualmente desde ese panel y el flujo continúa.
Importante: las variables del Bot (organización) son globales. Si las editas, el cambio aplica a todos los contactos. No las uses para datos personales del cliente.
Glosario rápido
- Identificador (slug) — el nombre técnico de la variable, en minúsculas y sin espacios (ej.
email_cliente). Es lo que va dentro de las llaves cuando la referencias. - Scope (dónde se guarda) — el lugar donde vive la variable: Conversación, Contacto o Bot. Determina cuánto dura y a quién pertenece.
- Interpolación — el proceso por el cual el sistema reemplaza
{{conv.algo}}por su valor real cuando envía el mensaje. - Estado de la conversación — el conjunto de todas las variables guardadas más el modo actual de la conversación (Bot, Flujo, Humano, Pausado).