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.

Para chamadas iniciadas pela API, confira primeiro a resposta de Create Call e o histórico de execuções. Siga a solução de problemas de sequências para prévias, publicação, caminhos do teclado e rotas de sequências para chamadas recebidas. As verificações de conexão abaixo abrangem chamadas por trunks SIP.

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

Para uma chamada feita por um trunk SIP, uma falha de admissão pode ocorrer antes de existir um registro de trecho. Verifique estas causas comuns:

• 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.

Para uma chamada de sequência, primeiro verifique se a solicitação de chamada foi aceita e se existe uma execução. Uma prévia do simulador não faz chamadas. Um teste real precisa de um rascunho salvo ou uma publicação ativa, permissões de escrita para gerenciamento e chamadas Voice, um caller ID elegível e um destino habilitado. O guia do construtor de sequências explica essas verificações.

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ê chamou 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:

1. 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.
2. 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.
3. 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.
4. 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.

Se o número usa Run a sequence, inspecione a sequência vinculada e a entrada de chamada em vez do trunk. Confirme uma publicação ativa, uma entrada que aceita dados vazios e se o chamador é um testador de rascunho. Revise o resultado da execução da sequência e o ramo de falha. Alterar um rascunho não altera a versão usada por chamadores comuns.

Seu cliente responde MD5 e não avança

Alguns equipamentos lidam incorretamente com um desafio que começa com SHA-256. Configure o trunk para somente MD5.

Chamadas conectam, mas o áudio é unidirecional

Seu cliente está atrás de NAT e a mídia dele está indo para um endereço privado. Ative o tratamento de NAT ou STUN no cliente.

Próximos passos