🏷️ Valores Personalizados en los Prompts de IA de Voz
Los Valores Personalizados son campos dinámicos que insertan datos guardados en CRMHUB directamente en el prompt o en los mensajes de tu Agente de IA de Voz. Con ellos, el agente puede mencionar el nombre del contacto, el negocio, una cita o datos de la cuenta durante la llamada, sin que tengas que editar el prompt manualmente para cada caso.
📋 Contenido de este Tutorial
✅ ¿Qué son los Valores Personalizados?
🛠️ Cómo insertar un Valor Personalizado
💬 Ejemplos prácticos
✅ Buenas prácticas
🛠️ Solución de problemas
❓ Preguntas frecuentes
✅ ¿Qué son los Valores Personalizados?
Cuando el prompt de un agente incluye un Valor Personalizado, como {{location.name}}, CRMHUB reemplaza automáticamente ese campo con el dato correspondiente del registro durante la llamada. Si el dato no existe para ese contacto, el campo puede aparecer vacío, por lo que es importante darle al agente una instrucción de respaldo para esos casos.
🛠️ Cómo insertar un Valor Personalizado
Ve a Agentes IA > IA de Voz.
Selecciona o crea un agente desde la Lista de Agentes.
Abre la pestaña Build.
Ubica el campo de prompt o mensaje donde quieres insertar el valor.
Haz clic en el botón o ícono de Valor Personalizado.
Busca o navega por categorías (Contacto, Empresa, Cita, Calendario, Cuenta, Ubicación).
Selecciona el valor que necesitas; se insertará como un campo de combinación (por ejemplo,
{{contact.first_name}}).Revisa que el texto alrededor suene natural al leerse en voz alta.
Guarda y prueba con el panel de prueba de audio.
💬 Ejemplos prácticos
Mensaje de bienvenida: "Gracias por llamar a
{{location.name}}. ¿En qué puedo ayudarte?"Contexto del negocio: "Te contacto en nombre de
{{location.name}}."Confirmación de cita: referencia la fecha y hora de la cita cuando el dato esté disponible en el registro.
✅ Buenas prácticas
Úsalos con moderación: evita colocar varios valores personalizados en una sola frase.
Agrega instrucciones de respaldo para cuando el dato esté vacío o no exista.
Cuida que la frase suene natural al ser leída en voz alta por el agente.
Evita usarlos para leer en voz alta IDs técnicos o códigos internos.
Reserva la Base de Conocimientos para información factual general, y los Valores Personalizados para datos específicos de cada registro.
Prueba el agente tanto con datos completos como con campos vacíos antes de publicarlo.
🛠️ Solución de problemas
El valor no se completa: verifica que el dato exista en el registro relacionado.
El agente lee el campo de combinación tal cual (sin reemplazar): confirma que lo insertaste desde el menú de Valor Personalizado y no escribiéndolo manualmente.
El valor aparece vacío: agrega una instrucción de respaldo en el prompt para ese escenario.
El valor aparece en un momento incorrecto de la llamada: aclara en el prompt el contexto exacto en el que debe usarse.
❓ Preguntas frecuentes
¿Puedo usar Valores Personalizados en cualquier campo del agente? Están disponibles en los campos de prompt y mensajes compatibles del constructor de agentes.
¿Qué pasa si el dato no existe para un contacto? El campo puede quedar vacío; por eso se recomienda incluir instrucciones de respaldo en el prompt.
¿Cómo pruebo que un Valor Personalizado funciona bien? Usa el panel de prueba de audio con contactos que tengan el dato completo y con otros que no lo tengan.