Configurar a implantação do WhatsApp

Antes de começar

Antes de implantar o cluster do WhatsApp, é necessário coletar algumas informações do Configurações página no Painel do WhatsApp Business, incluindo:

ID do Account do WhatsApp Business

  1. Acesse seu configurações comerciais página e selecione Contas > Contas do WhatsApp.
  2. Selecione o Account do WhatsApp Business que você está configurando.
  3. O ID da sua conta do WhatsApp Business está localizado na parte superior da página, abaixo do nome da conta do WhatsApp Business.

Número de telefone

  1. Acesse seu configurações comerciais página e selecione Contas > Contas do WhatsApp.
  2. Selecione o Account do WhatsApp Business que você está configurando.
  3. De acordo com o Configurações aba, abrir Gerenciador do WhatsApp > Números de telefone.
  4. Encontre o número de telefone desejado na lista.

Certificado (associado ao seu número de telefone)

  1. Acesse seu configurações comerciais página e selecione Contas > Contas do WhatsApp.
  2. Selecione o Account do WhatsApp Business que você está configurando.
  3. De acordo com o Configurações aba, abrir Gerenciador do WhatsApp > Números de telefone.
  4. Encontre o número de telefone desejado na lista.
  5. Clique no Visualizar botão (no Certificado (coluna).
  6. Copie o certificado associado para a área de transferência e cole-o em um documento separado. Você precisará dele em uma etapa posterior.

Criar uma aplicação da Vonage

Um aplicativo da API da Vonage contém as informações de segurança e configuração necessárias para se conectar aos terminais da Vonage e utilizar as APIs da Vonage. Nesse caso, é necessário criar um aplicativo que utilize a Messages API da Vonage.

Observação: seu account do WhatsApp precisa estar conectado ao seu account da Vonage antes que você possa vinculá-lo a uma aplicação da Vonage. Você pode conectar seu account do WhatsApp ao seu account da Vonage por meio do Painel da API da Vonage.

  • Os exemplos tanto da CLI quanto do painel são aqui

Gere seu JWT

DICA: Você só precisa seguir esta etapa se estiver realizando testes com o Curl, já que os SDKs do cliente e do servidor geram os JWTs conforme necessário para você.

Depois de criar uma aplicação da API da Vonage, você poderá usar o ID da aplicação e o arquivo da chave privada, private.key, para gerar um JWT.

Para criar um token JWT usando o CLI da Vonage, use este comando

# A command with parameters
vonage jwt create `
--app-id='00000000-0000-0000-0000-000000000000' `
--private-key=./private.key

# Will produce a token
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MzYyODE5NDYsImp0aSI6IjBmZjcwZDNmLTAzN2EtNGY4MC04ODZjLWI3MmM3MmQyMWNmMiIsImlhdCI6MTczNjI4MTA0NiwiYXBwbGljYXRpb25faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifQ.gA7jClpqaZ2OoS0iri-zGCbda4jO7C0M8mka0EnSyjlds1EeY8fNoBEx3FTXHfkkzzrj0TskrWc_dcs1wuM8Kx55c5rLQ7taVpDAYopKSc_CeeOaad8S6aWnRkTUTNeduO4aIn-0CbyRTluBYsH1RBqYBQvobuQIDEwbFw8xBgx0UfREMMN6DAWknR57eiVXN9x_oD6CGQJ1yV3025nGboeMsP9YgX4Nwc-rE2r8c1ZGwCLO81x8i19Qil3Nwu5q1nzouyavQjIw00B_TZkushnI1ufdi_GNqk-h5q2HvGkg7Pj9bVkZHFdVTO8im03JYNyJmcV83vnpjOLuCFRzxQ

REM A command with parameters
vonage jwt create ^
--app-id='00000000-0000-0000-0000-000000000000' ^
--private-key=./private.key

REM Will produce a token
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MzYyODE5NDYsImp0aSI6IjBmZjcwZDNmLTAzN2EtNGY4MC04ODZjLWI3MmM3MmQyMWNmMiIsImlhdCI6MTczNjI4MTA0NiwiYXBwbGljYXRpb25faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifQ.gA7jClpqaZ2OoS0iri-zGCbda4jO7C0M8mka0EnSyjlds1EeY8fNoBEx3FTXHfkkzzrj0TskrWc_dcs1wuM8Kx55c5rLQ7taVpDAYopKSc_CeeOaad8S6aWnRkTUTNeduO4aIn-0CbyRTluBYsH1RBqYBQvobuQIDEwbFw8xBgx0UfREMMN6DAWknR57eiVXN9x_oD6CGQJ1yV3025nGboeMsP9YgX4Nwc-rE2r8c1ZGwCLO81x8i19Qil3Nwu5q1nzouyavQjIw00B_TZkushnI1ufdi_GNqk-h5q2HvGkg7Pj9bVkZHFdVTO8im03JYNyJmcV83vnpjOLuCFRzxQ
# A command with parameters vonage jwt create \ --app-id='00000000-0000-0000-0000-000000000000' \ --private-key=./private.key # Will produce a token eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MzYyODE5NDYsImp0aSI6IjBmZjcwZDNmLTAzN2EtNGY4MC04ODZjLWI3MmM3MmQyMWNmMiIsImlhdCI6MTczNjI4MTA0NiwiYXBwbGljYXRpb25faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifQ.gA7jClpqaZ2OoS0iri-zGCbda4jO7C0M8mka0EnSyjlds1EeY8fNoBEx3FTXHfkkzzrj0TskrWc_dcs1wuM8Kx55c5rLQ7taVpDAYopKSc_CeeOaad8S6aWnRkTUTNeduO4aIn-0CbyRTluBYsH1RBqYBQvobuQIDEwbFw8xBgx0UfREMMN6DAWknR57eiVXN9x_oD6CGQJ1yV3025nGboeMsP9YgX4Nwc-rE2r8c1ZGwCLO81x8i19Qil3Nwu5q1nzouyavQjIw00B_TZkushnI1ufdi_GNqk-h5q2HvGkg7Pj9bVkZHFdVTO8im03JYNyJmcV83vnpjOLuCFRzxQ

Como alternativa, você pode usar nosso Aplicativo web JWT para gerar um JWT.

DICA: Você pode testar o JWT gerado em jwt.io

Implantação do WhatsApp

Chave Descrição
country_code O código de discagem internacional do número que está sendo ativado.
number O número do WhatsApp está sendo configurado.
vname_certificate O certificado, que você pode acessar no painel do WhatsApp Business. > NOTA: Sempre que você clicar no Visualizar Ao clicar no botão, o certificado será alterado. Baixe ou copie seu certificado para poder usá-lo em uma etapa posterior.
method O método de envio da senha de uso único (OTP). Deve ser: sms ou voice.
waba_id O ID da conta do WhatsApp Business associado ao número do WhatsApp. 
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/deployments\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{
        "country_code": "44",
        "number": "7877001122",
        "vname_certificate": "CnQKMAj669nb79e",
        "method": "sms",
        "waba_id": "345676589250625"
      }'

Depois de provisionado, o cluster do WhatsApp passa pelas seguintes etapas de implantação: INITIALIZING, CREATING_CLUSTER e CLUSTER_CREATED. Quando o CLUSTER_CREATED Quando essa etapa é concluída, é enviada uma chamada de voz OTP ou uma mensagem SMS para o número especificado, e o status da implantação passa a ser CODE_SENT. Ao receber a OTP, chame a API Verify para concluir o processo.

Verify OTP

Chave Descrição
code A senha de uso único está sendo enviada para verificação. 
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/$DEPLOYMENT_ID/verify\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{ "code": "$CODE" }'

Agora que o cluster do WhatsApp foi implantado com sucesso, você pode gerenciar seu Perfil do WhatsApp Business.

Referência