Tabla de contenido

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

Joshua Lim Actualizado por Joshua Lim

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.
Obtenga más información sobre la 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:
-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.
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:

  • 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.
Una vez que el número sea eliminado, proceda a migrar el número actual del 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áctenosaquí!

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.

Go to Business Manager > Business Settings > Accounts > WhatsApp Business Accounts to find the ID of a WhatsApp Business Account. Select the account you want to use. A panel with account information, including the ID will appear.
Parameters

Header

Authorization: Bearer {Access Token}

The System user generates your Access Token in the WhatsApp Business Accounts tab of the Business Manager. Read this guide to learn how to access the system user and create or copy one.

Body

Name

Type

Description

cc

num

Numerical country code for the phone number being registered.

note: Plus (+) sign is not needed for country code.

phone_number

num

Phone number being migrated, without the country code or plus symbol (+).

migrate_phone_number

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

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

{
"éxito": 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

{
"éxito": 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

{
"éxito": 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:

  1. Vaya a WhatsApp > Iniciando
  2. En la lista desplegable de números de teléfono, confirme que el número está presente y reflejado con precisión.
¿Tiene problemas con el canal? ¡Contáctenosaquí!

¿ES ÚTIL ESTE ARTÍCULO?

¡Nos encanta saber de ti!

Plantillas de mensajes de WhatsApp

¿No encuentras lo que buscas?

¡Habla con una experta aquí!

Contacta con nosotras
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)