Tabla de contenido
- Beneficios de Migrating a la API de WhatsApp Cloud
- ¿Qué será Migratado?
- Requisitos de pre--Migración: Qué se prepara para la configuración de tu Migración
- API Documentation for the Migration Process
Migración del número de teléfono a la API de WhatsApp Cloud
Actualizado
por Joshua Lim
- Beneficios de Migrating a la API de WhatsApp Cloud
- ¿Qué será Migratado?
- Requisitos de pre--Migración: Qué se prepara para la configuración de tu Migración
- API Documentation for the Migration Process
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 auto-servicio 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.
¿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
-Fuente WABA: El BSP de WhatsApp desde el cual estamos migrando.
-WABA destino: La API de WhatsApp Cloud a la que estamos migrando.
Lista de Requisitos de Pre-Migración:
- Aplicación de Meta Desarrollador existente: Si no tienes una aplicación de desarrollo creada, haz clic aquí para crear tu aplicación en Meta Business Manager (MBM) y empieza con WhatsApp Cloud API. Esta aplicación debe ser creada bajo la misma cuenta de negocio (ID de negocio) que la WABA de origen.
- ID de negocio: El código fuente y destino WABAs debe estar asociado con el mismo MBM o tener el mismo ID de negocio.
- Verificación de negocios: El ID de negocio tiene que ser verificado. Si su negocio aún no está verificado, siga estos pasos para verificarlo.
- 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 estar 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 está migrando.
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:
- Agregue un nuevo número al destino WABA: Esto generará un nuevo ID de 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.
- Eliminar el nuevo número del destino WABA: Esto desaparecerá un lugar para que un número se agregue al destino WABA. Alternativamente, si tiene un número no utilizado existente, puede eliminar ese número.
API Documentation for the Migration Process
Paso 1: Migración de números de teléfono
Callback URL:
POST <https://graph.facebook.com/{version}/{wabaId}/phone_numbers>
Name | In | Required | Type | Description |
version | path | True | string | The API version. |
wabaId | path | True | string | The WhatsApp Cloud API WABA ID. |
Parameters
Header
Authorization: Bearer {Access Token}
Body
Name | Type | Description |
| num | Numerical country code for the phone number being registered. note: Plus (+) sign is not needed for country code. |
| num | Phone number being migrated, without the country code or plus symbol (+). |
| boolean | Set to true to migrate phone number. |
Status
Name | Description |
200 OK | Success. |
Response
{
"id": "phoneNumberId"
}
Step 2: Request for Code (PIN) to Verify Phone Ownership
Callback URL
Name
In
Required
Type
Description
version
path
True
string
The API version.
phoneNumberId
path
True
string
This is the response returned in Step 1. Copy and Paste the number into the callback URL in this step.
Parameters
Header
Authorization: Bearer {Access Token}
Body
Name | Type | Descripción |
| enum | Método de recepción del código de registro. Valores soportados: SMS y voz. |
| 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
{
"éxito": true
}
Paso 3: Verifique el código
Callback URL
POST: <https://graph.facebook.com/{version}/{phoneNumberId}/verify_code>
Parámetros
Cabecera
Autorización: portador {Access Token}
Cuerpo
Nombre | Tipo | Descripción |
| 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
{
"éxito": true
}
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 |
| enum | Servicio de mensajería utilizado. En este caso, use "whatsapp". |
| num | Código de registro de 6 dígitos recibido después del paso 2. |
Estado
Nombre | Descripción |
200 OK | Éxito. |
Respuesta
{
"éxito": true
}
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.
