Solução de problemas de Voice

Comece pelo registro de chamadas. A presença de um registro e seus campos determinam quais verificações seguir.

Uma chamada de saída não aparece no registro de chamadas

Uma chamada que Bird não consegue admitir é barrada na camada SIP, antes de existir um registro. Cinco coisas causam isso:

O trunk ainda não transporta chamadas de saída. Um trunk novo não transporta nenhuma chamada até você ativar chamadas de saída na página dele, e ele recusa todas as tentativas até que você faça isso, independentemente das credenciais que a chamada apresente.
O trunk ainda não tem como reconhecer você. Um trunk novo rejeita toda chamada até que você adicione um intervalo de IP, uma chave API permitida ou credenciais de sessão.
A chamada veio de um endereço fora da lista de IPs permitidos do trunk. Atrás de NAT, compare o endereço público do roteador com a lista de IPs permitidos do trunk. O endereço privado do sistema telefônico não chega a Bird.
O desafio de senha falhou. Verifique se o nome de usuário é bird. A senha deve ser o segredo de uma chave API permitida ou uma credencial de sessão não expirada. O trunk também precisa oferecer o algoritmo Digest que o seu sistema telefônico utilizou.
A chamada foi endereçada a um domínio SIP que Bird não reconhece. Copie o domínio inteiro da página do trunk em vez de montá-lo.

A chamada é rejeitada com um motivo de rejeição

Bird recusou a chamada antes de discar para uma operadora, e o motivo indica a verificação que falhou. Abra a chamada e use o link do painel de rejeição para acessar a configuração relevante. Chamadas rejeitadas lista cada motivo e sua correção.

caller_id_not_verified é o motivo que um cliente novo encontra com mais frequência, geralmente porque o cliente coloca o nome de usuário do digest onde deveria estar o caller ID: os dois são campos diferentes.

A chamada falhou em vez de ser rejeitada

Failed não é uma recusa. A chamada foi tentada e não funcionou, e SIP response traz o código que voltou. Um 486 é um número ocupado, e um 404 é um número não alocado. Isso geralmente aponta para o número que você discou, não para a sua configuração.

Uma chamada que Bird recusou aparece como Rejected, não Failed. Portanto, filtre o registro por Rejected quando estiver procurando uma chamada que falhou em uma das verificações de Bird.

A chamada é rejeitada sem motivo de rejeição

Em uma chamada de saída, o lado remoto recusou diretamente e SIP response traz o código.

Em uma chamada recebida, o número discado recusou a chamada, o que não falha em nenhuma verificação e, portanto, não indica nenhum motivo. Abra a chamada e leia Inbound route: uma rota reject é um número que não está apontado para nenhum destino. Recebendo chamadas percorre cada recusa de entrada a partir da rota e do motivo.

A pessoa que você ligou viu um número diferente

A chamada tem um registro e nenhum motivo de rejeição, então passou em todas as verificações que Bird faz. O problema está depois de Bird: a operadora de destino substituiu o caller ID ou recusou uma chamada que o apresenta. A mesma causa aparece como um número que conecta em um país e nunca conecta em outro.

A verificação prova que você controla um caller ID. Ela não obriga a operadora que entrega a chamada a aceitá-lo, e as operadoras aplicam suas próprias regras nacionais a um número que não foi adquirido por meio de Bird. Consulte o aviso de verificação e entrega de CLI para conhecer as práticas envolvidas, que incluem requisitos de CLI no país, bloqueio por origem e listas de não originação.

Para saber qual tipo de número você apresentou, abra-o em Voice > Numbers e leia o painel no topo da página. Um número que você comprou de Bird mostra a assinatura, assim como um número que você comprou e também verificou. Apenas um número que você possui em outro lugar mostra somente a verificação. Uma assinatura significa que o número foi adquirido por meio de Bird, então o aviso não se aplica a ele. Apresentar um número adquirido por meio de Bird é o que aumenta as taxas de entrega e completamento nos destinos que rejeitam um número apenas verificado.

Uma chamada recebida nunca chega ao seu sistema telefônico

O número atendeu a chamada, e a entrega é o que falhou. Verifique nesta ordem:

Leia o Inbound route da chamada. Ele indica a qual trunk ou encaminhamento o número estava apontado quando a chamada chegou. Uma rota reject significa que o número não estava apontado para nada, que também é onde um número fica depois que seu trunk é excluído ou tem as chamadas recebidas desativadas.
Verifique se o trunk tem um gateway. Um trunk sem gateway de entrega recusa toda chamada para os números que ele atende, e o registro mostra no_route_found. Adicione um em Inbound calling na página do trunk.
Verifique o endereço do gateway. Bird disca para os gateways em ordem de prioridade e desiste quando nenhum atende. Confirme o host do URI SIP, a porta e que o seu sistema telefônico aceita chamadas de Bird nele.
Para um encaminhamento, verifique se o destino ainda está verificado. O destino do encaminhamento é verificado novamente a cada chamada, então um caller ID que você removeu para de encaminhar a partir desse ponto.

Página	O que cobre
Registro de chamadas	Todos os campos de um registro de chamada e todos os motivos de rejeição
Trunks SIP	A lista de IPs permitidos, chaves, credenciais de sessão e Digest
Configuração de cliente SIP	As configurações que cada softphone e PBX, o sistema telefônico empresarial, solicita
Realizando chamadas	O que Bird espera no INVITE e como o handshake funciona
Recebendo chamadas	Apontar um número para um trunk ou encaminhamento e o que é registrado

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 funcionalidadeVoice Guia de implementaçãoVoice overview

Obtenha um resumo de implementação