Aprovisionar el despliegue de WhatsApp

Antes de empezar

Antes de implementar el clúster de WhatsApp, debes recopilar cierta información del Ajustes página sobre el Panel de WhatsApp Businessincluyendo:

ID de cuenta de WhatsApp Business

  1. Navegue hasta su entorno empresarial y seleccione Accounts > Cuentas de WhatsApp.
  2. Seleccione la Account de WhatsApp Business que está aprovisionando.
  3. El ID de su cuenta de WhatsApp Business se encuentra en la parte superior de la página, debajo del nombre de la cuenta de WhatsApp Business.

Numbers de téléphone

  1. Navegue hasta su entorno empresarial y seleccione Accounts > Cuentas de WhatsApp.
  2. Seleccione la Account de WhatsApp Business que está aprovisionando.
  3. En virtud de la Ajustes abrir WhatsApp Manager > Números de teléfono.
  4. Busca el número de teléfono que quieras en la lista.

Certificado (asociado a su número de teléfono)

  1. Navegue hasta su entorno empresarial y seleccione Accounts > Cuentas de WhatsApp.
  2. Seleccione la Account de WhatsApp Business que está aprovisionando.
  3. En virtud de la Ajustes abrir WhatsApp Manager > Números de teléfono.
  4. Busca el número de teléfono que quieras en la lista.
  5. Haz clic en el Ver (en la Certificado columna).
  6. Copia el certificado correspondiente en el portapapeles y pégalo en un documento aparte. Lo necesitarás en un paso posterior.

Crear una aplicación de Vonage

Una aplicación API de Vonage contiene la información de seguridad y configuración que necesitas para conectarte a los puntos finales de Vonage y usar las API de Vonage. En este caso, debes crear una aplicación que use la API de Messages API de Vonage.

Nota: Tu cuenta de WhatsApp debe estar vinculada a tu cuenta de Vonage antes de poder vincularla a una aplicación de Vonage. Puedes vincular tu cuenta de WhatsApp a tu cuenta de Vonage a través de la Panel de control de la API de Vonage.

  • Tanto los ejemplos de CLI como los de Dashboard son aquí

Genere su JWT

CONSEJO: Solo tienes que seguir este paso si estás realizando pruebas con Curl, ya que los SDK de cliente y servidor generan los JWT según sea necesario.

Una vez que hayas creado una aplicación de la API de Vonage, podrás utilizar el ID de la aplicación y el archivo de clave privada, private.key, para generar un JWT.

Para crear un token JWT utilizando el CLI de Vonageutilice 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

También puede utilizar nuestro Aplicación web JWT para generar un JWT.

CONSEJO: Puedes probar el JWT que has generado en jwt.io

Implementación de WhatsApp

Clave Descripción
country_code El código de marcación internacional del número que se está aprovisionando.
number El número de WhatsApp que se está aprovisionando.
vname_certificate El certificado, que puedes consultar en el panel de control de WhatsApp Business. > NOTA: Cada vez que hagas clic en el Ver el certificado cambiará. Descargue o copie su certificado para poder utilizarlo en un paso posterior.
method El método de entrega de la contraseña de un solo uso (OTP). Debe ser sms o voice.
waba_id El ID de la cuenta de WhatsApp Business del número de 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"
      }'

Una vez aprovisionado, el clúster de WhatsApp pasa por las siguientes fases de implementación: INITIALIZING, CREATING_CLUSTER y CLUSTER_CREATED. Cuando el CLUSTER_CREATED Una vez alcanzada esta fase, se envía una llamada de voz OTP o un SMS al número especificado y el estado de la implementación pasa a ser CODE_SENT. Cuando recibas el código OTP, llama a la API Verify para completar el proceso.

Verify the OTP code

Clave Descripción
code La contraseña única que se envía para su verificación. 
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" }'

Ahora que el clúster de WhatsApp se ha desplegado correctamente, puede gestionar su Perfil de WhatsApp Business.

Referencia