JavaScript

Configure seus pré-requisitos

Existem alguns pré-requisitos que você precisa cumprir antes de poder seguir com este tutorial. Se você já tiver cumprido algum deles, fique à vontade para pular essa etapa.

Para usar os Números Inteligentes, você precisa ativar o complemento Números Inteligentes no seu Account:

Visite o Portal de Administração do VBC e faça login.
No menu de navegação, selecione Loja > Complementos.
Pesquise por “smart” para filtrar a lista de complementos:
Clique Adicionar para adicionar o Smart Number ao seu carrinho de compras.
Observe a mensalidade recorrente e clique Finalizar a compra.
No Pré-visualização do pedido página, verifique a forma de pagamento da sua Account e clique em Enviar pedido.

Você já ativou os Números Inteligentes. O próximo passo é criar um aplicativo de voz da Nexmo.

Todo aplicativo Smart Numbers que você criar deve estar associado a uma aplicação de voz da Nexmo.

Nota: Para evitar confusão, Application Aqui, refere-se ao aplicativo Nexmo. O aplicativo que você está desenvolvendo será chamado de “aplicativo”.

Um aplicativo Nexmo armazena informações de configuração, como detalhes dos Smart Numbers e URLs de retorno de chamada do webhook que seu aplicativo utiliza. Para que suas chamadas pelo VBC Smart Numbers sejam isentas de tarifas no Nexmo, você deve criar um aplicativo com o vbc e voice recursos, utilizando o API de aplicativos da Nexmo.

Como usar a API do aplicativo

Para criar uma Application Nexmo para trabalhar com Smart Numbers, execute o comando curl comando mostrado abaixo, substituindo NEXMO_API_KEY e NEXMO_API_SECRET com sua chave e seu segredo da API da Nexmo, respectivamente. Você pode encontrar essas informações no Painel do desenvolvedor da Nexmo.

Os dois URLs que você forneceu referem-se aos endpoints de webhook que seu aplicativo irá expor aos servidores da Nexmo:

O primeiro é o webhook ao qual as APIs da Nexmo enviarão uma solicitação quando for recebida uma chamada no seu Smart Number.
A segunda é aquela em que as APIs da Nexmo enviarão detalhes sobre eventos que possam ser do interesse do seu aplicativo — como, por exemplo, uma chamada atendida ou encerrada.

curl -X POST \ https://api.nexmo.com/v2/applications \ -H 'Authorization: Basic Base64($NEXMO_API_KEY:$NEXMO_API_SECRET)' \ -H 'Content-Type: application/json' \ -d '{ "name": "My Nexmo VBC Application", "capabilities": { "vbc": {}, "voice": { "webhooks": { "answer_url": { "address": "https://example.com/webhooks/answer", "http_method": "POST" }, "event_url": { "address": "https://example.com/webhooks/event", "http_method": "POST" } } } } }'

A resposta é um objeto JSON que contém o aplicativo Nexmo id que você usará para interagir com a Voice API da Nexmo.

{
  "id": "27aa0583-7246-4822-aabb-17b03c25d52e",
  "name": "My Nexmo VBC Application",
  "keys": {
    "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkq...
    -----END PRIVATE KEY-----\n",
    "public_key": "-----BEGIN PUBLIC_KEY-----\nMIIBIjANBgkqh...
    -----END PUBLIC KEY-----\n"
  },
  "capabilities": {
    "voice": {
      "webhooks": {
        "event_url": {
            "address": "https://example.com/webhooks/event",
            "http_method": "POST"
        },
        "answer_url": {
            "address": "https://example.com/webhooks/answer",
            "http_method": "POST"
        }
      }
    },
    "vbc": {}
  },
  "_links": {
    "self": {
      "href": "/v2/applications/27aa0583-7246-4822-aabb-17b03c25d52e"
    }
  }
}

O próximo passo é fornecimento de Smart Numbers usando o aplicativo Nexmo id.

Depois de ativar o complemento Smart Numbers na sua conta VBC e criar um aplicativo da Voice API da Nexmo, você estará pronto para configurar o serviço Smart Numbers. Isso envolve selecionar quais números usar e associá-los ao seu aplicativo da Voice API da Nexmo.

Faça login em o Portal de Administração do VBC
No menu de navegação à esquerda, selecione o Aplicativos empresariais > Smart Numbers opção do menu.

Nota: Se você não vir o Números inteligentes opção do menu, você deve ativar o complemento.
Cada linha da tabela corresponde a um Smart Number. Clique em um dos seus Smart Numbers ainda não configurados para editá-lo.
No Editar o serviço “Números Inteligentes” página:
Digite um nome para o serviço.
Selecione pelo menos um número de discagem direta para o qual você ligará a fim de acessar o aplicativo da Voice API da Nexmo.
Cole na sua Voice API da Nexmo application_id.
Certifique-se de que o Chave seletora de status do Smart Number está definido como Ativo.
Clique no Salvar botão.