Criar uma Application na Vonage API Platform

Todo aplicativo Smart Numbers que você criar deve estar associado a um aplicativo de voz da Vonage API Platform.

Um aplicativo da Vonage API Platform 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 com o VBC Smart Numbers sejam isentas de tarifas na Vonage API Platform, você deve criar um aplicativo com o vbc e voice recursos, utilizando o API de Aplicativos da Plataforma de API da Vonage.

Como usar a API do aplicativo

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

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

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

A resposta é um objeto JSON que contém o aplicativo da Vonage API Platform id que você utilizará para interagir com a Voice API da Plataforma de API da Vonage.

{
  "id": "27aa0583-7246-4822-aabb-17b03c25d52e",
  "name": "My VAPI 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"
    }
  }
}