Usa Valores Personalizados y fuentes de variables integradas para hacer tus flujos del Estudio de Agentes IA dinámicos, reutilizables y escalables. En vez de escribir manualmente detalles del negocio o información de contacto en cada nodo, puedes insertar marcadores inteligentes que extraen datos reales automáticamente cuando tu agente se ejecuta.

Te permiten insertar información real en tu agente automáticamente. Una variable es un marcador escrito dentro de llaves dobles, como {{contact.first_name}}, que se reemplaza con datos reales cuando el agente se ejecuta.

Por ejemplo: "Hola {{contact.first_name}}" — si el nombre del contacto es Juan, el mensaje se convierte en "Hola Juan".

Puedes usar variables en cualquier lugar donde escribas texto dentro del Estudio de Agentes IA: indicaciones de Agente IA, nodos de Generación de Texto, entradas de herramientas, tarjetas de mensaje, y campos de lógica condicional. Solo haz clic en la flecha desplegable del campo de texto para insertar una variable, o escríbela manualmente usando {{ }}.

El Estudio de Agentes IA incluye cinco categorías de variables integradas: Cuenta, Valores Personalizados, Ahora Mismo, Datos de Formulario, y Contacto. Cada categoría extrae información de una parte distinta de tu sistema.

Son pares de clave-valor reutilizables que defines en Configuración → Valores Personalizados. Los creas una vez y los usas en cualquier lugar.

Ejemplo: Clave: correo_soporte, Valor: [email protected]. Luego, dentro de tu agente: "Para ayuda, escribe a {{custom_values.correo_soporte}}". Si actualizas el valor después, se actualiza automáticamente en todos los lugares donde se usa la variable.

💡 Los workflows que usan la acción de Agente IA pueden actualizar valores personalizados directamente con la herramienta "Actualizar Valor Personalizado", permitiendo que el agente escriba valores basados en contexto durante la ejecución, en vez de depender solo de ramas fijas del workflow.

Extraen información del negocio desde la configuración de tu cuenta. Úsalas cuando tu agente necesite referenciar nombre del negocio, teléfono, dirección, sitio web, o URL del logo.

Ejemplo: "Bienvenido a {{account.name}}. Llámanos al {{account.primary_phone}}."

Insertan información de fecha y hora en vivo: fecha completa de hoy, hora actual, día de la semana, mes o año.

Ejemplo: "Hoy es {{right_now.date}}." El sistema inserta automáticamente la fecha correcta según la zona horaria de tu cuenta.

Están disponibles cuando tu agente se dispara por un evento de "Envío de Formulario". Cada campo del formulario queda disponible como variable.

Ejemplo: si tu formulario tiene un campo "tipo_servicio", puedes usar: "Seleccionaste {{form.tipo_servicio}}"

⚠️ Importante: las variables de formulario solo se llenan cuando el agente se dispara por un envío de formulario.

Extraen información directamente del registro del CRM. Permiten campos estándar y personalizados para una personalización profunda.

Ejemplos: {{contact.first_name}}, {{contact.last_name}}, {{contact.email}}, y campos personalizados de contacto. Si el registro del contacto se actualiza, la próxima vez que el agente se ejecute usará la información actualizada.

Si la información ya existe en el registro del contacto antes de que empiece la conversación, usa variables de Contacto. Si el valor se recolecta durante la conversación, usa variables en tiempo de ejecución.

Paso 1: Crea Valores Personalizados. Ve a Configuración → Valores Personalizados y selecciona Agregar Valor Personalizado. Ingresa un Nombre y Valor, luego haz clic en Crear.

Paso 2: Abre el Estudio de Agentes IA. Ve a Agentes IA → Estudio de Agentes IA y abre un agente existente o crea uno nuevo.

Paso 3: Inserta una Variable. Haz clic dentro de cualquier campo de indicación o mensaje. Haz clic en la flecha desplegable del campo, o escribe {{ manualmente. Elige una categoría: Cuenta, Valores Personalizados, Ahora Mismo, Datos de Formulario, o Contacto. Haz clic en una variable para insertarla.

📝 Nota: algunos nodos, como los pasos de Llamada a API, generan variables en tiempo de ejecución según su resultado. Estas variables pueden reutilizarse en pasos posteriores seleccionándolas desde el selector de variables.

Paso 4: Guarda y Prueba. Haz clic en Guardar. Haz clic en Probar. Ejecuta una conversación de muestra. Confirma que las variables se resuelvan correctamente. Si un valor aparece en blanco, verifica que el dato correspondiente exista en el CRM o en la configuración de tu cuenta.

Paso 5: Publica. Una vez que todo funcione correctamente, promueve el agente a Producción.