Registro de llamadas

El registro de tramos en Voice > Legs muestra cada conexión que tu espacio de trabajo realizó o recibió, de más reciente a más antigua. Una llamada puede contener varios tramos, como la conexión entrante y la reenviada. Cada entrada es un registro detallado de llamada (CDR), incluidas las conexiones que no fueron contestadas o fueron rechazadas. Úsalo para revisar la duración, la respuesta SIP final y el coste.

Bird escribe cada registro cuando el tramo termina, de modo que cada entrada del registro tiene un resultado final. La pestaña Live junto a él muestra los tramos que siguen activos.

Para ver la interacción completa, abre Voice > Calls. Una llamada agrupa tramos y participantes relacionados. Conserva el Call ID para correlación y el Leg ID cuando investigues una conexión; identifican registros distintos.

La lista de llamadas

Cada fila es un tramo. Una llamada con varios tramos tiene varias filas:

La lista está paginada, 25 tramos por página. Selecciona cualquier fila para abrir el registro del tramo.

Llamadas en curso

La pestaña Live muestra los tramos activos en este momento e incluye un contador para que veas cuántos hay sin abrirla. Un tramo activo tiene uno de dos estados:

Las columnas coinciden con el registro de tramos salvo Elapsed, que reemplaza a Duration. Cuenta desde la respuesta en un tramo conectado y desde el inicio en uno que está sonando. La pestaña se actualiza cada pocos segundos. Cuando un tramo termina, pasa al registro de tramos con su resultado final.

Búsqueda y filtros

La página comienza con una búsqueda por número y sus filtros. Se combinan: un filtro de estado más un rango de fechas muestra solo los tramos que cumplen ambos.

Buscar por número. El cuadro de búsqueda compara un número con cualquiera de los dos extremos del tramo, así que una sola consulta encuentra los tramos hacia él y los tramos desde él.

Direction. Filtra por tramos salientes o entrantes.

Status. Filtra por answered, no answer, failed, rejected o unknown. Cada uno se define en Estados. En la pestaña Live las opciones son ringing e in progress.

Date. En el registro de llamadas, elige un periodo predefinido (las últimas 24 horas, 7 días o 30 días) o selecciona un rango personalizado en el calendario.

Uso del mes

El resumen mensual contiene tres tarjetas para el mes calendario en curso en UTC:

La diferencia entre la duración total y el tiempo facturable es el tiempo de tono sin respuesta. Un tramo no contestado no tiene tiempo facturable.

La tarifa de cada destino redondea el tiempo facturable a su incremento de facturación. Consulta Coste y facturación para detalles de precios.

Estas tarjetas cubren el mes completo sin importar los filtros que apliques a la lista.

Estados

Un tramo en el registro terminó con uno de estos resultados:

Rejected abarca dos tipos de rechazo, y el motivo del rechazo los distingue. O bien Bird rechazó la llamada antes de que interviniera un operador, en cuyo caso el motivo indica la verificación que falló, o bien el extremo remoto la declinó directamente, en cuyo caso SIP response lleva su respuesta y no hay motivo. Una llamada entrante que el número marcado rechazó también aparece como Rejected sin motivo, porque no falló ninguna verificación: su Inbound route indica lo que el número estaba configurado para hacer. Consulta Llamadas rechazadas.

Una llamada que alcanzó el límite de duración de llamada de la plataforma, de 4 horas, figura como Answered, porque se conectó y terminó al alcanzar ese límite. Su tiempo facturable va desde que se contestó hasta el momento en que Bird colgó. Si la llamada ejecutó una secuencia, su cronología muestra Time limit reached como final del tramo.

Failed no es un rechazo. Significa que la llamada se intentó y no funcionó: un número ocupado es Failed con respuesta del operador 486, y uno no asignado es Failed con 404.

Si lees estos valores desde tus propias herramientas, haz coincidir los que manejas y trata cualquier otro como un estado que no manejas en lugar de un error. La lista también incluye busy y canceled, reservados para llamadas entrantes entregadas a tus propios números. Ninguno se emite aún, y ambos resultados se reportan como failed por ahora.

Inspeccionar una llamada

Al abrir un tramo puedes ver lo que Bird registró sobre esa conexión:

Inbound route aparece en llamadas entrantes y registra la ruta seleccionada. Una ruta de trunk en una llamada rechazada significa que la llamada no llegó a una respuesta activa. Recibir llamadas explica las rutas y lo que registra cada una.

Llamadas rechazadas

Una llamada rechazada fue denegada en lugar de cursarse, y dos situaciones distintas producen ese resultado.

Bird la rechazó antes de que interviniera un operador. Antes de marcar, Bird verifica el caller ID, el destino, los límites de la cuenta y el saldo del monedero, y rechaza la llamada si falla alguno de ellos. Tu sistema telefónico recibe SIP 503, mientras que el registro autenticado de la llamada guarda el motivo específico. Esto evita que llamantes no autenticados obtengan datos de la cuenta. Abre la llamada para ver la causa y un enlace al ajuste correspondiente.

El número marcado rechazó la llamada. Una llamada entrante a un número configurado para rechazar, o a un número sin ruta propia cuando la ruta predeterminada del espacio de trabajo es rechazar, se rechaza sin motivo alguno: no falló ninguna comprobación nuestra. Inbound route es lo que lo indica. Recibir llamadas detalla esos rechazos.

Los motivos siguientes son del primer tipo. Se aplican tanto a llamadas entrantes como salientes, porque los límites de la cuenta y el monedero se verifican en ambos casos.

Motivos que puedes corregir

Un marcador de campaña puede recibir calls_per_second_exceeded sin estar cerca del techo de llamadas simultáneas, así que comprueba cuál de los dos obtuviste antes de cambiar nada.

Motivos que Bird resuelve por ti

Estos corresponden al lado de Bird en la configuración. Contacta a soporte y cita el Leg ID del registro:

Cómo se lee un rechazo

Lee el estado y el motivo de rechazo juntos:

• Rejected con motivo de rechazo. Bird rechazó la llamada y el motivo identifica la comprobación que falló. El valor de SIP response es el 503 que recibió tu sistema telefónico. Aplica la solución de cuenta o enrutamiento indicada para ese motivo. En una llamada saliente, ese 503 incluye una cabecera X-BIRD-CALL-ID con el Leg ID del registro, para que puedas vincular el rechazo con su registro sin cotejar horas y números.
• Rejected 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 la rechazó, y Inbound route indica lo que ese número estaba configurado para hacer.
• Failed. La llamada se intentó y no funcionó; SIP response contiene el código que se recibió de vuelta. 486 significa ocupado y 404 significa que el número no está asignado. Esto suele apuntar al número, no a tu configuración.

Una llamada que Bird no puede admitir en absoluto se rechaza antes de que exista un registro, por lo que nunca llega al registro de llamadas. Solución de problemas de voz trata esas llamadas.

Obtener los registros

Cuatro formas de trabajar con estos registros fuera del panel:

• Exportar CSV. Download CSV, en la pestaña Leg log, exporta los registros que coinciden con tus filtros actuales en todas las páginas, hasta un máximo de 10.000 tramos. Una selección mayor devuelve un error sin generar un archivo; reduce el rango de fechas o ajusta los filtros y exporta cada selección por separado. El archivo incluye las duraciones y el tiempo facturable, pero no tiene una columna de coste. Consulta los cargos en Uso, gasto y facturas.
• Consultar los registros mediante la API. GET /v1/voice/legs y GET /v1/voice/legs/{leg_id} permiten consultar tramos individuales (GET /v1/voice/calls y GET /v1/voice/calls/{call_id} permiten las consultas de llamadas agrupadas que utilizan el panel y la CLI). Todas estas operaciones requieren una clave API con el ámbito voice y el nivel read. Consulta la referencia de la API para conocer las operaciones publicadas para otros recursos de Voice y los ámbitos que requieren.
• Consultar los registros desde el terminal. La Bird CLI ofrece bird voice calls list, bird voice calls get, bird voice legs list, bird voice legs get y bird voice stats. El servidor MCP pone las mismas consultas a disposición de los agentes.
• Suscribirse a los eventos. voice_call.initiated, voice_call.answered y voice_call.ended se envían a tu endpoint a medida que ocurren las llamadas, para que tus sistemas se mantengan actualizados sin consultas periódicas. Consulta Eventos de voz.

Siguientes pasos