Faça chamadas locais com o No Code e o Vonage Code Hub

Introdução

Se você é como eu e viaja bastante para o exterior, sabe como é chato ter que comprar um chip local. É preciso encontrar uma loja, comparar operadoras, instalar o chip local e rezar para ter comprado dados e minutos suficientes para a viagem (mas sem exagerar, pra não desperdiçar uma fortuna!). E a pior parte... tentar achar um clipe de papel, um prego ou um lápis pra colocar seu chip original de volta no celular no aeroporto!

Felizmente, os eSIMs mudaram o jogo e eliminaram grande parte do incômodo de ter que trocar o chip. Só que os eSIMs funcionam apenas para dados!

Nesta postagem, vou mostrar como ter um número local onde quer que você vá, capaz de receber e fazer chamadas locais. A melhor parte? Você poderá configurá-lo em 5 minutos ou menos com a plataforma Code Hub da Vonage e não precisará escrever nenhuma linha de código!

Pré-requisitos

• Account de desenvolvedor da API da Vonage: Se você ainda não tem um Account de desenvolvedor da API da Vonage, cadastre-se agora (link abaixo)

• Número virtual da Vonage: Acesse o painel “Comprar números” no seu Painel do Desenvolvedor de API. Selecione um número na região em que deseja fazer chamadas e certifique-se de que ele tenha Voice de voz.

Como começar a usar o Vonage Code Hub

Vonage's Code Hub é uma nova plataforma que elimina as dificuldades de configuração e infraestrutura, permitindo que você comece a usar as APIs da Vonage rapidamente. Para começar, faça login na sua conta de desenvolvedor de API e acesse o Receber e fazer chamadas locais no Code Hub.

Search Code Hub for Local Calls

Como implantar seu projeto no Code Hub

Depois de abrir o produto, você precisará abrir o painel “Implantar Código” . Lá você encontrará a opção Criar uma nova instância .

Deploy a new instance in Code Hub

Isso abrirá um painel que solicitará que você configure a implantação do seu projeto:

• Região: escolha a região mais próxima de você

• Nome do espaço de trabalho: escolha algo descritivo, por exemplo, “Meu encaminhamento de chamadas locais nos EUA”

• Número do país de origem: Seu número virtual da Vonage com o código do seu país de origem (o mesmo código do seu número pessoal).

• Número de destino: Seu número virtual da Vonage com o código do país do local de destino.

• Número pessoal: Deve ser o seu número normal para o qual as chamadas são encaminhadas.

Para todos os números, é necessário o código internacional, sem o sinal “+”

• Exemplo de número nos EUA: 15551234567

• Exemplo de número do Reino Unido: 445551234567

Assim que você enviar o formulário, será direcionado ao painel dos seus produtos implantados. É isso! Seu aplicativo está pronto para uso!

Como testar seu produto implantado

Em seguida, você pode testar seu aplicativo chamando o DESTINATION_NUMBER ou HOME_COUNTRY_NUMBER.

• Ligue para o seu DESTINATION_NUMBER de um telefone com o código do país do local de destino e você será conectado ao seu Número Pessoal.

• Ligue para o seu HOME_COUNTRY_NUMBER do seu número pessoal e ele vai conectá-lo ao número desejado na localidade de destino.

Entendendo o Código

Em vez de abrir o aba “Implantar Código” , acesse a seção “Obter Código” e abra o projeto no ambiente de desenvolvimento virtual. Usando a aba “Explorer” (Shift+Command+E), abra o index.js arquivo. É aqui que está todo o código do projeto. Você pode ver a lógica do aplicativo aqui.

Definimos nossas variáveis de ambiente no início do arquivo; elas provêm de vcr.yml e correspondem ao formulário apresentado aos usuários do Code Hub, que está definido no setup.json arquivo.

const destinationlNumber = process.env.DESTINATION_NUMBER;
const homeCountrylNumber = process.env.HOME_COUNTRY_NUMBER;
const personalNumber = process.env.PERSONAL_NUMBER;

Nosso aplicativo está escutando o /onCall ponto de extremidade e, em seguida, determina se quem está ligando é personalNumber (nós) ou se é outra pessoa tentando entrar em contato conosco.

• Se a ligação for feita por nós, será utilizado o talk e dtmf ações da Voice API, antes de nos encaminhar para o /dtmf ponto de extremidade que aciona o “operador” para nos conectar ao dialedNumber.

• Se a ligação for proveniente de outro número, ela conectará o chamador ao personalNumber , mas por meio de um intermediário homeCountrylNumber para evitar tarifas de roaming para ambas as partes.

Conclusão

Não foi legal? Mas o que está acontecendo nos bastidores? Esse aplicativo utiliza o Vonage VCR SDK (que alimenta o Code Hub) e na Voice API.

A Voice API nos dá acesso a NCCOs, que nos permitem enviar mensagens aos chamadores, aceitar as entradas DTMFe transferir chamadas a outros números de telefone.

Nós também utilizamos SSML (Speech Synthesis Markup Language) para personalizar a voz do nosso agente, de modo que ele pronuncie os dígitos de um número de telefone de forma mais natural.

Se você gostou deste post — ou mesmo se não gostou —, conte para a gente no Slack do Vonage Developer ou me mande uma mensagem no X, antes conhecido como Twitter.

Leituras complementares

• Code Hub Beta já está disponível

• Crie aplicativos de voz com mais rapidez

• Crie aplicativos de mensagens com mais rapidez