WisChat · Migrar números entre cuentas (WABA)

¿Qué camino usar?

Tres escenarios; el tuyo es el primero.

Escenario	Cuándo	Mecanismo
Migrar número entre WABAs	Lo activaste a tu nombre y lo traspasas a la WABA del cliente	“Migrate number between WABAs” (tu caso)
OBO directo (Embedded Signup)	El cliente ya está listo ahora y no necesitas precalentar	Creas la WABA directamente en su Business; sin migración
Migrar WABA entre BSPs	El cliente ya tiene número con otro proveedor	Migration intent + el cliente acepta en Meta Business Suite

✅ Como tu cliente ya tiene el Meta Business verificado, el destino cumple para conservar green tick / cuenta oficial. Este es exactamente el flujo que respalda tu propuesta de “calienta y entrega listo”.

Requisitos antes de migrar

Desactiva la verificación en dos pasos (2FA) del número en la WABA origen (obligatorio para migrar).
Acceso al número físico para recibir el código OTP (SMS o llamada) al registrarlo en la WABA destino.
Display name aprobado (se conserva; si el cliente quiere su marca, se re-aprueba después).
Método de pago / línea de crédito configurado en la WABA destino (la facturación pasa al cliente).
El número no debe ser COEX (coexistencia app+API): esos no se pueden migrar entre WABAs.

Camino A — Por interfaz (recomendado)

El más simple y el que Meta expone en el WABA Management App / Embedded Signup.

En tu portafolio, abre el WABA Management App del número y desactiva el 2FA.
Activa “Migrate Number” → elige “Migrate number between WABAs”.
Inicia sesión en el portafolio destino (el Meta Business verificado del cliente) y crea/selecciona la WABA destino.
Completa los campos requeridos y finaliza con el flujo de Embedded Signup.
Recibe el código OTP en el número y verifica. El número queda registrado en la WABA del cliente.

Camino B — Por API (Graph)

Si automatizas el traspaso. Todo sobre graph.facebook.com con tu token de sistema.

1) Da de alta el número en la WABA destino (marcándolo como migración)

POST /{DEST_WABA_ID}/phone_numbers
{
  "cc": "593",
  "phone_number": "999999999",
  "verified_name": "Nombre del cliente",
  "migrate_phone_number": true
}

2) Solicita el código de verificación

POST /{PHONE_NUMBER_ID}/request_code
{ "code_method": "SMS", "language": "es" }

3) Verifica el código recibido

POST /{PHONE_NUMBER_ID}/verify_code
{ "code": "123456" }

4) Registra el número en Cloud API

POST /{PHONE_NUMBER_ID}/register
{ "messaging_product": "whatsapp", "pin": "XXXXXX" }

pin = el PIN de 6 dígitos de verificación en dos pasos (el existente o uno nuevo que defines aquí).

⚠️ Límite real: el endpoint /register admite 10 solicitudes por número cada 72 h (ventana móvil). Al excederlo devuelve el error 133016 y bloquea el registro 72 h. No es un “cooldown de 1–2 meses” (eso aplica solo a Coexistence, no a migrar entre WABAs).

Qué se conserva y qué cambia

Se conserva	Cambia / a tener en cuenta
Display name aprobado	Historial de chats no viaja
Quality rating y messaging limits (tier)	Facturación: antes de completar la migración se cobra a tu cuenta; después, a la del cliente
Official Business Account / green tick	Plantillas: se duplican en la WABA destino y se re-verifica su categoría; las de calidad `UNKNOWN` re-califican tras ~24 h

El punto operativo clave: ¿quién guarda el SIM?

Un número de WhatsApp es una línea telefónica real. “Vender el número” traspasa la cuenta de WhatsApp, no la línea:

📱 Si tú conservas el SIM, el cliente depende de ti para cada re-verificación futura (siempre pide OTP). Si el cliente debe ser autónomo, entrégale la línea (o su DID portado) al momento del traspaso.

Checklist de entrega a un cliente

El cliente confirmó su Meta Business verificado y creó (o autorizó crear) su WABA.
Desactivaste 2FA en origen y tienes el número para recibir OTP.
Configuraste el método de pago del cliente en la WABA destino.
Migraste (Camino A o B) y verificaste el OTP.
Confirmaste que display name, calidad y límites siguen en la WABA destino.
Reconectaste la línea en WisChat (misma línea/número, ahora en la WABA del cliente).
Definiste quién conserva el SIM/DID.

Pre-activar números a tu nombre y traspasarlos al cliente