Solución de problemas

Empieza siempre por el historial de llamadas. Una llamada Fallida muestra el motivo debajo del estado. El detalle de la llamada enseña la transcripción, los tiempos de respuesta y lo que devolvió cada herramienta.

Publicación y acceso

Síntoma	Causa y solución
El agente aparece como Sin configurar	Al flujo le falta algo para publicarse, normalmente el Agent Name o un conector obligatorio (Model, STT, TTS).
Las llamadas reales no usan mis cambios	Usan la versión publicada. Despliega una versión nueva del flujo y pulsa Actualizar publicación.
El botón Widget está desactivado	El agente no está publicado.
Una transferencia a otro agente no funciona	El agente de destino no está publicado. Publícalo.
Tu aplicación no consigue abrir una llamada	Revisa la clave API, que el identificador del agente es el que muestra Cuerpo de la petición y que el agente está publicado con Enabled activado.

Teléfono

Síntoma	Causa y solución
La llamada no llega	El operador no envía las llamadas a la dirección SIP de NappAI, o sus direcciones IP no están en IPs del proveedor del trunk de entrada.
Suena pero nadie contesta	El número no está en Números que atiende en formato internacional, por ejemplo +34910000000, o el agente no está publicado por Teléfono (SIP).
No puede transferir a un teléfono ni llamar	No hay trunk de salida, o no está elegido al publicar. Revisa también Usuario y Contraseña del trunk con tu operador.
La persona llamada ve otro número	Revisa Números que puede mostrar del trunk de salida, o Caller number en Outbound Call. El operador solo deja mostrar los números que son tuyos.

Conversación

Síntoma	Causa y solución
No usa una herramienta	La descripción de la herramienta no deja claro cuándo usarla. Mejórala y dilo también en el prompt.
Se inventa datos	Pide en el prompt que use siempre la herramienta y que diga que no lo sabe cuando no encuentre nada.
Lee mal cifras o teléfonos	Pide en el prompt que los diga en grupos y despacio.
Responde a voces de fondo o a la tele	Deja Ignore Other Voices activado y prueba Other Voices: How Strict en strict. Consulta Calidad, ruido y latencia.
Se calla solo mientras habla	Un ruido que parece voz. Sube Minimum Duration To Interrupt o Speech Sensitivity.
Se oye a sí mismo	El llamante usa el altavoz. Activa Echo Cancellation o recomienda auriculares.
Cuelga demasiado pronto	Revisa Inactivity Before Hanging Up y Maximum Call Duration. Si cuelga el agente, mira en el historial el motivo que dio al colgar y ajusta el prompt.
No cuelga nunca	Falta Hang Up Call en Tools, o el prompt no dice cuándo colgar.
Usa una herramienta sin los datos que necesita	Marca como obligatorios en la herramienta los datos que necesita para funcionar. Consulta Voice Agent.
Repite una pregunta justo después de usar una herramienta	Haz que la herramienta devuelva los datos junto a cualquier indicación para el agente, y di en esa indicación qué debe contar al llamante.
Lee en voz alta notas que eran solo para él	Separa en el resultado de la herramienta lo que es para el llamante de lo que es una indicación para el agente, o prueba con otro modelo.
En Ejecuciones aparecen herramientas que no se usaron	Cada vez que el agente usa una herramienta, se preparan todos los componentes conectados al Voice Agent. Las herramientas que se usaron de verdad son las que muestran entrada y salida de herramienta.

Rendimiento

Síntoma	Causa y solución
Tarda en contestar	Mira los tiempos en el detalle de la llamada. Si la espera está en la respuesta del agente, cambia a un modelo más rápido o baja su razonamiento. Consulta Latencia.
Las primeras palabras tardan	Pon Quality de Supertonic en 4 steps — Fast, o usa Pocket TTS (solo en español) o Piper.
La llamada se corta por un error del proveedor	Credencial sin saldo, modelo retirado o límite de uso. Arregla el componente, o activa Fallback Engines para que un segundo motor tome el relevo.