Plataforma de WhatsApp Business

Primeros pasos

En este documento se describen los requisitos y los pasos que debes completar para integrar el flujo de registro insertado en tu sitio web o el portal del cliente.

Antes de empezar

Para empezar la integración del flujo de registro insertado, la cuenta de Business Manager y la aplicación de Meta deben estar configuradas.

Business Manager

Necesitas una cuenta de Business Manager para administrar tu línea de crédito y las cuentas de WhatsApp Business (WABA) de los clientes incorporados. Para obtener información sobre cómo crear una cuenta empresarial, consulta Crear un Business Manager. Una vez que tengas una cuenta de Business Manager configurada, verifica la empresa.

Aplicación de Meta

Desde la cuenta de desarrollador de Meta, crea una aplicación de tipo empresarial. Desde el panel de aplicaciones, puedes acceder a cualquiera de tus aplicaciones de Meta para controlar la configuración y solicitar permisos.

Las aplicaciones empresariales tienen aprobado automáticamente el Standard Access para todos los permisos y funciones disponibles en las aplicaciones de este tipo. Así pues, si tienes este nivel de acceso, puedes desarrollar y probar tu aplicación.

El acceso estándar restringe de forma efectiva las aplicaciones empresariales para que solo puedan acceder a los datos que pertenezcan a usuarios de la aplicación con un rol en esta o en la empresa. Antes de publicar la aplicación de Meta, esta debe superar la revisión de la aplicación y debes solicitar acceso avanzado al permiso whatsapp_business_management. Te recomendamos que inicies este proceso lo antes posible. No es necesario esperar a que el registro insertado esté completamente implementado para iniciar este proceso.

También necesitas solicitar el permiso whatsapp_business_messaging para la API de nube de WhatsApp, ya que se requiere para las llamadas a la API.

Recomendamos encarecidamente que no solicites permisos adicionales además de estos dos, ya que esto ralentizará innecesariamente el proceso de registro.

Identificadores de acceso

Tanto los identificadores de acceso de usuario del sistema de integración empresarial como los identificadores de acceso de usuario del sistema se pueden utilizar para acceder a los datos de los clientes incorporados. El tipo de identificador que uses dependerá de si vas a configurar el registro insertado con el inicio de sesión con Facebook o con el inicio de sesión con Facebook para empresas, y de si eres proveedor de tecnología o proveedor de soluciones.

Proveedores de tecnología

El identificador preferido para los proveedores de tecnología es el identificador de acceso de usuario del sistema de integración empresarial, ya que este tipo de identificador es específico de cada cliente. Puedes obtener un identificador de este tipo intercambiando el código que se te devuelve cuando un cliente completa el registro insertado configurado con el inicio de sesión con Facebook para empresas. Si usas el registro insertado configurado con el inicio de sesión con Facebook (no se recomienda), debes usar un identificador de acceso de usuario del sistema en su lugar.

Si usas un identificador de acceso de usuario del sistema, el usuario del sistema debe conceder a tu aplicación el permiso whatsapp_business_management.

Socios de soluciones

Debes usar un identificador de acceso de usuario del sistema para compartir tu línea de crédito con los clientes incorporados. Para el resto de solicitudes, la solución preferida es usar un identificador de acceso de usuario del sistema de integración empresarial.

Puedes obtener un identificador de acceso de usuario del sistema de integración empresarial intercambiando el código que se te devuelve cuando un cliente completa el registro insertado configurado con el inicio de sesión con Facebook para empresas. Si usas el registro insertado configurado con el inicio de sesión con Facebook (no se recomienda), debes usar un identificador de acceso de usuario del sistema en su lugar.

Ten en cuenta que para los identificadores de acceso de usuario del sistema, tu sistema debe haber concedido a la aplicación el permiso whatsapp_business_management (que puedes conceder al generar el identificador. Además, se le debe haber concedido al usuario del sistema el rol de editor financiero para poder compartir tu línea de crédito con los clientes incorporados.

Para conceder el rol de editor financiero al usuario del sistema, haz lo siguiente:

  1. Inicia sesión en Meta Business Suite.
  2. Localiza la cuenta empresarial en el menú desplegable de la parte superior izquierda y haz clic en el icono Configuración (engranaje).
  3. Haz clic en Configuración de la empresa.
  4. Ve a Usuarios > Usuarios del sistema.
  5. Edita el usuario y concédele el rol de editor financiero.

Línea de crédito

Debes configurar una línea de crédito para enviar mensajes con la Plataforma de WhatsApp Business. Esta es la línea de crédito que compartirás con los clientes, de modo que debes asegurarte de aceptar las condiciones de la API de asignación de crédito disponibles en Configuración de la empresa > Pagos en Business Manager.

Para obtener información sobre cómo compartir la línea de crédito mediante Business Manager, en lugar de hacerlo mediante la API, consulta Compartir acceso a la facturación mensual.

Cliente de la API local de la Plataforma de WhatsApp Business

Si utilizas la API local, asegúrate de estar ejecutando una versión que no haya caducado del cliente de la API de WhatsApp Business.

Proceso de integración

Como parte del proceso de integración, la aplicación de Meta debe superar la revisión de la aplicación y debes solicitar acceso avanzado al permiso whatsapp_business_management. Te recomendamos que inicies este proceso lo antes posible. No es necesario que esperes a que el registro insertado esté completamente implementado para iniciar este proceso.

1: Insertar el flujo de registro

Configura el SDK de Facebook para JavaScript y el inicio de sesión con Facebook para insertar el flujo de registro en el sitio web o el portal del cliente. Puedes insertar el flujo en distintas páginas web o portales de tu propiedad.

2: Realizar la integración con los extremos requeridos

Después de insertar el flujo de registro, realiza la integración con los extremos de la API necesarios para completar el proceso. Para continuar con el paso siguiente, debes poder completar estas acciones:

Una vez completado el registro, utiliza el extremo message_templates para obtener espacios de nombres y plantillas de mensaje preaprobadas de modo que las empresas puedan empezar a enviar mensajes.

Debes utilizar un extremo seguro (HTTPS). Para obtener más información, consulta Seguridad del inicio de sesión.

3: Suscribir cuentas WABA para recibir webhooks

Una vez que las empresas han completado el registro, puedes suscribirte a todas las cuentas WABA para las que quieras recibir webhooks. Puedes configurar webhooks para recibir notificaciones cuando:

  • se actualice un número de teléfono;
  • se actualice el estado de calidad de un número de teléfono;
  • se revise, actualice o bloquee una cuenta.

Opcional

Si quieres, puedes hacer lo siguiente:

Más información