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

Las plantillas se duplican automáticamente en el destino de la WABA, y reciben las mismas calificaciones y estados de calidad que sus homólogos fuente.

Solo las plantillas con un status de GREEN y un APPROVEDquality_score cumplen con los requisitos de duplicación. Si la WABA de destino no puede incluir todas las plantillas nuevas, duplicaremos la mayor cantidad posible hasta que se alcance el límite de plantillas. Las plantillas no duplicadas deben volver a crearse y enviarse para su aprobación si se van a utilizar en la WABA de destino.

Facturación

Los mensajes enviados antes de completarse la migración se cobran al antiguo socio de soluciones. Los mensajes no entregados enviados antes de que la migración se complete se cobran al antiguo socio de soluciones si se entregan después de que la emigración se haya completado.

Los mensajes enviados después de completarse la migración se cobran al nuevo socio de soluciones.

Tiempo de inactividad

El tiempo de inactividad no comienza hasta que se realice el paso final (registro). Hasta entonces, el número de teléfono del negocio puede utilizarse para enviar y recibir mensajes sin interrupción.

Una vez que realizas el paso final del registro, comienza el tiempo de inactividad y dura hasta que completemos la duplicación de las plantillas.

Una vez completado dicho paso, el número de teléfono del negocio puede utilizarse una vez más para enviar y recibir mensajes, que se asociarán con la nueva WABA del cliente.

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_status debe ser APPROVED).
• Los números de teléfono del negocio no pueden tener asociadas solicitudes pendientes de cambio del nombre para mostrar.

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

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