Migración del número de teléfono a la API de WhatsApp Cloud

Beneficios de migrar a la API de WhatsApp Cloud

WhatsApp Cloud API es una nueva plataforma que ofrece a las empresas una conexión directa con la infraestructura de WhatsApp y es una opción de autoservicio en comparación con pasar por los socios de WhatsApp (BSPs). Algunos beneficios de utilizar WhatsApp Cloud API son:

• una opción más rentable.

• una conexión más confiable y estable a la plataforma.

• la capacidad de crear integraciones personalizadas que se ajusten a las necesidades específicas de su negocio.

• Una solución flexible y escalable para empresas de todos los tamaños.

Obtenga más información sobre WhatsApp Cloud API aquí.

¿Qué se migrará?

Tenga en cuenta que los siguientes elementos se pueden migrar desde WhatsApp BSP a la API de WhatsApp Cloud.

Se puede migrar

• Número de teléfono asociado a la cuenta.

• Cualquier plantilla de mensaje de alta calidad previamente aprobada.

• Nombre para mostrar del número de teléfono.

• Calificación de calidad del número de teléfono.

• Límites de mensajería.

• Estatus oficial de WABA.

No se puede migrar

• Plantillas de mensajes de baja calidad, rechazadas o pendientes.

Requisitos previos a la migración: Qué preparar para la configuración de la migración

Tome nota de las frases que se utilizarán con frecuencia a lo largo de este documento:
-Fuente WABA: El BSP de WhatsApp desde el que estamos migrando.
-Destino WABA: La API de WhatsApp Cloud a la que estamos migrando.

Lista de verificación de requisitos previos a la migración:

• Aplicación de desarrollador Meta existente: Si no tiene una aplicación de desarrollador creada, haga clic aquí para crear su aplicación en Meta Business Manager (MBM) y comenzar a utilizar la API de WhatsApp Cloud. Esta aplicación debe crearse bajo la misma cuenta comercial (ID comercial) que la fuente WABA.

• ID de empresa: Las WABA de origen y destino deben estar asociadas con el mismo MBM o tener el mismo ID de empresa.

• Verificación empresarial: Se debe verificar el ID empresarial. Si su empresa aún no está verificada, siga estos pasos para verificarla.

• Estado de revisión de WABA: El estado de revisión de los WABA de origen y destino debe ser aprobado.

• Pago Método: Se debe configurar un método de pago tanto para el WABA de origen como para el de destino. Asegúrese de que el método de pago esté configurado tanto en el origen como en el destino.

• Verificación en dos pasos: La verificación en dos pasos debe estar deshabilitada en el número de teléfono que se va a migrar.

Una vez comprobado y completado todo lo anterior, el proceso de migración puede continuar.

Configuración de números de teléfono e ID de WABA

Meta ha diseñado los ID de WABA para que no se puedan migrar. Debido a ciertas limitaciones, se ha implementado una solución alternativa. Para que se produzca la migración de números telefónicos, los ID de WABA de origen y destino deben estar en la misma cuenta de administrador comercial de Meta. Esto significa que migrar un número de teléfono solo resultará en la transferencia de ese número entre WABA y no permitirá ningún otro cambio. Para migrar con éxito un número de teléfono se deben realizar los siguientes pasos:

• Agregar un nuevo número al WABA de destino: Esto generará una nueva ID WABA para el número al que desea migrar. Puede omitir este paso si tiene un WABA existente con un número que ya no se utiliza.

Aprende más sobre conectar números de teléfono a WhatsApp Cloud API aquí.

• Eliminar el nuevo número del WABA de destino: Esto liberará un lugar para que se agregue un número al WABA de destino. Alternativamente, si tiene un número existente sin uso, puede eliminar ese número.

Una vez eliminado el número, procede a migrar el número actual del cliente'al nuevo WhatsApp Business.

Documentación de API para el proceso de migración

Es importante tener en cuenta que, actualmente, estos pasos de migración descritos en la documentación de la API solo pueden ser ejecutados por un desarrollador o alguien con conocimientos técnicos similares. Sin embargo, entendemos que esto puede ser una limitación para algunos y estamos trabajando para desarrollar una solución más fácil de usar y accesible en el futuro. ¿Necesitar ayuda? Contáctanosaquí!

Paso 1: Iniciar la migración del número de teléfono

URL de devolución de llamada:

PUBLICACIÓN <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>

Vaya a Administrador comercial > Configuración comercial > Cuentas > Cuentas comerciales de WhatsApp para encontrar el ID de una cuenta comercial de WhatsApp. Seleccione la cuenta que desea utilizar. Aparecerá un panel con información de la cuenta, incluido el ID.

Parámetros

Encabezamiento

Autorización: Portador {Access Token}

El usuario del Sistema genera su Token de Acceso en la pestaña Cuentas de WhatsApp Business del Administrador Comercial. Lea esta guía para aprender cómo acceder al usuario del sistema y crear o copiar uno.

Cuerpo

Estado

Respuesta

{  
    "id": "phoneNumberId"  
}

Paso 2: Solicitud de código (PIN) para verificar la propiedad del teléfono

URL de devolución de llamada

PUBLICACIÓN <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>

Parámetros

Encabezamiento

Autorización: Portador {Access Token}

Cuerpo

Estado

Respuesta

{  
    "éxito": verdadero  
}

El código se ha enviado al número de teléfono que se está migrando a través del método seleccionado (SMS o Voz).

Paso 3: Verificar el código

URL de devolución de llamada

PUBLICACIÓN: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>

El código (PIN de 6 dígitos) recibido en el número de teléfono del paso 2 se utilizará para verificar la propiedad.

Parámetros

Encabezamiento

Autorización: Portador {Access Token}

Cuerpo

Estado

Respuesta

{  
    "éxito": verdadero  
}

Confirma que la propiedad del teléfono está verificada.

Paso 4: Registrar el número de teléfono

URL de devolución de llamada

PUBLICACIÓN <https://graph.facebook.com/{version}/{phoneNumberId}/register>

Parámetros

Encabezamiento

Autorización: Portador {Access Token}

Cuerpo

Estado

Respuesta

{  
    "éxito": verdadero  
}

El número de teléfono se registró correctamente en la API WABA de WhatsApp Cloud. Ahora puedes enviar mensajes a tu destino WABA.

El ID de WABA no se migra. El número recién migrado se asociará con el ID WABA del número eliminado anteriormente.

Paso 5: Verifique el número de teléfono migrado en la aplicación Meta Developer

Una migración exitosa se puede verificar a través de la aplicación Meta Developer. Para ello, siga estos pasos:

1. Navegar a WhatsApp > Primeros pasos

2. En la lista desplegable de números de teléfono, confirme que el número esté presente y reflejado con precisión.