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.

Se você não vê nenhum registro de chamada, verifique primeiro estes pontos:

1. Você está no espaço de trabalho certo. Os registros de chamadas pertencem ao espaço de trabalho que contém o número ou o trunk. Mude para ele e abra Voice > Legs.
2. A chamada chegou a Bird. Em uma chamada recebida, a operadora de quem liga decide para onde a chamada vai, e um número apontado para um trunk sem gateway salvo recusa a chamada antes de existir um registro. Em uma chamada de saída, consulte Uma chamada de saída não aparece no registro de chamadas: uma admissão recusada não deixa registro.
3. Os filtros não a ocultam. Limpe o filtro de status e amplie o intervalo de datas.

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. O seu equipamento precisa colocar o domínio SIP do trunk no host do Request-URI. Copie o domínio inteiro da página do trunk em vez de montá-lo. Uma chamada endereçada a outro nome de host ou endereço Bird não chega ao seu trunk.

O que o seu equipamento recebe indica qual verificação falhou. 407 Proxy Authentication Required significa que o trunk pede uma senha; com credenciais de sessão ativadas, ele pede a todos que ligam. 403 Forbidden significa que o trunk não admitiu a chamada: um host do Request-URI que não é o domínio SIP do seu trunk, chamadas de saída desativadas, um endereço fora da lista de permitidos ou uma senha que não foi validada. 503 Auth Unavailable significa que Bird não conseguiu verificar a chamada; nesse caso, tente novamente.

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 configurado para recusar, ou um número sem rota própria quando a rota padrão do espaço de trabalho é rejeitar. 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 a rota de entrada da chamada. Ela indica para qual trunk ou encaminhamento o número estava apontado quando a chamada chegou. Uma rota reject significa que o número tem sua própria rota definida como rejeitar, ou não tem rota própria enquanto a rota padrão do espaço de trabalho é rejeitar. Abra o número para ver qual é o caso: um número configurado para rejeitar ignora a rota padrão. Um número cujo trunk foi excluído ou teve as chamadas de entrada desativadas volta para a rota padrão, e uma rota padrão que aponta para esse trunk volta a rejeitar.
2. Verifique se o trunk consegue entregar. Abra Inbound routing do trunk. Um gateway precisa estar em um grupo, e a Default route (ou uma regra) precisa enviar as chamadas para esse grupo. Uma rota padrão definida como Reject recusa todas as chamadas sem motivo de rejeição, e um trunk sem gateway salvo recusa a chamada antes de existir um registro. Corrija o aviso Calls never reach some gateways se o painel o mostrar quando você salvar.
3. Verifique o endereço do gateway. Bird disca para os gateways do grupo na ordem definida pelo grupo 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.
5. Verifique a resposta do seu equipamento. Uma chamada que chegou ao seu gateway e foi recusada lá geralmente aparece como Failed (uma resposta 6xx aparece como Rejected), e SIP response traz o código do seu equipamento, como 403 ou 412. Bird tentou a chamada, então a correção está do seu lado: verifique se o seu SBC aceita chamadas dos endereços de sinalização de Bird e o formato de número que o gateway envia.

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.

O telefone no navegador não toca ou não consegue discar

Verifique primeiro o status na parte inferior do telefone:

1. Escolha Online para receber chamadas. Um grupo de toque ignora membros que estão Offline, Busy, já em uma chamada ou Not accepting calls depois de três chamadas perdidas seguidas. Seu status explica cada um.
2. Fique online para discar. Um telefone Offline não pode fazer chamadas. Nos status Online, Busy e Not accepting calls, é possível discar.
3. Traga as chamadas para este navegador. Em cada espaço de trabalho, você fica online em um dispositivo e em uma aba por vez. Offline · Active on another device oferece Take over, e Offline · Calls are handled in another tab oferece Use here.
4. Verifique o limite de usuários online. Offline · Limit of users online reached significa que sua organização já tem o número máximo de usuários online permitido. Consulte Limite de usuários online.
5. Ative o som. Depois de recarregar a página, o navegador pode bloquear o toque até você interagir com ela. O menu de status passa então a oferecer Turn on sound.

Se o telefone está online e mesmo assim uma chamada não toca para você, leia a Inbound route da chamada no registro de chamadas. Ela indica o grupo de toque para o qual a chamada tocou, para que você verifique se é membro dele e se o número encaminha para esse grupo.

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.

Se o seu equipamento está acessível e o áudio ainda falha em uma direção, verifique se o seu firewall permite os endereços de mídia de Bird nas portas UDP de 2500 a 32499.

Próximos passos