¿Que estas buscando?
Las variables permiten que tu chatbot recuerde, almacene y use información que brinda el usuario durante la conversación.
Son fundamentales para personalizar respuestas, tomar decisiones, enviar datos a APIs o completar formularios.
A continuación, te explicamos todo lo que necesitás saber para entenderlas y usarlas correctamente.
1️⃣ ¿Qué es una variable?
Una variable es un contenedor de información.
Guarda un dato que el usuario ingresa o que el bot genera automáticamente.
Ejemplos de información típica almacenada:
- Nombre
- Empresa
- Edad
- Opción elegida por el usuario
- Archivo subido
- Resultado de una API
Las variables se usan para personalizar mensajes, derivar el flujo o enviar/recibir datos externos.
2️⃣ Tipos de variables en Ánima Bot
En Ánima existen dos grandes tipos:
A. Variables del sistema (predefinidas)
Son variables ya creadas por la plataforma.
Siempre están disponibles y se utilizan frecuentemente.
Ejemplos reales del sistema (los que viste en tu captura):
- Nombre (name)
- Email (email)
- Teléfono (phone)
- Dirección (address)
- Fecha de nacimiento (birthdate)
- Edad (age)
- subirarchivo (subir_archivo)
Estas variables garantizan un formato estándar para información básica de contactos.
B. Variables personalizadas (creadas por el usuario)
Las podés generar desde el selector “Crear una nueva variable”.
Sirven para guardar cualquier dato adicional que el bot necesite:
Ejemplos:
- opciondeseada
- empresa
- motivos
- calificacion
Una vez creada, la podés usar en cualquier parte del flujo.
3️⃣ ¿Dónde se guardan las variables?
Las variables se almacenan en el contacto que está conversando con el bot.
Esto significa que:
- Si un usuario vuelve a escribir, el bot recuerda sus datos.
- Se pueden usar en integraciones externas (API, CRM, formularios).
- Se pueden ver desde la sección de contactos (próxima sección de plataforma).
4️⃣ ¿Cómo se asigna un valor a una variable?
Las variables se completan automáticamente cuando:
A. El usuario ingresa información
Ejemplo:
Nodo “entrada de texto → guardar en variable → email”.
B. El usuario elige una opción
Ejemplo:
Menú de opciones → guardar la opción elegida en “opciondeseada”.
C. Una API devuelve información
Ejemplo:
Llamás a una API que devuelve un ID → lo guardás en “idPedido”.
D. El bot procesa elementos (archivo, audio)
Ejemplo:
Nodo “Subir archivo” → guarda el archivo en subir_archivo.
5️⃣ ¿Cómo usar una variable dentro de un mensaje?
Podés mostrar el valor de una variable dentro de un nodo de texto:
Ejemplo:
“Gracias {{name}}, ya registramos tu solicitud.”
La sintaxis es siempre:
{{nombreDeLaVariable}}
6️⃣ ¿Cómo usar variables para condicionar el flujo?**
Las variables permiten generar lógica dentro del árbol mediante nodos condicionales.
Ejemplos:
- Si edad > 18 → continuar a “Adultos”
- Si opciondeseada = ‘Compras’ → redirigir al área comercial
- Si calificacion <= 3 → enviar al bot de soporte
Esto transforma un chatbot básico en uno inteligente y contextual.
7️⃣ Variables y la IA: ¿cómo interactúan?
La IA de Ánima también puede usar variables en sus respuestas, por ejemplo:
- Para personalizar (“Hola {{name}}, esto es lo que encontré sobre tu consulta”).
- Para almacenar la intención detectada.
- Para completar pasos en flujos híbridos IA + árbol.
8️⃣ Buenas prácticas recomendadas
- Usar nombres cortos y sin espacios
- Definir una variable por cada dato relevante
- No reutilizar variables con diferentes propósitos
- Validar información crítica (email, teléfono, etc.)
- Limpiar variables cuando ya no se necesitan (opcional)
9️⃣ Ejemplos de uso real en bots
- Guardar datos personales para una encuesta.
- Capturar motivo de consulta para segmentar usuarios.
- Registrar calificaciones para medir satisfacción.
- Guardar archivos enviados para un trámite (DNI, comprobantes).
- Utilizar la opción elegida del menú para derivar el flujo.
