Ir al contenido principal
Guías de plataformas DeepAgent

Variables dinámicas: cómo personalizar cada llamada

Cómo hacer que el agente diga el nombre, los datos y los importes de cada contacto utilizando las variables entre llaves dobles.

Escrito por Product

Última actualización Hace 4 meses

Las variables dinámicas permiten al agente decir cosas diferentes en cada contacto —su nombre, su número de expediente, el importe que le corresponde— en lugar de repetir el mismo texto idéntico a todo el mundo.

Siempre se escriben entre llaves dobles: {{nome_variabile}}. Cuando la llamada se realiza, el marcador de posición se sustituye por el dato real de ese contacto.


Dos tipos de variables

Tus variables. Provienen de las columnas del archivo de contactos (CSV o Google Sheet) que subes para la campaña. Tú eliges el nombre: si la columna se llama «nome_cliente», en el script escribes «{{nome_cliente}}».

Las variables ya preparadas. Están disponibles sin necesidad de cargarlas y tienen nombres predefinidos en inglés. No se pueden renombrar: deben invocarse exactamente con su nombre. Hay dos tipos, que se explican a continuación.


Variables para personalizar la conversación

Son las que utilizarás con más frecuencia. Las encontrarás en el «Variable Manager» y son configurables.

  • {{agent_name}} — nombre del agente

  • {{user_name}} — nombre de la persona con la que habla

  • {{company_name}} — nombre de tu empresa

  • {{user_email}} — correo electrónico del contacto

  • {{user_phone}} — Teléfono del contacto

  • {{current_date}} — fecha actual

  • {{current_time}} — hora actual

💡 {{current_date}} y {{current_time}} son útiles para que el agente diga cosas como «te llamaré mañana» sin tener que actualizarlo manualmente.

Variables del sistema

Son variables técnicas que la plataforma asigna automáticamente en cada llamada. No tienes que configurarlas tú: sirven sobre todo para informes e integraciones.

  • {{system__agent_id}} — ID del agente que inició la conversación

  • {{system__current_agent_id}} — ID del agente actual (cambia tras una transferencia entre agentes)

  • {{system__caller_id}} — Número desde el que se ha realizado la llamada

  • {{system__called_number}} — Número al que se ha llamado

  • {{system__call_duration_secs}} — Duración de la llamada en segundos

  • {{system__time}} — hora local

  • {{system__time_utc}} — marca de tiempo UTC

  • {{system__timezone}} — zona horaria

  • {{system__conversation_id}} — ID de la conversación

  • {{system__call_sid}} — identificador técnico de la llamada por parte del operador telefónico


Un ejemplo

El archivo de contactos tiene las columnas «nome_cliente», «numero_pratica» y «importo_dovuto». En el script, escribe:

«Buenos días, {{nombre_cliente}}, le llamo en relación con el expediente {{número_expediente}}...»

Durante la llamada, el agente dirá el nombre y el número de expediente de ese contacto concreto.


Cómo configurarlas

  1. Prepara el archivo con encabezados claros. Utiliza «nome_cliente», no «Columna A»: te servirá para reconocerlas durante la asignación.

  2. Asigna las columnas al cargar los contactos. Los campos estándar (nombre, teléfono, correo electrónico, empresa) se asignan automáticamente; los demás se convierten en campos personalizados del contacto.

  3. Recurre a la variable en el script con la sintaxis {{ }}.


Si la variable no se asigna

Si, durante la llamada, el agente lee el marcador de posición en lugar del dato, o se salta este:

  • El nombre no coincide. Es la causa más frecuente: el nombre escrito en el script debe coincidir exactamente con el asignado, incluyendo mayúsculas, minúsculas y guiones bajos. {{Nome_Cliente}} y {{nome_cliente}} no son la misma variable.

  • Has utilizado un solo paréntesis. Se necesitan comillas dobles: {{nome}}, no {nome}.

  • Esa entrada de contacto tiene la celda vacía. La variable existe, pero no hay datos para ese contacto: comprueba el archivo.

  • Estás utilizando una variable del sistema con un nombre propio. Las variables del sistema deben invocarse con su nombre original en inglés.


Artículos relacionados

  • Cómo utilizar el Gestor de contactos

  • Cómo probar tu agente antes de lanzarlo