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

Beneficios de Migrating a la API de WhatsApp Cloud

La API de WhatsApp Cloud 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 los socios de WhatsApp (BSPs). Algunos beneficios del uso de la API de WhatsApp Cloud son:

una opción más rentable.
una conexión más estable y fiable a la plataforma.
la capacidad de crear integraciones personalizadas que se ajusten a sus necesidades específicas de negocio.
una solución flexible y escalable para empresas de todos los tamaños.

Más información sobre API de WhatsApp Cloud aquí.

¿Qué será Migratado?

Ten en cuenta que los siguientes elementos pueden migrarse desde el BSP de WhatsApp a la API de WhatsApp Cloud.

Se puede migrar

Número de teléfono asociado con la cuenta.
Cualquier plantilla de mensajes de alta calidad previamente aprobada.
Mostrar el nombre del número de teléfono.
Calificación de calidad del número de teléfono.
Límites de mensajería.
Estado oficial de la WABA.

No se puede migrar

Plantillas de mensajes de baja calidad, rechazadas o pendientes.

Requisitos de pre--Migración: Qué se prepara para la configuración de tu Migración

Tenga en cuenta las frases que se utilizarán frecuentemente a través de este documento:
-Source WABA: El WhatsApp BSP desde el cual estamos migrando.
-WABADestinación: La API de WhatsApp Cloud a la que estamos migrando.

Lista de Requisitos de Pre-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 ser creada bajo la misma cuenta de negocio (ID de negocio) que la WABA de origen.
Business ID: El origen y destino WABAs debe estar asociado con el mismo MBM o tener el mismo ID de negocio.
Verificación de empresas: El ID de negocio tiene que ser verificado. Si su negocio aún no está verificado, siga estos pasos para que se verifique.
Estado de revisión de WABA: El estado de revisión de la fuente y destino de WABAs debe ser aprobado.
Pago Método: Un método de pago debe ser configurado tanto para la fuente como para el destino WABA. 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.

Cuando todo lo anterior está comprobado y completado, el proceso de migración puede continuar.

Configurar números de teléfono y IDs WABA

Meta ha diseñado los IDs de WABA para que no sean migrables. Debido a ciertas limitaciones, se ha puesto en marcha una solución alternativa. Para que la migración de números de teléfono ocurra, tanto el origen como el destino de los identificadores WABA deben estar bajo la misma cuenta de gerente de negocios Meta. Esto significa que migrar un número de teléfono sólo dará lugar a la transferencia de ese número entre WABAs y no permitirá ningún otro cambio. Para migrar con éxito un número de teléfono, se deben llevar a cabo 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 saltarse este paso si tiene un WABA existente con un número que ya no se está usando.

Aprende más sobre conectar números de teléfono a la API de la nube de WhatsApp 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 no utilizado existente, puede eliminar ese número.

Una vez que el número sea eliminado, proceda a migrar el número actual de cliente's al nuevo negocio de WhatsApp.

API Documentation for the Migration Process

Es importante tomar nota de ello actualmente, estos pasos de migración descritos en la documentación de la API sólo pueden ser ejecutados por un desarrollador o alguien con un fondo técnico similar. 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. ¿Necesitas ayuda? ¡Contáctanosaquí!

Paso 1: Migración de números de teléfono

Callback URL:

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

Nombre	En	Obligatorio	Tipo	Descripción
versión	ruta	Verdadero	cadena	La versión de API.
wabaId	ruta	Verdadero	cadena	La API de WhatsApp Cloud WABA ID.

Vaya a Business Manager > Business Settings > Accounts > WhatsApp Business Accounts para encontrar el ID de una cuenta de WhatsApp Business. Seleccione la cuenta que desea usar. Aparecerá un panel con información de la cuenta, incluyendo el ID.

Parámetros

Cabecera

Autorización: portador {Access Token}

El usuario del sistema genera su token de acceso en la pestaña Cuentas de negocios de WhatsApp del Administrador de Negocios. Lee esta guía para aprender cómo acceder al usuario del sistema y crear o copiar uno.

Cuerpo

Nombre	Tipo	Descripción
cc	num	Código numérico del país para el número de teléfono registrado.note: no se necesita el signo (+) para el código del país.
teléfono_número	num	Número de teléfono migrado, sin el código del país o símbolo plus (+).
migrar_teléfono_número	boolean	Establecer en verdadero para migrar número de teléfono.

Estado

Nombre	Descripción
200 OK	Éxito.

Respuesta

{ "id": "phoneNumberId" }

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

Callback URL

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

Nombre	En	Obligatorio	Tipo	Descripción
versión	ruta	Verdadero	cadena	La versión de API.
número de teléfono Id	ruta	Verdadero	cadena	Esta es la respuesta devuelta en el paso 1. Copia y pega el número en la URL de devolución de llamada en este paso.

Parámetros

Cabecera

Autorización: portador {Access Token}

Cuerpo

Nombre	Tipo	Descripción
código_método	enum	Método de recepción del código de registro. Valores soportados: SMS y voz.
idioma	enum	Idioma en el que desea recibir el código de registro. Ver códigos de idioma.

Estado

Nombre	Descripción
200 OK	Éxito.

Respuesta

{ "success": true }

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

Paso 3: Verifique el código

Callback URL

POST: <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

Cabecera

Autorización: portador {Access Token}

Cuerpo

Nombre	Tipo	Descripción
código	num	Código de registro de 6 dígitos recibido después de completar el paso 2.

Estado

Nombre	Descripción
200 OK	Éxito.

Respuesta

{ "success": true }

Confirma que el propietario del teléfono está verificado.

Paso 4: Número de teléfono de registro

Callback URL

POST <https://graph.facebook.com/{version}/{phoneNumberId}/register>

Parámetros

Cabecera

Autorización: portador {Access Token}

Cuerpo

Nombre	Tipo	Descripción
mensaje_producto	enum	Servicio de mensajería utilizado. En este caso, use "whatsapp".
pin	num	Código de registro de 6 dígitos recibido después del paso 2.

Estado

Nombre	Descripción
200 OK	Éxito.

Respuesta

{ "success": true }

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

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

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

Una migración exitosa puede ser verificada a través de la Meta Developer App. Para hacer esto, siga estos pasos:

Vaya a WhatsApp > Iniciando
En la lista desplegable de números de teléfono, confirme que el número está presente y reflejado con precisión.