Numbers

Os números são um conceito fundamental a ser compreendido ao trabalhar com a Voice API da Vonage. Os pontos a seguir devem ser considerados antes de desenvolver seu aplicativo da Vonage.

Formatação

No serviço Vonage Voice (Voice API ou SIP Trunking), todos os números estão no formato E.164. Isso significa que os números:

  • Omita tanto o + e o código de acesso internacional, como, por exemplo, 00 ou 001.
  • Não conter caracteres especiais, como um espaço, () ou -

Por exemplo, um número dos EUA teria o formato 14155550101. Um número do Reino Unido teria o formato 447700900123.

Se você não souber como formatar o número, o Number Insight API pode ser usado para encontrar informações corretas sobre um número.

Números da Vonage

A Vonage oferece números alugados em diversos países ao redor do mundo. Em alguns países, os números podem estar habilitados apenas para SMS ou chamadas de voz; em outros, eles suportam ambos os serviços.

A Vonage também pode fornecer números tanto da rede “fixa” quanto da rede “móvel” para diversos países. Você pode pesquisar e alugar um número disponível:

Identificação de chamadas efetuadas

Ao fazer uma chamada, o identificador de chamadas é o from valor no API para fazer uma chamada ou conectar ações para a Voice API. Também pode ser encontrada no SIP INVITE para o SIP Trunking; estará no PAI cabeçalho, se definido; caso contrário, estará no From cabeçalho. Você pode usar os seguintes números como identificador de chamadas:

  • Um número da Vonage associado à sua Account, sem limitação para chamadas de saída (consulte o campo “Limitações” em Números para compra página ou entre em contato com o Suporte).
  • Um número que não seja da Vonage após o fornecimento das informações necessárias que comprovem a propriedade. Sujeito a restrições geográficas, entre em contato com o Suporte para registrar seu número como Identificação de Chamada Verificada.
  • Identificação original do chamador que está ligando para o seu número da Vonage (aplicável apenas para terminais do tipo telefone). Isso é útil em situações de encaminhamento ou rastreamento de chamadas. Por exemplo, quando você recebe uma chamada de 15551111111 para o seu número da Vonage 15552222222, você pode fazer uma chamada de saída com a ação “conectar” para um número 15553333333 usando o identificador de chamadas original 15551111111 como seu número de origem.

Observação: esse recurso é compatível apenas com chamadas nacionais — ou seja, todos os três números devem estar no mesmo país e não estar sujeitos a restrições impostas pelos órgãos reguladores locais.

Qualquer outro número usado como identificador de chamadas fará com que a chamada seja bloqueada.

Identificação de chamadas recebidas

Para usar um número que você alugou da Vonage com seu aplicativo de voz, é preciso vincular esse número ao aplicativo por meio do Painel de controle na página “Applications” ou usando o API de Numbers. Para o SIP Trunking, você deve vincular o número ao seu domínio SIP por meio do Painel do SIP. É possível vincular vários números ao mesmo aplicativo, e o número que foi chamado será repassado para o seu answer_url no to parâmetro, ou no To cabeçalho no SIP INVITE para SIP Trunking.

Ao receber uma chamada, o identificador de chamadas será enviado no Webhook de resposta como o from campo, ou como From cabeçalho no SIP INVITE para SIP Trunking.

{
  "from": "442079460000",
  "to": "447700900000",
  "uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "conversation_uuid": "CON-aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

A Vonage tenta exibir para você o identificador de chamadas da pessoa que está ligando para o seu aplicativo da Vonage no formato internacional. No entanto, ocasionalmente, esse formato pode ser incorreto devido à rede de origem. A Vonage transmite o número recebido do provedor de números. Você pode saber mais sobre o identificador de chamadas recebidas em nosso Visão geral dos recursos de voz página na base de conhecimento da Vonage.