Primeros pasos
En este documento, se describen los pasos y requisitos que debes completar para integrar el proceso de registro insertado en tu sitio web o portal de cliente.
Antes de empezar
Para comenzar con la integración del proceso de registro insertado, es necesario que tengas primero configurados el administrador comercial y la app de Meta.
Administrador comercial
Necesitas una cuenta del administrador comercial para administrar tu línea de crédito y las cuentas de WhatsApp Business (WABA) de los clientes registrados. Para obtener información sobre cómo crear una cuenta comercial, consulta Crear un administrador comercial. Una vez que hayas configurado un administrador comercial, verifica tu negocio.
App de Meta
Crea una app de tipo comercial desde tu cuenta de desarrollador de Meta. Puedes acceder desde el panel de apps a cualquiera de tus apps de Meta para controlar la configuración y solicitar permisos.
A las apps de negocios se les otorga de forma automática acceso estándar a todos los permisos y todas las funciones disponibles en el tipo de app de negocios, por lo que podrás desarrollar y evaluar la app mientras te encuentres en este nivel de acceso.
El acceso estándar restringe de manera eficaz el acceso de las apps de negocios solo a los datos de propiedad de los usuarios de la app que tienen un rol en la app o en la empresa. Para publicarla, es necesario someter a la app de Meta a la revisión de apps y solicitar acceso avanzado al permiso whatsapp_business_management. Recomendamos realizar este proceso lo antes posible. No es necesario que esperes a que el registro insertado esté totalmente implementado para iniciar este proceso.
También es necesario que solicites el permiso whatsapp_business_messaging para la API de la nube de WhatsApp, ya que es obligatorio para las llamadas a la API.
Se recomienda encarecidamente que no solicitar permisos adicionales además de estos dos, ya que hacerlo ralentizará innecesariamente el proceso de registro.
Tokens de acceso
Tanto los tokens de acceso del usuario del sistema de integración comercial como los tokens de acceso del usuario del sistema se pueden usar para acceder a los datos de los clientes registrados. El tipo de token que uses dependerá de si vas a configurar el registro insertado con el inicio de sesión con Facebook o si lo vas a configurar con el inicio de 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 token preferido para los proveedores de tecnología es un token de acceso del usuario del sistema de integración comercial, ya que se adaptan a los clientes individuales. Puedes obtener uno de estos tokens si intercambias el código que se devuelve cada vez que un cliente completa el registro insertado configurado con el inicio de sesión de Facebook para empresas. Si usas el registro insertado configurado con el inicio de sesión con Facebook (lo que no se recomienda), debes usar un token de acceso del usuario del sistema.
Si usas un token de acceso del usuario del sistema, el usuario del sistema debe concederle a tu app el permiso whatsapp_business_management.
Socios de soluciones
Debes usar un token de acceso del usuario del sistema para compartir tu línea de crédito con los clientes registrados. En cuanto al resto de las solicitudes, la solución preferida es usar un token de acceso del usuario del sistema de integración comercial.
Puedes obtener uno de estos tokens si intercambias el código que se 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 (lo que no se recomienda), debes usar un token de acceso del usuario del sistema.
Ten en cuenta que en el caso de los token de acceso del usuario del sistema, tu usuario del sistema debe haber concedido a tu app el permiso whatsapp_business_management (que puedes conceder cuando generas el token), y el usuario del sistema debe tener el rol de editor financiero para compartir tu línea de crédito con los clientes registrados.
Para conceder a tu usuario del sistema el rol de editor financiero:
- Inicia sesión en Meta Business Suite.
- Localiza tu cuenta comercial en el menú desplegable superior izquierdo y haz clic en el icono de configuración (engranaje).
- Haz clic en Configuración del negocio.
- Dirígete a Usuarios > Usuarios del sistema.
- Edita el usuario y concédele el rol de editor financiero.
Línea de crédito
Es necesario que configures una línea de crédito para enviar mensajes con la API de la Plataforma de WhatsApp Business. Esta es la línea de crédito que compartirás con tus clientes. Por esta razón, asegúrate de aceptar las condiciones de la API de asignación de crédito que figuran en el administrador comercial en Configuración del negocio > Pagos.
Consulta Compartir acceso a la facturación mensual para obtener información sobre cómo compartir la línea de crédito a través del administrador comercial, en vez de hacerlo a través de la API.
Cliente de la API de instalaciones locales de la Plataforma de WhatsApp Business
Si usas la API de instalaciones locales, asegúrate de ejecutar una versión actual del cliente de la API de WhatsApp Business.
Proceso de integración
Como parte del proceso de integración, es necesario someter a la app de Meta a la revisión de apps y solicitar acceso avanzado al permiso whatsapp_business_management. Recomendamos realizar este proceso lo antes posible. No es necesario que esperes a que el registro insertado esté totalmente implementado para iniciar este proceso.
Paso 1: Inserta el proceso de registro
Configura el SDK de Facebook para JavaScript y el inicio de sesión con Facebook para insertar el proceso de registro en el sitio web o portal del cliente. Puedes insertar dicho proceso en varios sitios web o portales de tu propiedad.
Paso 2: Integra los puntos de conexión obligatorios
Después de insertar el proceso de registro, intégralo con los puntos de conexión de la API que se necesitan para completar el proceso de integración. Para pasar al siguiente paso, es necesario que puedas realizar lo siguiente:
Una vez que finalice la operación, usa el punto de conexión message_templates a fin de obtener plantillas de mensajes preaprobadas y espacios de nombres para que los negocios puedan comenzar a enviar mensajes.
Debes usar un punto de conexión seguro (HTTPS). Para obtener más información, consulta Seguridad de inicio de sesión.
Paso 3: Suscribe WABA para recibir webhooks
Cuando los negocios hayan finalizado el registro, puedes suscribir todas las WABA para las que quieres recibir webhooks. Puedes configurar los webhooks para recibir notificaciones cuando:
- se actualizó el nombre de un número de teléfono;
- se actualizó el estado de calidad de un número de teléfono; y
- se verificó, actualizó o prohibió una cuenta.
Opcional
Si quieres, puedes hacer lo siguiente: