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 cuenta 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

Las plantillas se duplican automáticamente en la cuenta WABA de destino y se les concede la misma calificación de calidad y el mismo estado que a las originales.

Solo cumplen los requisitos para el duplicado las plantillas cuyo valor de status sea APPROVED y cuyo valor de quality_score sea GREEN. Si la cuenta WABA de destino no puede acoger todas las plantillas nuevas, duplicaremos tantas plantillas como podamos hasta alcanzar su límite de plantillas. Las plantillas que no se hayan duplicado se deben volver a crear y enviar para su aprobación si se van a usar en la cuenta WABA de destino.

Facturación

Los mensajes enviados antes de completar la migración se cobrarán al socio de soluciones antiguo. Los mensajes no entregados que se hayan enviado antes de completar la migración se cobrarán al socio de soluciones antiguo si se entregan después de completar la migración.

Los mensajes enviados tras haberse completado la migración se cobrarán al nuevo socio de soluciones.

Tiempo de inactividad

El tiempo de inactividad no comienza hasta que no se realice el último paso (registro). Hasta entonces, el número de teléfono de empresa puede usarse para intercambiar mensajes de forma ininterrumpida.

Al realizar el registro, que es el paso final, comienza el tiempo de inactividad hasta completarse el duplicado de plantillas.

Una vez que se haya completado, el número de teléfono de empresa puede volver a usarse para intercambiar mensajes, que se asociarán a la nueva cuenta WABA del cliente.

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_status es APPROVED).
• Los números de teléfono de empresa no pueden tener ninguna solicitud de cambio de nombre para mostrar pendiente.

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 la carga útil.

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).