Estamos implementando un cambio en el que el acceso compartido a la API se concederá en el proceso de registro insertado tras guardar el identificador. En caso de tener problemas inesperados o que afecten al proceso de registro insertado, contacta con el equipo de Asistencia.

Registro insertado

El registro insertado es una interfaz de autenticación y autorización compatible con móviles y ordenadores que facilita que tus clientes empresariales generen los activos necesarios para incorporarlos correctamente a la Plataforma de WhatsApp Business.

Se ha producido un error
Tenemos problemas para reproducir este vídeo.

El proceso de registro insertado recopila información de los clientes empresariales relacionada con la empresa, genera automáticamente todos los activos de WhatsApp que necesita la plataforma y concede a la aplicación acceso a dichos activos, de modo que puedas proporcionar rápidamente a tus clientes empresariales servicios de mensajes de WhatsApp.

Los clientes incorporados mediante el registro insertado son los propietarios de todos sus activos de WhatsApp y pueden aprovecharlos junto con otras soluciones de Meta como los anuncios de clic a WhatsApp.

Funcionamiento

El registro insertado aprovecha el producto de inicio de sesión con Facebook para empresas y nuestro SDK para JavaScript. Una vez configurado, puedes añadir un enlace o botón en tu sitio web o portal que inicie el proceso.

A los clientes empresariales que hacen clic en el enlace o el botón se les presenta una nueva ventana en la que podrán realizar las siguientes acciones:

  • Autenticar su identidad con sus credenciales de Facebook o Meta para empresas.
  • Conceder a la aplicación acceso a sus activos de WhatsApp.
  • Seleccionar un porfolio empresarial existente o crear uno nuevo.
  • Seleccionar una cuenta de WhatsApp Business (WABA) existente o crear una nueva.
  • Introducir y verificar su número de teléfono de empresa (el suyo propio o el que les hayas proporcionado).
  • Introducir un nombre para mostrar que puede aparecer en lugar del número en el cliente de WhatsApp.

Una vez que se ha completado correctamente, el registro insertado devuelve el identificador de la cuenta WABA del cliente, el identificador del número de teléfono de empresa y un código de identificador intercambiable en la ventana en la que se produjo el proceso. Debes enviar estos datos a tu servidor y usarlos en una llamada entre servidores para hacer lo siguiente:

  • Intercambiar el código por un identificador de empresa específico del cliente.
  • Registrar el número de teléfono de empresa del cliente para usarlo con la API de nube.
  • Suscribir a la aplicación a webhooks en la cuenta WABA del cliente.
  • Compartir la línea de crédito con el cliente (solo para socios de soluciones).

Cuando estos pasos se han completado, si eres socio de soluciones o estás asociado con uno, el cliente puede comenzar inmediatamente a usar tu aplicación o la de tu socio para enviar y recibir mensajes. Si no eres socio de soluciones o no estás asociado con ninguno, el cliente deberá adjuntar un método de pago a su cuenta WABA antes de poder empezar a enviar y recibir mensajes.

Limitaciones

Límites de incorporación

De forma predeterminada, puedes incorporar un máximo de diez clientes empresariales en un periodo continuo de siete días. Solo los clientes recién incorporados se tienen en cuenta para este límite. Puedes comprobar cuántos clientes tienes incorporados actualmente en el Administrador de WhatsApp > Información general sobre los socios. Se te notificará mediante correo electrónico si te acercas a este límite.

Si completas la verificación de la empresa, la revisión de la aplicación y la verificación de acceso, incrementaremos automáticamente el límite a 200 clientes empresariales nuevos en un periodo continuo de siete días. Si necesitas incorporar a más de 200 clientes por semana, solicita convertirte en Meta Business Partner.

Límites de mensajes para clientes empresariales

Los clientes empresariales incorporados mediante el registro insertado comienzan con límites de mensajes estándar, que se pueden incrementar con el uso de la API.

Límites de números de teléfono para clientes empresariales

  • Los números de teléfono de empresa solo se pueden registrar para usarlos con la API de nube.
  • No se admiten los números de teléfono de empresa que ya estén registrados para usarlos con la API local o que estén en uso con WhatsApp o la aplicación de WhatsApp Business.
  • Los clientes empresariales incorporados mediante el registro insertado comienzan con los límites de números de teléfono de empresa predeterminados.

Proceso predeterminado

En Proceso predeterminado, consulta las descripciones de las pantallas que se les presentarán a los clientes de tu empresa como parte de la implementación predeterminada del registro insertado.

Ten en cuenta que, si tienes información sobre las empresas de tus clientes, puedes inyectar estos datos, lo que puede reducir significativamente el número de pantallas con las que deberán interactuar los clientes.

Identificadores de acceso

El registro insertado genera identificadores de acceso de usuario del sistema de integración empresarial (“identificadores de empresa”). Cuando un cliente empresarial complete el proceso de registro insertado, se devolverá un código de identificador intercambiable en forma de evento de mensaje que capturará el SDK de JavaScript. Debes intercambiar este código por un identificador de empresa mediante una llamada entre servidores.

Si eres proveedor de tecnología, usarás identificadores de empresa exclusivamente.

Si eres socio de soluciones, usarás el identificador de acceso de usuario del sistema (“identificador del sistema”) para compartir tu línea de crédito con los clientes empresariales incorporados e identificadores de empresa para todo lo demás. Ten en cuenta que el usuario del sistema al que representa el identificador debe haber concedido a tu aplicación el permiso business_management y debe tener concedido el rol de administrador o editor financiero en tu porfolio empresarial para poder compartir la línea de crédito.

Permisos

El registro insertado se puede configurar para que solicite a los clientes empresariales la mayoría de permisos, pero es probable que solo vayas a necesitar los siguientes:

  • whatsapp_business_management: necesario si la aplicación necesita acceso a la configuración de la cuenta de WhatsApp Business del cliente y a las plantillas de mensajes.
  • whatsapp_business_messaging: necesario si la aplicación necesita acceso a la configuración de números de teléfono de empresa de los clientes incorporados o si los clientes van a usar la aplicación para enviar y recibir mensajes.

Puedes especificar qué permisos necesita la aplicación durante el proceso de implementación.

Ten en cuenta que, mientras la aplicación esté en modo de desarrollo, estos permisos aparecerán en la pantalla de autorización del registro insertado para los usuarios que tengan el rol de administrador, desarrollador o evaluador en la aplicación. Sin embargo, una vez que hagas el cambio de la aplicación al modo publicado, solo los permisos para los que se haya aprobado el acceso avanzado mediante el proceso de revisión de la aplicación aparecerán en el proceso.

Facturación

Socios de soluciones

Si eres socio de soluciones, debes tener una línea de crédito y haber aceptado las condiciones de la API de asignación de crédito en la ventana Configuración de la empresa > Pagos de Meta Business Suite. Además, debes compartir tu línea de crédito con los clientes como parte del proceso de incorporación.

Proveedores de tecnología y socios de tecnología

Si eres proveedor de tecnología o socio de tecnología, los clientes empresariales incorporados deben añadir un método de pago a su cuenta de WhatsApp Business. Para ello, pueden seguir los pasos que se describen en nuestro artículo del Servicio de ayuda Añadir una tarjeta de crédito a tu cuenta en la plataforma de WhatsApp Business.

Números de teléfono de empresa 555

Los clientes que tengan empresas verificadas o empresas que hayan aumentado los límites de mensajes de la API de nube pueden recibir hasta dos números de teléfono de empresa 555.

Estos números funcionan igual que los números de teléfono de empresa normales (se debe revisar y aprobar su nombre para mostrar, están sujetos a las reglas de precios basadas en conversaciones, se ven afectados por las calificaciones de calidad, etc.), pero tienen las siguientes diferencias clave:

  • Tienen el código de país de EE. UU. (+1).
  • Tiene el código de área 555.
  • Se verifican automáticamente.
  • No se pueden migrar a otra cuenta de WhatsApp Business ni se pueden utilizar fuera de la Plataforma de WhatsApp Business.

Si los clientes de tu empresa son aptos para tener números 555 y quieren registrar uno como número adicional, indícales que repitan la implementación del registro insertado. Cuando se les pida que seleccionen un número de teléfono de empresa, automáticamente tendrán la opción de elegir un número 555:

Revisión de la aplicación

No podrás incorporar clientes empresariales hasta que no se haya aprobado el acceso avanzado para tu aplicación para todos los permisos que necesite.

Consulta Revisión de la aplicación para obtener más información sobre la revisión de la aplicación y los requisitos para completar el proceso correctamente.

Asistente de integración

El asistente de integración para el registro insertado es una herramienta de configuración y pruebas del panel de aplicaciones. La herramienta te permite:

  • Lanzar el registro insertado en varias configuraciones del proceso.
  • Ver los datos que se devuelven cuando un cliente empresarial completa el proceso.
  • Generar código de implementación y consultas de incorporación que puedes copiar y pegar en un sitio web, un portal de cliente empresarial y un servidor.
  • Enviar consultas de API a los extremos que tendrás que utilizar al incorporar a los clientes que completen el proceso.

Para acceder al asistente de integración, ve al panel de aplicaciones > WhatsApp > Integración ES.

Webhooks

Como parte del proceso de incorporación, debes suscribir a tu aplicación a webhooks en la cuenta WABA de cada cliente empresarial que complete el proceso de registro insertado.

Los webhooks se activarán y se enviarán a la URL de devolución de llamada configurada en la aplicación de acuerdo con los campos de webhooks a los que te hayas suscrito. Esto significa que todos los webhooks de todos los clientes empresariales incorporados se enviarán a la URL de devolución de llamada de tu aplicación. Sin embargo, puedes anular la URL de devolución de llamada en una cuenta individual de WhatsApp Business o un número de teléfono de empresa. Consulta Anulaciones de webhooks para obtener más información sobre cómo hacerlo.

Localización

El proceso de registro insertado está disponible en 30 idiomas. El proceso localizado se activa automáticamente en función del idioma en que el cliente empresarial utiliza Facebook.

Árabe, checo, danés, griego, inglés (Reino Unido), español (España), finlandés, francés (Francia), hebreo, hindi, húngaro, indonesio, italiano, japonés, coreano, noruego (bokmal), neerlandés, polaco, portugués (Brasil), portugués (Portugal), rumano, ruso, sueco, tailandés, turco, vietnamita, chino simplificado (China), chino tradicional (Hong Kong), chino tradicional (Taiwán).

Siguientes pasos

Obtén más información sobre cómo implementar el registro insertado en tu sitio web o portal.