Registro de chamadas
O registro de chamadas em Voice > Calls lista todas as chamadas que seu espaço de trabalho fez e todas as chamadas que chegaram em um de seus números, da mais recente para a mais antiga. Cada entrada é um registro detalhado de chamada (CDR), incluindo chamadas que foram conectadas, que tocaram sem resposta ou que foram recusadas. Use-o para verificar duração, a resposta SIP final e custo.
Bird grava cada registro quando a chamada termina, então toda chamada no registro tem um resultado final. A aba Live ao lado dele mostra as chamadas que ainda estão ativas.
A lista de chamadas
Cada linha é uma chamada:
| Coluna | O que mostra |
|---|---|
| Status | Como a chamada terminou (veja Status) |
| From | O número de origem, o caller ID que seu equipamento apresentou |
| To | O número que foi chamado |
| Direction | Outbound para chamadas que seu equipamento fez, inbound para chamadas que chegaram nos seus números |
| Duration | Duração total da chamada, do momento em que Bird a recebeu até o desligamento |
| Started | Quando Bird recebeu a chamada |
A lista é paginada, com 25 chamadas por página. Selecione qualquer linha para abrir a chamada.
Chamadas ao vivo
A aba Live lista as chamadas ativas no momento e exibe um contador para que você veja quantas estão ativas sem precisar abri-la. Uma chamada ao vivo tem um de dois status:
| Status | O que está acontecendo |
|---|---|
| Ringing | A chamada chegou ao destino, que ainda não atendeu |
| In progress | O destino atendeu e a chamada está conectada |
As colunas são as mesmas do registro de chamadas, exceto por Elapsed, que substitui Duration. Ele conta a partir do atendimento para uma chamada conectada e a partir do início para uma chamada tocando. A aba é atualizada a cada poucos segundos. Quando uma chamada termina, ela passa para o registro de chamadas com seu resultado final.
Pesquisa e filtragem
A página começa com uma pesquisa por número e seus filtros. Eles se combinam: um filtro de status mais um intervalo de datas restringe às chamadas que atendem ambos.
Pesquisa por número. A caixa de pesquisa compara um número com qualquer lado da chamada, então uma única consulta encontra as chamadas para ele e as chamadas vindas dele.
Direction. Filtre por chamadas 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:
| Bloco | O que conta |
|---|---|
| Calls | Registros de chamada concluídos no mês, incluindo não atendidas e recusadas |
| Total duration | Duração total de todas as chamadas somada, do momento em que Bird as recebeu até o desligamento |
| Billable time | Tempo atendido de todas as chamadas somado |
A diferença entre a duração total e o tempo faturável é o tempo de toque sem resposta. Uma chamada não atendida 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
Uma chamada no registro terminou com um destes resultados:
| Status | O que aconteceu |
|---|---|
| Answered | O destino atendeu. O tempo faturável vai do atendimento ao desligamento |
| No answer | A chamada tocou no destino e não foi atendida antes de expirar |
| Rejected | A chamada foi recusada em vez de completada |
| Failed | A chamada foi tentada e não funcionou, e SIP response é o que retornou |
| Unknown | O resultado não pôde ser determinado, por exemplo quando nenhuma resposta final chegou |
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 uma chamada mostra o que Bird registrou sobre ela:
| Campo | O que informa |
|---|---|
| Status | O resultado da chamada (veja Status). Uma chamada que Bird recusou também mostra o motivo e o que fazer |
| Resposta SIP | O código SIP final da chamada, por exemplo 200 ou 486. Uma chamada que Bird recusou traz 503, sem operadora envolvida |
| From / To | Ambos os números, cada um copiável |
| Inbound route | Em uma chamada recebida, o que o número discado estava configurado para fazer: entregar a um trunk, encaminhar ou rejeitar. Link para esse número |
| Trunk | O trunk SIP pelo qual a chamada entrou ou foi entregue, útil quando vários sites compartilham um espaço de trabalho |
| Started | Quando Bird recebeu a chamada |
| Answered | Quando a chamada foi atendida, ou Not answered |
| Ended | Quando a chamada foi encerrada |
| Call ID | O id do próprio registro (vcl_…). Informe-o ao suporte e use-o para correlacionar com seus próprios logs |
| Session ID | Compartilhado por todos os trechos de uma chamada (vcs_…), para que registros relacionados possam ser agrupados. Uma chamada encaminhada tem dois trechos compartilhando um |
| Billing | Tempo faturável, duração total e o custo da chamada depois de tarifada |
Inbound route aparece apenas em chamadas recebidas e indica o que o número estava configurado para fazer, não que funcionou: uma rota trunk em uma chamada rejeitada é um número apontado para um trunk que não aceitou a chamada. Recebendo chamadas cobre as três respostas 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
| Motivo | O que aconteceu | O que fazer |
|---|---|---|
| source_not_allowed | A chamada chegou de um endereço que a lista de IPs permitidos do trunk não cobre | Adicione o endereço de onde seu sistema telefônico envia ao trunk |
| caller_id_not_verified | O número no cabeçalho From não é um caller ID verificado para este espaço de trabalho | Verifique esse número ou apresente um já verificado |
| destination_not_enabled | Chamadas para esse país estão desativadas no seu espaço de trabalho | Ative o país em Destinations |
| insufficient_balance | Sua carteira não cobria a chamada, então Bird a recusou antecipadamente | Adicione saldo ou ative recargas automáticas para que um saldo baixo não interrompa as chamadas |
| daily_spend_exceeded | A chamada teria ultrapassado o teto diário de gasto com voz da sua organização | Aguarde o teto ser redefinido no início do próximo dia UTC ou peça a Bird para aumentá-lo |
| concurrent_calls_exceeded | Você tem tantas chamadas em andamento quanto sua conta permite | Aguarde uma chamada terminar ou entre em contato com o suporte para aumentar o teto |
| calls_per_second_exceeded | Você fez novas chamadas mais rápido do que sua conta permite | Reduza a taxa de discagem e tente novamente. Tentar novamente imediatamente recebe a mesma resposta |
| number_ownership_not_verified | Você comprou este número, mas o país que o emitiu ainda não aceitou a documentação que comprova a titularidade | Complete o que o campo ownership do número solicita e faça a chamada novamente |
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 de Bird na configuração. Entre em contato com o suporte e informe o Call ID do registro:
| Motivo | O que aconteceu |
|---|---|
| routing_not_configured | O roteamento do seu espaço de trabalho ainda está sendo anexado, o que é esperado enquanto uma nova configuração de voz está sendo concluída |
| no_route_found | O roteamento está anexado, mas não cobre o número que você discou. Entre em contato com o suporte com o call ID para verificar a rota |
| destination_blocked | A configuração de roteamento de Bird bloqueia chamadas para esse destino |
| call_not_permitted | Bird não conseguiu completar a chamada para sua conta, então recusou a chamada em vez de realizá-la em condições desconhecidas |
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 registro. 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 Call log exporta todos os registros que correspondem aos seus filtros atuais em todas as páginas. Use para reconciliação e relatórios pontuais.
- Leia pela API. GET /v1/voice/calls retorna a lista filtrada e GET /v1/voice/calls/{call_id} retorna um registro. Ambos exigem uma chave API com o escopo voice no nível read. Configurações de trunk, caller ID e destino não fazem parte da API pública.
- Leia pelo terminal. A Bird CLI fornece bird voice list, bird voice 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
| Página | O que cobre |
|---|---|
| Eventos de voz | Os três eventos de chamada, seus payloads e como consumi-los |
| Fazendo chamadas | O que Bird espera no INVITE e como uma chamada é tarifada |
| Recebendo chamadas | Apontar um número para um trunk ou encaminhamento e o que é registrado |
| Trunks SIP | A lista de IPs permitidos, chaves API permitidas e configurações Digest |
| Destinos de voz | Ativação de países e o que disponibilidade significa |
| Erros | A resposta de erro API e seus campos de recuperação |
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Entenda o conceitoWhat is a voice API?Explore a funcionalidadeVoiceGuia de implementaçãoVoice overview
Obtenha um resumo de implementação