Antes de começar

O que são trechos de código?

Trechos de código são pequenos fragmentos de código que você pode reutilizar em suas próprias Applications. Os trechos de código utilizam código do Trechos de código do Vonage Node e Trechos de código do Vonage Curl repositórios.

Leia estas informações com atenção para que você possa aproveitar ao máximo os trechos de código.

Pré-requisitos

  1. Criar um Account na API da Vonage
  2. Instalar o Node.js - necessário para utilizar a Interface de Linha de Comando (CLI) da Vonage.
  3. Instale o CLI da Vonage
  4. Instale o SDK do Node Server - necessário apenas se estiver usando o Node.
  5. Configurar webhooks.
  6. Saiba como criar um servidor de webhooks
  7. Saiba como testar seu servidor de webhooks localmente

Variáveis substituíveis

Genérico, substituível

As seguintes informações substituíveis dependem da biblioteca e da chamada específica:

ChaveDescrição
VONAGE_API_KEY

Your Vonage API key (see it on your dashboard).

VONAGE_API_SECRET

Your Vonage API secret (also available on your dashboard).

VONAGE_APPLICATION_PRIVATE_KEY_PATH

Private key path.

VONAGE_APPLICATION_PRIVATE_KEY

Private key.

VONAGE_APPLICATION_ID

The Vonage Application ID.

Numbers

Todos os números de telefone estão no formato E.164.

ChaveDescrição
VONAGE_NUMBER

Your Vonage Number. E.g. 447700900000

TO_NUMBER

Replace with the number you are sending to. E.g. 447700900001

FROM_NUMBER

Replace with number you are sending from. E.g. 447700900002

Variáveis específicas/substituíveis

Alguns trechos de código contêm variáveis mais específicas, como os IDs de páginas do Facebook, que precisarão ser substituídos por valores reais. Quando necessário, essas variáveis são especificadas individualmente para cada trecho de código.

Webhooks

Os principais que você encontrará aqui são:

  • /webhooks/inbound-message - Você receberá uma ligação de retorno aqui assim que a Vonage receber uma mensagem.
  • /webhooks/message-status - Você receberá uma notificação aqui assim que a Vonage receber uma atualização do status da mensagem.

Se você estiver realizando testes localmente usando Ngrok Você definirá as URLs dos seus webhooks no objeto “Vonage Application” usando um formato semelhante aos exemplos a seguir:

  • https://demo.ngrok.io/webhooks/inbound-message
  • https://demo.ngrok.io/webhooks/message-status

Alterar demo no texto acima, substitua pelo que o Ngrok gerar para você, a menos que você tenha adquirido uma URL reutilizável.