Cómo migrar números de teléfono entre cuentas de WhatsApp Business mediante registro insertado
En este documento, se describe cómo usar el registro insertado para migrar números de teléfono del negocio de una cuenta de WhatsApp Business (WABA) a otra.
Los clientes pueden migrar sus números de teléfono del negocio entre las cuentas de WhatsApp Business (WABA) y conservar sus nombres para mostrar, calificaciones de calidad, límites de mensajes de plantilla, estados de cuentas comerciales oficiales y plantillas aprobadas de alta calidad. La migración se suele realizar cuando un cliente desea pasar su número de teléfono del negocio de un socio de soluciones a otro.
Para realizar una migración de un cliente, tienes dos opciones: migración mediante registro insertado o migración programática.
La migración mediante registro insertado es más simple y es la solución preferida porque pueden iniciarla los clientes, genera y otorga automáticamente la propiedad de todos los recursos necesarios, otorga a la app acceso a dichos recursos y requiere menos llamadas a la API.
En cambio, eres tú quien debe iniciar la migración programática, que involucra más llamadas a API, ya que debes verificar que los recursos dependientes estén configurados correctamente, generar todos los nuevos recursos obligatorios y asociarlos con otros recursos. Por esta razón, la migración programática solo es recomendable si se trabaja con el cliente utilizando el modelo "On-Behalf-Of" (por ejemplo, crearás y será el titular del destino de la WABA y de sus recursos y los compartirás con el cliente).
Si quieres migrar números de teléfono del negocio de manera programática, consulta nuestro documento Migrar números entre cuentas de WhatsApp Business de manera programática.
Cómo funciona
Los clientes pueden usar la implementación de registro insertado (versión 2) para comenzar el proceso de migración. El registro insertado solicitará a los clientes el número de teléfono del negocio y un nuevo destino para la cuenta de WhatsApp Business (WABA).
Cuando el cliente completa el proceso, el registro insertado genera una nueva WABA; la asocia con el portfolio comercial de Meta; otorga a la app acceso a la WABA; y, luego, devuelve el identificador recién creado del número de teléfono del negocio y de la WABA.
Debes capturar estos identificadores y usarlos con la API para compartir tu línea de crédito, suscribirte a webhooks y registrar el número para usarlo con la API de la nube. Una vez completado el paso final (registro), el número de teléfono del negocio se vuelva a asociar al destino de la WABA, y el número puede usarse para enviar y recibir mensajes nuevamente.
Dado que el número de teléfono del negocio del cliente no cambia, se conservan el nombre para mostrar, la calificación de calidad, el límite de mensajes y el estado de la cuenta comercial oficial.
Además, todas las plantillas que cumplen con los requisitos se duplican de manera automática en el destino de la WABA y se les otorgan los mismos estados que sus homólogos fuente, y se puede seguir usando todo el contenido multimedia subido al número de teléfono del negocio del cliente.
Cuentas de WhatsApp Business
El registro insertado genera automáticamente la nueva WABA del cliente, la asocia con su cuenta comercial de Meta y otorga a tu app acceso a la WABA.
Plantillas
Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.
Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.
Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.
Facturación
Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.
Messages sent after migration is complete are charged to the new Solution Partner.
Tiempo de inactividad de la plantilla
El registro de los números de teléfono del negocio se realiza de manera instantánea. Por este motivo, puedes continuar enviando y recibiendo mensajes sin sufrir interrupciones.
Sin embargo, la duplicación de las plantillas lleva tiempo, por lo que no podrás usar las plantillas afectadas hasta que se migren.
Con el fin de evitar tiempo de inactividad, puedes comenzar primero la migración de las plantillas antes de realizar el registro del número de teléfono.
Límites de frecuencia
La duplicación de plantillas que se activa automáticamente como parte del proceso de migración no se tiene en cuenta para la limitación de frecuencia. Las llamadas a la API que realizas, sin embargo, sí se restan de la limitación.
Limitaciones
- No es posible migrar los números de teléfono de prueba de una empresa que emitió WhatsApp.
- Los números de teléfono del negocio deben registrarse para que se pueda usar con la API de la nube.
- El historial de mensajes y el contenido multimedia subido no se migrarán si la WABA está en la API de instalaciones locales.
- Los números de teléfono del negocio deben tener un nombre para mostrar aprobado (el
name_statusdebe serAPPROVED). - Los números de teléfono del negocio no pueden tener asociadas solicitudes pendientes de cambio del nombre para mostrar.
- Las calificaciones de calidad de las plantillas no se migrarán. Todas las plantillas migradas comenzarán con la calificación
UNKNOWN. Esta calificación se conservará durante las primeras 24 horas, después de las cuales se generará una nueva calificación, si hay suficientes datos disponibles.
Requisitos
Clientes
Pide al cliente propietario del número de teléfono del negocio que confirme que cumple con los siguientes requisitos. Si son dueños de la WABA, pueden hacerlo por medio del administrador comercial de Meta en Cuentas de WhatsApp > (el nombre de la WABA) > Configuración. Si no tienen WABA, deben pedir a su proveedor de soluciones empresariales que lo confirme.
- Su cuenta comercial de Meta debe tener el estado verificado.
- La WABA preexistente debe tener el estado aprobada.
- La WABA existente debe tener un método de pago válido asociado (en Configuración de pago).
- Es necesario que el número de teléfono del negocio tenga desactivada la verificación en dos pasos. Los clientes que poseen una WABA pueden usar el administrador de WhatsApp para desactivar la verificación en dos pasos en relación con su número. De lo contrario, deben pedir a su proveedor de soluciones que la desactive para ellos.
Proveedores de soluciones
Es necesario que al menos una app esté suscripta a webhooks en el destino de la WABA (ver Webhooks). Debes usar la versión 2 del registro insertado con el registro de sesión habilitado.
Pasos para realizar la migración
Paso 1: Indica al cliente que desactive la verificación en dos pasos
Si aún no lo hiciste, indica a tu cliente que use el administrador de WhatsApp para desactivar la verificación en dos pasos de su número de teléfono del negocio (o pedir al proveedor actual de soluciones que lo desactive por él).
No puedes completar los pasos restantes hasta que la verificación en dos pasos esté desactivada.
Paso 2: Registro insertado en superficie
Indica al cliente que acceda al registro insertado (versión 2) y que proporcione su número de teléfono del negocio y el nombre para mostrar cuando se los solicite durante el proceso.
Paso 3: Captura los identificadores de recursos
Cuando el cliente complete el proceso, captura el número de teléfono del negocio y la nueva WABA que se devuelve en el evento del mensaje.
Paso 4: Comparte tu línea de crédito
Comparte tu línea de crédito con la WABA como lo harías normalmente después de registrar un cliente mediante el registro insertado.
Paso 5: Suscríbete a webhooks
Suscribe tu app a los webhooks en la nueva WABA del cliente.
Paso 6: Registra el número de teléfono de la API de la nube
Registra el número de teléfono del negocio para usarlo con la API de la nube (no puedes registrar un número de teléfono del negocio migrado para usarlo con la API de instalaciones locales).
Solución de problemas
Si se produce un error durante el proceso de migración de plantillas, consulta la siguiente documentación para obtener instrucciones sobre cómo activar manualmente la migración de plantillas: Migración de plantillas.