Registro de chamadas

O registro de trechos em Voice > Legs lista cada conexão que seu espaço de trabalho realizou ou recebeu, da mais recente para a mais antiga. Uma chamada pode conter vários trechos, como as conexões de entrada e de encaminhamento. Cada entrada é um registro detalhado de chamada (CDR), incluindo conexões que expiraram ou foram recusadas. Use-o para verificar duração, a resposta SIP final e custo.

Bird grava cada registro quando o trecho termina, então cada entrada no log tem um resultado final. A aba Live ao lado dele mostra os trechos que ainda estão ativos.

Para a interação completa, abra Voice > Calls. Uma chamada agrupa trechos e participantes relacionados. Use o Call ID para correlação e o Leg ID ao investigar uma conexão; eles identificam registros diferentes.

A lista de chamadas

Cada linha é um trecho. Uma chamada com vários trechos tem várias linhas:

A lista é paginada, com 25 trechos por página. Selecione qualquer linha para abrir o registro do trecho.

Chamadas ao vivo

A aba Live lista os trechos ativos neste momento e exibe um contador para que você veja quantos estão ativos sem precisar abri-la. Um trecho ativo tem um de dois status:

As colunas são as mesmas do registro de trechos, exceto por Elapsed, que substitui Duration. Ele conta a partir do atendimento para um trecho conectado e a partir do início para um trecho tocando. A aba é atualizada a cada poucos segundos. Quando um trecho termina, ele passa para o registro de trechos com seu resultado final.

Pesquisa e filtragem

A página começa com uma busca por número e seus filtros. Eles se combinam: um filtro de status mais um intervalo de datas restringe aos trechos que correspondem a ambos.

Busca por número. A caixa de busca compara um número com qualquer lado do trecho, então uma única consulta encontra os trechos para ele e os trechos vindos dele.

Direction. Filtre por trechos outbound ou inbound.

Status. Filtre por answered, no answer, failed, rejected ou unknown. Cada um está definido em Status. Na aba Live, as opções são ringing e in progress.

Date. No registro de chamadas, escolha um período predefinido (últimas 24 horas, 7 dias ou 30 dias) ou selecione um intervalo personalizado no calendário.

Uso neste mês

O resumo mensal contém três blocos para o mês calendário atual em UTC:

A diferença entre a duração total e o tempo faturável é o tempo de toque sem atendimento. Um trecho não atendido não tem tempo faturável.

A tarifa de cada destino arredonda o tempo faturável para seu incremento de cobrança. Veja Custo e cobrança para detalhes de preço.

Esses blocos cobrem o mês inteiro independentemente do que você filtre na lista.

Status

Um trecho no log terminou com um destes resultados:

Rejected abrange duas recusas, e o motivo da rejeição as diferencia. Ou Bird recusou a chamada antes de uma operadora estar envolvida, e nesse caso o motivo identifica a verificação que falhou, ou o lado remoto a recusou diretamente, e nesse caso SIP response traz a resposta e não há motivo. Uma chamada recebida que o número discado rejeitou também aparece como Rejected sem motivo, porque não falhou em nenhuma verificação: seu Inbound route diz o que o número estava configurado para fazer. Veja Chamadas rejeitadas.

Failed não é uma recusa. Significa que a chamada foi tentada e não funcionou: um número ocupado é Failed com resposta da operadora 486, e um não alocado é Failed com 404.

Se você lê esses valores a partir das suas próprias ferramentas, trate os que você reconhece e considere qualquer outro como um status que você não trata, em vez de um erro. A lista também inclui busy e canceled, reservados para chamadas recebidas entregues aos seus próprios números. Nenhum dos dois é emitido ainda, e ambos os resultados são reportados como failed hoje.

Inspecionando uma chamada

Abrir um trecho mostra o que Bird registrou sobre aquela conexão:

Inbound route aparece em chamadas recebidas e registra a rota selecionada. Uma rota trunk em uma chamada rejeitada significa que a chamada não chegou a um atendimento funcional. Recebendo chamadas explica as rotas e o que cada uma registra.

Chamadas rejeitadas

Uma chamada rejeitada foi recusada em vez de completada, e duas situações diferentes produzem isso.

Bird a recusou antes de uma operadora estar envolvida. Antes de discar, Bird verifica o caller ID, o destino, os limites da conta e o saldo da carteira, e recusa uma chamada que falha em algum deles. Seu sistema telefônico recebe SIP 503, enquanto o registro autenticado da chamada armazena o motivo específico. Isso impede que chamadores não autenticados obtenham detalhes da conta. Abra a chamada para ver a causa e um link para a configuração relevante.

O número discado rejeitou a chamada. Uma chamada recebida para um número configurado para rejeitar, ou para um número que ninguém apontou para lugar nenhum, é rejeitada sem motivo algum: ela não falhou em nenhuma verificação nossa. Inbound route é o que indica isso. Recebendo chamadas detalha essas recusas.

Os motivos abaixo são do primeiro tipo. Eles se aplicam tanto a chamadas recebidas quanto a chamadas feitas, porque os limites da conta e a carteira são verificados de qualquer forma.

Motivos que você pode corrigir

Um discador de campanha pode receber calls_per_second_exceeded sem estar perto do teto de chamadas simultâneas, então verifique qual dos dois você recebeu antes de alterar qualquer coisa.

Motivos que Bird resolve para você

Esses ficam do lado do Bird na configuração. Entre em contato com o suporte e informe o Leg ID do registro:

Como uma recusa aparece

Leia o status e o motivo da rejeição juntos:

• Rejected com motivo de rejeição. Bird recusou a chamada, e o motivo identifica a verificação que falhou. O SIP response é o 503 que seu sistema telefônico recebeu. Siga a resolução de conta ou roteamento indicada pelo motivo.
• Rejected sem motivo de rejeição. Em uma chamada de saída, o lado remoto a recusou diretamente e SIP response traz seu código. Em uma chamada recebida, o número discado a rejeitou, e Inbound route diz o que esse número estava configurado para fazer.
• Failed. A chamada foi tentada e não funcionou, e SIP response contém o código que retornou. Um 486 significa ocupado, enquanto 404 significa que o número não está alocado. Isso geralmente aponta para o número, não para sua configuração.

Uma chamada que Bird não pode admitir é rejeitada antes de um registro existir, então ela nunca aparece no log. Solução de problemas de voz cobre essas chamadas.

Obtendo os registros

Quatro formas de trabalhar com esses registros fora do painel:

• Exportar CSV. Download CSV na aba Leg log exporta os registros que correspondem aos seus filtros atuais em todas as páginas, até 10.000 trechos. Uma seleção maior retorna um erro sem arquivo; restrinja o intervalo de datas ou os filtros e exporte cada seleção separadamente. Use para conciliação e relatórios pontuais.
• Leia pela API. GET /v1/voice/legs retorna a lista filtrada, e GET /v1/voice/legs/{leg_id} retorna um registro. Ambos exigem uma chave API com o escopo voice no nível read. Consulte a referência API para as operações publicadas de outros recursos de Voice e seus escopos necessários.
• Leia pelo terminal. A Bird CLI fornece bird voice legs list, bird voice legs get e bird voice stats. O servidor MCP expõe as mesmas leituras para agentes.
• Assine os eventos. voice_call.initiated, voice_call.answered e voice_call.ended são enviados ao seu endpoint conforme as chamadas acontecem, para que seus sistemas se mantenham atualizados sem polling. Veja Eventos de voz.

Próximos passos