Solução de problemas

Visão geral

A Voice API da Vonage oferece um serviço de alta disponibilidade. No entanto, devido à natureza da prestação de serviços por meio de centenas de operadoras de telefonia em todo o mundo, podem surgir ocasionalmente problemas que estão fora do controle da Vonage. Além disso, existem certas limitações impostas à Vonage pelas redes parceiras, o que pode afetar o funcionamento do seu aplicativo. Embora a lista não seja exaustiva, aqui estão alguns pontos a serem verificados caso você esteja enfrentando problemas.

Tempos de espera

Quando a Vonage envia um webhook para a sua URL de resposta, ela espera que o servidor responda dentro de um determinado prazo:

  1. A conexão TCP deve ser estabelecida em até 3 segundos.
  2. A resposta HTTP (NCCO) deve ser retornada em até 5 segundos.

Se a Vonage não receber uma resposta dentro desses prazos, ela tentará novamente a solicitação duas vezes. Se isso falhar, a Vonage fará mais duas tentativas para acessar sua URL de resposta alternativa, caso ela esteja configurada. Se a Vonage não receber uma resposta dentro desses prazos da sua URL de resposta alternativa, ela tentará novamente. Se a URL de resposta alternativa responder com um código de erro HTTP ou um NCCO inválido, a chamada será desconectada.

Capacidade

Por padrão, a Voice API apresenta as seguintes limitações de capacidade:

  1. Máximo de 3 chamadas de saída por segundo, criadas seja por meio da API REST, seja utilizando o connect ação dentro de outra chamada.
  2. Máximo de 15 solicitações por segundo à API REST (excluindo chamadas de criação).

Se você ultrapassar esses limites, receberá uma resposta HTTP 429 ou um webhook para o seu event_url com um erro.

Eventos de erro

A Voice API da Vonage envia eventos de erro para o event_url associados ao aplicativo. Por exemplo, quando nos deparamos com um NCCO inválido ou com uma falha na chamada de saída.

Regiões

Para garantir a melhor qualidade de chamada e oferecer suporte a chamadas com canais mistos no aplicativo e na rede PSTN, é necessário utilizar o data center regional mais próximo. Para obter mais informações, consulte Regiões.

VBC Smart Numbers

Se as chamadas que você faz não estiverem sendo recebidas, apesar de os eventos de chamada terem sido bem-sucedidos, verifique se em sua inscrição, você não tem o recurso “VBC Smart Numbers” ativado. Isso pode interferir no roteamento de chamadas; portanto, recomenda-se desativar esse recurso nas configurações do aplicativo caso você não precise dele.