Solución de problemas de Voice

Empieza por el registro de llamadas. La presencia de un registro y sus campos determinan qué comprobaciones seguir.

Para las llamadas iniciadas mediante la API, comprueba primero la respuesta de Create Call y el historial de ejecuciones. Sigue la guía de solución de problemas de secuencias para la vista previa, la publicación, las rutas del teclado y las rutas de secuencias entrantes. Las comprobaciones de conexión siguientes se refieren a llamadas mediante trunks SIP.

Si no ves ningún registro de llamada, comprueba primero lo siguiente:

1. Estás en el espacio de trabajo correcto. Los registros de llamadas pertenecen al espacio de trabajo que contiene el número o el trunk. Cambia a ese espacio de trabajo y abre Voice > Legs.
2. La llamada llegó a Bird. En una llamada entrante, el operador de quien llama decide adónde va la llamada, y un número que apunta a un trunk sin gateway guardado rechaza la llamada antes de que exista un registro. En una llamada saliente, consulta Una llamada saliente no aparece en el registro de llamadas: una admisión rechazada no deja registro.
3. Los filtros no la ocultan. Borra el filtro de estado y amplía el intervalo de fechas.

Una llamada saliente no aparece en el registro de llamadas

En una llamada realizada a través de un trunk SIP, un fallo de admisión puede ocurrir antes de que exista un registro de tramo. Comprueba estas causas habituales:

• El trunk aún no admite llamadas salientes. Un trunk nuevo no cursa llamadas hasta que activas las llamadas salientes en su página, y rechaza todos los intentos mientras no lo hagas, sin importar las credenciales que presente la llamada.
• El trunk aún no tiene forma de reconocerte. Un trunk nuevo rechaza todas las llamadas hasta que añades un rango de IP, una clave API permitida o credenciales de sesión.
• La llamada llegó desde una dirección fuera de la lista de IP permitidas del trunk. Detrás de NAT, compara la dirección pública del router con la lista de IP permitidas del trunk. La dirección privada del sistema telefónico no llega a Bird.
• El desafío de contraseña falló. Comprueba que el nombre de usuario sea bird. La contraseña debe ser el secreto de una clave API permitida o una credencial de sesión no expirada. El trunk también debe ofrecer el algoritmo Digest que usó tu sistema telefónico.
• La llamada se dirigió a un dominio SIP que Bird no reconoce. Tu equipo debe poner el dominio SIP del trunk en el host del Request-URI. Copia el dominio completo desde la página del trunk en lugar de componerlo. Una llamada dirigida a otro nombre de host o dirección Bird no llega a tu trunk.

Lo que recibe tu equipo indica qué comprobación falló. 407 Proxy Authentication Required significa que el trunk pide una contraseña; con las credenciales de sesión activadas, se la pide a todos los llamantes. 403 Forbidden significa que el trunk no admitió la llamada: un host del Request-URI que no es el dominio SIP de tu trunk, las llamadas salientes desactivadas, una dirección fuera de la lista de permitidas o una contraseña que no se verificó. 503 Auth Unavailable significa que Bird no pudo comprobar la llamada, así que vuelve a reintentarla.

Para una llamada de secuencia, comprueba primero si se aceptó la solicitud de llamada y si existe una ejecución. La vista previa del simulador no realiza llamadas. Una prueba real requiere un borrador guardado o una publicación activa, permisos de escritura de administración y llamadas de Voice, un identificador de llamante elegible y un destino habilitado. La guía del constructor de secuencias explica estas comprobaciones.

La llamada se rechaza con un motivo de rechazo

Bird rechazó la llamada antes de marcar a un operador, y el motivo indica la comprobación que no superó. Abre la llamada y usa el enlace del panel de rechazo hacia el ajuste correspondiente. Llamadas rechazadas enumera cada motivo y su solución.

caller_id_not_verified es el que más afecta a un cliente nuevo, normalmente porque el cliente pone el nombre de usuario digest donde va el caller ID: son campos diferentes.

La llamada tiene estado fallido en lugar de rechazado

Failed no es un rechazo. La llamada se intentó y no funcionó, y SIP response lleva el código que se devolvió. Un 486 es un número ocupado; un 404, uno no asignado. Esto suele apuntar al número que marcaste, no a tu configuración.

Una llamada que Bird rechazó aparece como Rejected, no Failed, así que filtra el registro por Rejected cuando busques una llamada que no superó una de las comprobaciones de Bird.

La llamada se rechaza sin motivo de rechazo

En una llamada saliente, el extremo remoto la declinó directamente y SIP response lleva su código.

En una llamada entrante, el número marcado rechazó la llamada, lo que no falla ninguna comprobación y por tanto no indica ningún motivo. Abre la llamada y lee Inbound route: una ruta reject es un número configurado para rechazar, o uno sin ruta propia mientras la ruta predeterminada del espacio de trabajo es rechazar. Recibir llamadas recorre cada rechazo entrante a partir de su ruta y motivo.

La persona a la que llamaste vio un número diferente

La llamada tiene un registro y ningún motivo de rechazo, así que superó todas las comprobaciones que hace Bird. Lo que falló está más allá de Bird: el operador de terminación reemplazó el caller ID o rechazó una llamada que lo presenta. La misma causa se manifiesta como un número que conecta en un país y nunca conecta en otro.

La verificación demuestra que controlas un caller ID. No obliga al operador que entrega la llamada a aceptarlo, y los operadores aplican sus propias reglas nacionales a un número que no se adquirió a través de Bird. Consulta la exención de responsabilidad sobre verificación y entrega de CLI para conocer las prácticas implicadas, que incluyen requisitos de CLI en el país, bloqueo basado en origen y listas de no originar.

Para saber qué tipo de número presentaste, ábrelo en Voice > Numbers y lee el panel en la parte superior de su página. Un número que compraste a Bird muestra su suscripción, igual que uno que compraste y también verificaste. Solo un número que posees en otro lugar muestra únicamente una verificación. Una suscripción significa que el número se adquirió a través de Bird, por lo que la exención de responsabilidad no lo rige. Presentar un número adquirido a través de Bird es lo que eleva las tasas de entrega y completación en los destinos que rechazan uno verificado.

Una llamada entrante nunca llega a tu sistema telefónico

El número contestó la llamada y lo que falló fue la entrega. Comprueba en este orden:

1. Lee la ruta de entrada de la llamada. Indica a qué trunk o reenvío apuntaba el número cuando llegó la llamada. Una ruta reject significa que el número tiene su propia ruta configurada para rechazar, o que no tiene ruta propia y la ruta predeterminada del espacio de trabajo es rechazar. Abre el número para ver cuál es el caso: un número configurado para rechazar ignora la ruta predeterminada. Un número cuyo trunk se eliminó o tiene las llamadas entrantes desactivadas vuelve a la ruta predeterminada, y una ruta predeterminada que nombre ese trunk vuelve a rechazar.
2. Comprueba que el trunk pueda entregar. Abre Inbound routing del trunk. Un gateway debe estar en un grupo, y la Default route (o una regla) debe enviar las llamadas a ese grupo. Una ruta predeterminada configurada como Reject rechaza todas las llamadas sin motivo de rechazo, y un trunk sin gateway guardado rechaza la llamada antes de que exista un registro. Corrige el aviso Calls never reach some gateways si el panel lo muestra al guardar.
3. Comprueba la dirección del gateway. Bird marca los gateways del grupo en el orden que fija el grupo y se rinde cuando ninguno contesta. Confirma el host del URI SIP, su puerto y que tu sistema telefónico acepta llamadas de Bird en él.
4. En un reenvío, comprueba que el destino siga verificado. El destino del reenvío se vuelve a comprobar en cada llamada, por lo que un caller ID que eliminaste deja de reenviar a partir de ese momento.
5. Comprueba la respuesta de tu equipo. Una llamada que llegó a tu gateway y se rechazó allí suele aparecer como Failed (una respuesta 6xx aparece como Rejected), y SIP response lleva el código de tu equipo, como 403 o 412. Bird intentó la llamada, así que la solución está de tu lado: comprueba que tu SBC acepta llamadas de las direcciones de señalización de Bird y el formato de número que envía el gateway.

Si el número usa Run a sequence, inspecciona la secuencia vinculada y la entrada de llamada en lugar del trunk. Confirma una publicación activa, una entrada que acepte datos vacíos y si la persona que llama es un tester de borrador. Revisa el resultado de ejecución de la secuencia y la rama de fallo. Cambiar un borrador no cambia la versión que usan las personas que llaman normalmente.

El teléfono del navegador no suena o no puede marcar

Comprueba primero el estado en la parte inferior del teléfono:

1. Elige Online para recibir llamadas. Un grupo de timbre omite a los miembros que están en Offline, Busy, ya en una llamada o en Not accepting calls tras tres llamadas perdidas seguidas. Tu estado explica cada uno.
2. Ponte en línea para marcar. Un teléfono en Offline no puede realizar llamadas. Con Online, Busy y Not accepting calls sí puede.
3. Trae las llamadas a este navegador. En cada espacio de trabajo, solo puedes estar en línea en un dispositivo y en una pestaña a la vez. Offline · Active on another device ofrece Take over, y Offline · Calls are handled in another tab ofrece Use here.
4. Comprueba el límite de usuarios en línea. Offline · Limit of users online reached significa que tu organización ya tiene en línea tantos usuarios como permite. Consulta Límite de usuarios en línea.
5. Activa el sonido. Después de recargar la página, tu navegador puede bloquear el tono de llamada hasta que interactúes con ella. En ese caso, el menú de estado ofrece Turn on sound.

Si el teléfono está en línea y una llamada sigue sin sonarte, lee la Inbound route de la llamada en el registro de llamadas. Indica el grupo de timbre en el que sonó la llamada, así puedes comprobar que eres miembro y que el número dirige las llamadas a ese grupo.

Tu cliente responde con MD5 y no avanza

Algunos equipos manejan mal un desafío que empieza con SHA-256. Configura el trunk como solo MD5.

Las llamadas conectan pero el audio es en un solo sentido

Tu cliente está detrás de NAT y su media se dirige a una dirección privada. Activa el manejo de NAT o STUN en el cliente.

Si tu equipo es accesible y el audio sigue fallando en un sentido, comprueba que tu firewall permita las direcciones de media de Bird en los puertos UDP del 2500 al 32499.

Próximos pasos