Flujo de inscripción integrado en WhatsApp para socios tecnológicos

El flujo de registro integrado alojado de WhatsApp es una interfaz de usuario de incorporación de marca blanca. Permite a los socios de Vonage dar de alta a sus clientes en Accounts de WhatsApp Business sin necesidad de crear, configurar ni alojar su propio flujo de registro integrado.

Requisitos previos

Para aprovechar la solución de inscripción integrada, los socios de Vonage deben cumplir los siguientes requisitos previos:

• Registrarse en Meta como proveedor de tecnología
• Tener una metaaplicación activa en el panel de aplicaciones
• Disponer de permisos de «Control total» o de administrador en la cartera empresarial en la que se va a dar de alta un número de WABA o WhatsApp
• Has enviado una solicitud de solución a Vonage, la solicitud ha sido aceptada y se te ha proporcionado un ID de solución.

Si tienes alguna duda o necesitas ayuda con cualquiera de los requisitos previos mencionados anteriormente, ponte en contacto con tu gestor de cuentas de Vonage.

Flujo de procesos

El proceso para registrarse en WhatsApp Hosted Embedded es el siguiente:

1. El socio de Vonage genera una URL de registro integrada
2. El socio puede compartir la URL con sus clientes (por ejemplo, por correo electrónico o SMS, o incrustando la URL en su propia página web).
3. La URL dirige al cliente a una experiencia de flujo de registro incrustado de marca blanca alojado por Vonage a través del cual se puede completar el registro de onboarding de WhatsApp Business Account (WABA) o WhatsApp number
4. El cliente completa el proceso de alta mediante el flujo de registro integrado.

Generar una URL de registro incrustada

Se puede generar una URL de registro incrustada realizando una solicitud POST al archivo Generar el punto final de la URL de ES Flow alojado de la API de Channel Manager.

La autenticación puede realizarse mediante autenticación básica o mediante un token de portador (JWT).

El cuerpo de la solicitud debe contener un objeto JSON con, al menos, un elemento solution_id propiedad cuyo valor es el ID de solución facilitado por Vonage (véase requisitos previos).

El cuerpo también puede contener un api_key para identificar la subcuenta de Vonage del cliente para el cual el socio desea crear la URL (si se omite esta propiedad, se utilizará la clave de API principal para la cuenta principal de Vonage).

A ttl también puede especificarse para establecer el límite de tiempo de validez de la URL generada (Máximo 3 días; si se omite, se utiliza el valor predeterminado de 86 400 segundos, es decir, un día).

Ejemplo de cuerpo de la solicitud

{
  "solution_id": "123456789111213",
  "api_key": "abc123", // Optional
  "ttl": 3600 // Optional
}

Ejemplo de cuerpo de respuesta

Una respuesta correcta devolverá un código de estado HTTP de 200 e incluir un cuerpo de respuesta con un objeto JSON que contenga la URL de registro incrustada generada, así como un ID de rastreo para la solicitud.

{
  "id": "3amb0119-0196-42d1-8fb5-55a98s133546",
  "url": "https://tools.vonage.com/wa/partners/onboard?token=fhdhhdJhbGciOiJSUzI1NiJ9.eyJleHAiOjE3MjU5Njc1OTYsImp0aSI6ImQ1MmJhNmFjLWYxZjktNDdmNC05MTR_cFT1bVfkDhP-wgpKZibSbUoh9z-9KGD-wsmHxi0h7tTidpVhPNShfC5jmgiHtOQKXXv5NWb9OqoUraOMMpqCdNdXoN3ao-PeZX7axyYW_FQ6CeV9gDEPhAZ4urTi0uW4mCYGl3ULmA9Ps92r_wi2DJyRE_Kx2KahWtQd51yVpU6FfXgMb4odREEccDctT1Peo09wKgwBa1wsOkD7rrvkoQPqZ00VXcqOY1_LOO5tq4WJaKqtxX-U7VtDo9qyVUl8pdegZW6QWChQzGN4PkqXXLWcBlyrCtAYdhtWG8q6NM_6bARRjcGJlj0tQvE0PZ9AtafAQSPpOll5lcnUK8Ds"
}

Cómo comprobar el estado del número de verificación del teléfono de WhatsApp

Como parte del proceso de registro del número en WhatsApp, se enviará una contraseña de un solo uso (OTP) al número que se está registrando para verificarlo. La verificación debe completarse con éxito antes de poder utilizar el número.

El estado de la verificación del número se puede comprobar de las siguientes maneras:

• Comprobar manualmente el estado de un número
• Suscribirse a las actualizaciones sobre un número

Comprobar manualmente el estado de un número

Para comprobar manualmente el estado de un número, puedes visitar la interfaz WhatsApp Manager de tu WABA. Un número activo mostrará un estado de Conectado.

Suscribirse a las actualizaciones sobre un número

Puede suscribirse a las actualizaciones sobre el cambio en el estado de verificación de un número utilizando Suscripciones a notificaciones de WhatsApp.

Se pueden crear suscripciones para muchos eventos diferentes; puede obtener más información al respecto en la sección Documento guía de suscripciones a notificaciones de WhatsApp. Para las actualizaciones del estado de los números, debe crear una suscripción con la función account_update tipo de suscripción en el whatsapp_subscribe_typesy también el vonage_number_onboarded tipo de suscripción en el vonage_subscribe_types.

La notificación se activa mediante un PARTNER_ADDED evento y se envía al webhook o al hook de Slack que hayas especificado al crear la suscripción. La carga útil de la notificación incluirá el waba_id, solution_idy owner_business_id detalles.

La carga útil de un POST solicitud a la https://api.nexmo.com/v2/whatsapp-manager/subscriptions El punto final tendría un aspecto similar al siguiente:

{
  "type": "webhook",
  "label": "#dk-test",
  "whatsapp_subscribe_types": "account_update", // or can be left blank ""
  "vonage_subscribe_types": "vonage_number_onboarded",
  "webhook": {
      "url" : "https://eo34s4y0tl.m.pipedream.net"
  }
}

Vincular un número de WhatsApp con una aplicación de Vonage

Para poder utilizar el número de WhatsApp para enviar mensajes a través de la Messages API de Vonage, es necesario vincularlo a una aplicación de Vonage.

Esto se puede hacer a través de la Panel de Vonage o a través del Vincular una aplicación a un punto final de Account de la API de cuentas externas.

Notas para los socios

• No es necesaria ninguna habilitación específica para que un socio o proveedor técnico de Vonage utilice el flujo de registro integrado alojado. Se puede acceder a él a través de la página principal api-key y las credenciales asociadas.
• Solo las cuentas de WhatsApp Business Account (WABA) "compartidas" de los clientes pueden incorporar nuevos números de WhatsApp a través del flujo de registro incrustado alojado o de cualquier flujo de registro incrustado. En el caso de las WABA de OBO, la incorporación debe ser manual. Consulte la página Documentación de Meta para más información sobre OBO y WABA compartidos.
• Los socios/proveedores de tecnología de Vonage deben asegurarse de que su(s) cliente(s) que usa(n) el flujo integrado alojado haya(n) completado los detalles comerciales en la sección de información de su cartera de negocios. Si alguno de los detalles requeridos, por ejemplo, el email comercial del usuario, no es válido, es probable que el proceso de incorporación falle.
• Durante el registro de números de WhatsApp, el tiempo de respuesta previsto de la Meta API puede ser de hasta 120 s.
• Meta limita el número de intentos de registro o baja para cada número de WhatsApp (10 intentos por número a la semana). Una vez alcanzado este límite, el número quedará bloqueado para el registro.