Ordenadas por frecuencia, no por gravedad. Cada comprobación de abajo nombra la pantalla que mirar, porque «no funciona» es casi siempre una de cuatro pantallas contradiciéndose entre sí.
1. El número contesta, pero no es tu agente
El caso más común y el más difícil de ver, porque la llamada funciona. Un número conectado contesta antes de que nada esté vinculado a él — un agente de prueba descuelga y suena bien.
La comprobación: llama al número y espera Lo primero que dice su agente. Oír cualquier otra cosa significa que el número no está vinculado a tu agente.
El arreglo: en /phone-numbers, el número debería decir «… atiende este canal» con el nombre de tu agente. En /agents, la sección Implementación debería decir Se implementó en … en lugar de Sin implementar o Sin canal de voz. Corrige el que esté mal.
2. La prueba de micrófono funciona y el teléfono no
Prueban cosas distintas, y pasar la primera no prueba nada sobre la segunda. /agents lo dice sin rodeos: “WebRTC funciona para pruebas en el navegador. Las rutas telefónicas necesitan un número.”
Iniciar prueba de micrófono ejercita al agente. No ejercita el número, la vinculación ni el operador. Si la prueba de micrófono va bien y las llamadas no, el problema está en el camino telefónico: vuelve a la comprobación 1.
3. El agente contesta pero no sabe nada
No es una avería. Un agente sin conocimiento adjunto contesta correctamente e inútilmente.
La comprobación: /agents/knowledge. Si está vacío, esa es tu respuesta — “Cree primero un agente y luego agregue conocimiento para fundamentarlo.”
Añade horarios, precios, servicios y ubicación, y vuelve a pasar la prueba de micrófono. Es el arreglo con la mayor rentabilidad de la lista, y no es un parte de fallos.
4. La llamada conecta y luego falla
Mira /conversations y encuentra la llamada. El resultado te dice qué mitad se rompió:
| Lo que ves | Qué significa |
|---|---|
| Perdida / Sin respuesta | Nunca llegó al agente |
| Conectada | Llegó al agente y se ejecutó |
| Interrumpida | ”Conectada, pero quien llamó colgó antes de que el agente terminara.” |
| Con error | La llamada en sí falló |
La Cronología de la llamada muestra las fases — Conectando, Sonando, EN VIVO, Finalizando — para que veas hasta dónde llegó antes de parar.
Una racha de Con error justo después de cambiar de operador suele significar que el operador rechazó la llamada: “El operador no aceptó la llamada. Reinténtelo en un momento.” Revisa el Formato de marcación del número — un operador que espera formato nacional rechaza E.164, y la configuración se guardó sin quejas.
5. Funciona, pero no se registra nada
Las llamadas ocurren y, después, no hay nada estructurado que mirar.
La comprobación: /dialog-insights. Un insight que muestra Sin vincular nunca se ejecuta — “Un insight de conversación solo se ejecuta en conversaciones de un agente o campaña al que esté vinculado.” Guardar y vincular son acciones distintas.
Revisa también el campo en sí: “Un insight de conversación sin campos nunca produce un resultado.”
6. La voz cambió sola
No cambió sola, pero un cambio de pipeline lo provoca. Los pipelines en tiempo real traen sus propias voces y el estándar usa las de tu proveedor de texto a voz, así que cambiar de Pipeline te deja en silencio eligiendo de una lista que no contiene la que tenías. Consulta los pipelines de voz.
7. Dejó de funcionar después de que pausaras algo
Pausar o archivar un agente deja de hacerlo contestar y deja de hacerlo llamar. Si una campaña con ese agente está en marcha, se agota con cada llamada restante saltada y etiquetada, en lugar de marcar en nombre de un agente que tú crees apagado.
Si no es ninguna
Llama al número desde un teléfono que nunca lo haya llamado y mira /conversations mientras lo haces. Si no aparece ninguna conversación, nada llegó hasta nosotros y el problema está antes de Octo — el número, su enrutamiento o el operador.