Variables del prompt y referencias a herramientas

Usa $ para insertar variables (como el nombre del contacto) y ! para referenciar acciones dentro de las instrucciones de tu agente.

Jun 26, 2026

Mira este paso en el video · Instrucciones: el editor

Las instrucciones de tu agente no tienen que ser texto estático. En el editor de Instrucciones puedes insertar variables que se rellenan solas con datos del contacto y referenciar las acciones (herramientas) que el agente puede ejecutar.

Los dos atajos del editor

En la pestaña Instrucciones, mientras escribes el prompt:

  • Escribe $ para insertar una variable (por ejemplo el nombre del contacto).
  • Escribe ! para insertar una referencia a una acción (una herramienta del agente).

Al teclear cualquiera de los dos, aparece un autocompletado con las opciones disponibles. Elige una y queda como una "píldora" dentro del texto.

Variables más usadas

Las variables se agrupan por origen. Algunas frecuentes:

  • $contact.first_name — Nombre del contacto
  • $contact.last_name — Apellido
  • $contact.email — Email
  • $contact.phone — Teléfono
  • $contact.language — Idioma del contacto
  • $workspace.name — Nombre del workspace
  • $conversation.channel_type — Tipo de canal

En tiempo real, $contact.first_name se reemplaza por el nombre real de la persona. Si el dato está vacío, el agente simplemente lo omite.

Cómo insertar una variable

  1. Abre el agente y entra a la pestaña Instrucciones.
  2. Posiciona el cursor donde quieres el dato.
  3. Escribe $ y empieza a tipear (ej.: nombre).
  4. Elige la variable del listado (ej.: Nombre).
  5. Guarda los cambios.

Ejemplo: Saluda al cliente por su nombre: $contact.first_name.

Cómo referenciar una acción

Las acciones son las herramientas que ya configuraste en la pestaña Acciones personalizadas (agendar una cita, etiquetar un contacto, crear una oportunidad, etc.).

  1. En el editor de Instrucciones, escribe !.
  2. Elige la acción del autocompletado.
  3. Explica cuándo debe usarla: "Si el cliente quiere una visita, usa !agendar_cita".

Referenciar la acción no la ejecuta: le dice al agente que esa herramienta existe y en qué momento conviene usarla.

Verificación

  1. Ve a la pestaña Sandbox.
  2. Escribe un mensaje que active el dato o la acción.
  3. Revisa el Trace: ahí ves los valores reales que se inyectaron y qué herramienta llamó el agente.

Si no funciona

  • La variable sale vacía: ese contacto no tiene ese dato cargado; prueba con un contacto completo.
  • No aparece el autocompletado: asegúrate de escribir $ o ! como primer carácter del token, sin espacio antes.
  • La acción no se ejecuta: confirma que esté creada y activa en Acciones personalizadas; si la borraste o renombraste, la referencia en el prompt queda rota.

Consejos

  • Personalizar con $contact.first_name sube muchísimo la sensación de atención humana.
  • No abuses de las acciones: referencia solo las que el agente realmente necesita para esa conversación.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp