Aprovisionar el despliegue de WhatsApp

Antes de empezar

Antes de desplegar el clúster de WhatsApp, debe recopilar cierta información del Ajustes en la página 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. Localice el número de teléfono deseado 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. Localice el número de teléfono deseado en la lista.
  5. Haga clic en el botón Ver (en la Certificado columna).
  6. Copie el certificado asociado en el portapapeles y péguelo en un documento aparte. Lo necesitará 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 conectada a tu cuenta de Vonage antes de que puedas vincularla a una aplicación de Vonage. Puedes conectar tu cuenta de WhatsApp a tu cuenta de Vonage a través de la opción Panel de API de Vonage.

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

Genere su JWT

TIP: Sólo tiene que realizar este paso si está realizando pruebas con Curl, ya que los SDK de cliente y servidor generan los JWT según sus necesidades.

Una vez que hayas creado una aplicación API de Vonage, podrás usar 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 método 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

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

TIP: Puede probar el JWT generado en jwt.io

Provisión Despliegue 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 recuperar desde tu panel de WhatsApp Business. > NOTA: Cada vez que pulse el botón 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 etapas de despliegue: INITIALIZING, CREATING_CLUSTER y CLUSTER_CREATED. Cuando el CLUSTER_CREATED se envía una llamada de voz OTP o un SMS al número especificado y el estado de despliegue pasa a ser CODE_SENT. Cuando reciba la OTP, llame a la API Verify para completar el proceso.

Verify OTP

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