Migrar números de teléfono entre cuentas de WhatsApp Business mediante el registro insertado
En este documento se describe cómo usar el registro insertado para migrar números de teléfono de empresa de una cuenta de WhatsApp Business (WABA) a otra.
Los clientes pueden migrar sus números de teléfono de empresa entre cuentas de WhatsApp Business (WABA) y conservar sus nombres para mostrar, calificaciones de calidad, límites de mensajes de plantilla, estados de sus cuentas empresariales oficiales y plantillas de alta calidad aprobadas. Normalmente, la migración solo se realiza cuando el cliente quiere trasladar su número de teléfono de empresa de un socio de soluciones a otro.
Hay dos opciones para hacer la migración en nombre del cliente: mediante el registro insertado o mediante programación.
Hacer la migración mediante el registro insertado es la solución más sencilla, además de la preferida, ya que puede iniciarla el cliente, genera los activos necesarios y otorga la propiedad de los mismos automáticamente, concede a la aplicación acceso a dichos activos y requiere menos llamadas a la API.
La migración mediante programación debes iniciarla tú y requiere más llamadas a la API, ya que debes verificar que los activos dependientes están configurados correctamente, generar los nuevos activos que sean necesarios y asociarlos a otros activos. Por esta razón, la migración mediante programación solo se recomienda si trabajas en nombre del cliente; es decir, si vas a crear y ser el propietario de la cuenta WABA de destino y de sus activos, y vas a compartirlos con el cliente.
Si quieres migrar números de teléfono de cliente mediante programación, consulta la documentación Migrar números de teléfono entre cuentas de WhatsApp Business mediante programación.
Funcionamiento
Los clientes pueden usar tu implementación del registro insertado (versión 2) para iniciar el proceso de migración. El registro insertado les solicitará el número de teléfono de empresa y una cuenta de WhatsApp Business (WABA) de destino nueva.
Una vez que el cliente haya completado el proceso, el registro insertado genera su nueva cuenta WABA, la asocia a su porfolio empresarial de Meta, concede a tu aplicación acceso a la cuenta WABA y devuelve el identificador de la cuenta WABA recién creada y el identificador del número de teléfono de empresa.
Deberás tomar nota de 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 nube. Una vez que hayas completado el último paso (registro), el número de teléfono de empresa se vuelve a asociar con la cuenta WABA de destino y puede volver a usarse para intercambiar mensajes.
Como el número de teléfono de empresa del cliente no cambia, se conservan el nombre para mostrar, la calificación de calidad, el límite de mensajes y el estado de cuenta empresarial oficial.
Además, todas las plantillas que cumplan los requisitos se duplican automáticamente en la cuenta WABA de destino y se les concede el mismo estado que a las originales. Asimismo, el contenido multimedia subido en el número de teléfono de empresa del cliente se puede seguir usando.
Cuentas de WhatsApp Business
El registro insertado genera automáticamente la nueva cuenta WABA del cliente, la asocia a su cuenta empresarial de Meta y concede a tu aplicación acceso a dicha cuenta.
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 las plantillas
El registro del número de teléfono de la empresa es instantáneo, por lo que puedes seguir enviando y recibiendo mensajes sin interrupciones.
Sin embargo, la duplicación de las plantillas lleva cierto tiempo y no podrás usar las plantillas afectadas hasta que se hayan migrado.
Para evitar este tiempo de inactividad, puedes comenzar con la migración de las plantillas antes de registrar el número de teléfono.
Límites de frecuencia
El duplicado de plantillas que se activa automáticamente como parte del proceso de migración no se tiene en cuenta para el límite de frecuencia. En cambio, las llamadas de API que realices sí se tienen en cuenta para el límite.
Limitaciones
- No se pueden migrar los números de teléfono de empresa de prueba que hayan sido emitidos por WhatsApp.
- Los números de teléfono de empresa migrados solo se pueden registrar para su uso con la API de nube.
- El historial de mensajes y el contenido multimedia subido no se migrarán si la cuenta WABA de origen está en la API local.
- Los números de teléfono de empresa deben tener un nombre para mostrar aprobado (el valor de
name_statusesAPPROVED). - Los números de teléfono de empresa no pueden tener ninguna solicitud de cambio de nombre para mostrar pendiente.
- 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 mantendrá durante las primeras 24 horas, tras las cuales se generará una nueva calificación en caso de que haya datos suficientes disponibles.
Requisitos
Clientes
Debes pedirle al cliente propietario del número de teléfono de empresa que confirme que cumple los requisitos siguientes. Para ello, si el cliente es el propietario de la cuenta WABA, puede utilizar Meta Business Manager y dirigirse a Cuentas de WhatsApp > (nombre de su cuenta WABA) > Configuración. En caso de que no sea el propietario de su cuenta WABA, deberá solicitarle la confirmación a su proveedor de soluciones empresariales.
- La cuenta empresarial de Meta debe tener el estado verificado.
- La cuenta WABA existente debe tener el estado aprobado.
- La cuenta WABA existente debe tener asociado un método de pago válido (en Configuración de pagos).
- El número de teléfono de empresa debe tener desactivada la verificación en dos pasos. Los clientes que sean propietarios de su cuenta WABA pueden utilizar el Administrador de WhatsApp para desactivar la verificación en dos pasos en el número. En caso contrario, deberán pedirle a su proveedor de soluciones empresariales que la desactive.
Proveedores de soluciones
Debe haber al menos una aplicación suscrita a webhooks en la cuenta WABA de destino (consulta Webhooks) y debes utilizar la versión 2 del registro insertado con el registro de sesiones activado.
Pasos de la migración
Paso 1: Solicitar al cliente que desactive la verificación en dos pasos
Si aún no lo has hecho, solicita al cliente que utilice el Administrador de WhatsApp para desactivar la verificación en dos pasos en sus números de teléfono de empresa (o que le pida a su proveedor de soluciones actual que la desactive).
No se pueden completar los pasos restantes hasta que la verificación en dos pasos esté desactivada.
Paso 2: Mostrar el registro insertado
Solicita al cliente que acceda a tu implementación del registro insertado (versión 2) y que proporcione su número de teléfono de empresa y nombre para mostrar cuando se le pidan durante el proceso.
Paso 3: Capturar los identificadores de los activos
Una vez que el cliente haya completado el proceso, captura el identificador del número de teléfono de empresa y la nueva cuenta WABA devueltos en el evento de mensaje.
Paso 4: Compartir la línea de crédito
Comparte tu línea de crédito con la cuenta WABA como lo harías normalmente tras incorporar un cliente mediante el registro insertado.
Paso 5: Suscribir la aplicación a webhooks
Suscribe la aplicación a webhooks en la nueva cuenta WABA del cliente.
Paso 6: Registrar el número de teléfono para la API de nube
Registra el número de teléfono de empresa para usarlo con la API de nube (no puedes registrar un número de teléfono de empresa migrado para su uso con la API local).
Solución de problemas
Si se produce un error en el proceso de migración de la plantilla, consulta la siguiente documentación para obtener instrucciones sobre cómo activar la migración de una plantilla manualmente: Migración de plantillas.