Cómo liberar un número que ya está en WhatsApp para usarlo en la API

Actualizado el 25/10/2026

Para usar en la API oficial de WhatsApp un número que ya está en WhatsApp, hay dos caminos: eliminar la cuenta del número en la aplicación y después registrarlo en la Cloud API o, si el número está en la app WhatsApp Business, conectarlo por coexistencia y seguir usando la app. Eliminar la cuenta es definitivo para esa cuenta de la app y, sin respaldo, el historial de chats se pierde. La coexistencia mantiene la app y sincroniza los mensajes.

Esta guía muestra los dos caminos, qué pasa con los chats, los grupos y el PIN, y un checklist para que la migración no se trabe a la mitad.

Por qué hay que «liberar» el número

Un mismo número no puede estar registrado al mismo tiempo en el WhatsApp común (Messenger) y en la Cloud API. La documentación de números de teléfono de Meta es clara: los números que ya están en uso en WhatsApp no se pueden registrar si antes no se eliminan. Y un número registrado en la Cloud API no puede usarse en WhatsApp Messenger.

La excepción es la app WhatsApp Business. La página de Meta sobre migración de un número existente indica que, para números de la app Business, puedes eliminar la cuenta o usar un proveedor que ofrezca la conexión de números de la app Business, que es la coexistencia.

Dónde está hoy el número	Camino posible
WhatsApp común (Messenger)	Eliminar la cuenta en la app y registrar en la API
App WhatsApp Business	Eliminar y registrar, o conectar por coexistencia
API con otro proveedor	Compartir la cuenta de WhatsApp con el nuevo proveedor, sin eliminar nada ni migrar el número. Consulta cómo cambiar de proveedor
Número bloqueado (baneado) en WhatsApp	Apelar antes. Meta exige que se levante el bloqueo para registrar

Camino 1: eliminar la cuenta de la app y registrar en la API

Es el camino cuando el número está en el WhatsApp común o cuando ya no quieres usar la app Business en ese número.

Antes de eliminar

1. Respalda los chats que necesitas conservar. Meta lo recomienda en la página de migración. Sin un proveedor que importe el historial, los mensajes antiguos no pasan a la API.
2. Avisa a los grupos importantes. Al eliminar la cuenta, el número sale de todos los grupos, según el Centro de ayuda de WhatsApp.
3. Lleva a tu CRM los contactos y la información que hoy solo están en la app.
4. Ten acceso al chip o a la línea. Después de eliminar, tendrás que recibir de nuevo el código de verificación por SMS o llamada.
5. Define el nombre visible que usarás en la API. Meta lo revisa. Consulta nombre visible en la API de WhatsApp.

Eliminar la cuenta

En la aplicación, ve a Ajustes > Cuenta y elige la opción de eliminar la cuenta. El Centro de ayuda de WhatsApp indica que la eliminación no se puede deshacer, que borra el historial de mensajes y que quita el número de todos los grupos.

Después, la documentación de Meta dice que puede tardar hasta 3 minutos en que el número desconectado quede disponible. Los mensajes enviados a ese número en ese intervalo quedan en cola.

Registrar en la Cloud API

Con el número liberado, el proceso es el de cualquier número nuevo:

1. Agregar el número a la cuenta de WhatsApp Business (con el registro integrado del proveedor o en el WhatsApp Manager).
2. Pedir el código de verificación por SMS o llamada y confirmarlo.
3. Registrar el número en la Cloud API con un PIN de 6 dígitos.
4. Comprobar que el estado sea CONNECTED.

En la Graph API, el registro es esta llamada:

curl -X POST "https://graph.facebook.com/v26.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "messaging_product": "whatsapp", "pin": "482916" }'

Si el número es fijo o una línea gratuita, la verificación es por llamada, con cuidados extra por el IVR. Consulta número fijo o línea gratuita en la API.

¿Puedo volver a la app después?

Sí, pero no al mismo tiempo. Según Meta, sin un proveedor de coexistencia no puedes volver a usar el número en la app WhatsApp Business, a menos que canceles su registro en la Cloud API (deregister). Cancelar el registro saca el número de la API. En la Graph API, es un POST /PHONE_NUMBER_ID/deregister. Esto no borra el número de la cuenta ni su historial; para volver a usar la API, hay que registrarlo de nuevo.

Camino 2: coexistencia (sin eliminar la cuenta)

Si el número está en la app WhatsApp Business, la coexistencia conecta ese mismo número a la Cloud API sin eliminar la cuenta. Según la documentación de onboarding de usuarios de la app Business:

• la app debe estar en la versión 2.24.17 o superior;
• la empresa sigue conversando uno a uno en la app, y los mensajes se sincronizan con la API;
• el historial de los últimos 180 días puede sincronizarse (sin los grupos), con autorización de la empresa, y la sincronización debe iniciarse dentro de las 24 horas posteriores al onboarding;
• los dispositivos vinculados (companion) se desvinculan en el onboarding y pueden volver a vincularse después, salvo WhatsApp para Windows y WearOS;
• las listas de difusión se desactivan y las existentes quedan en solo lectura;
• el rendimiento del número queda fijo en 20 mensajes por segundo.

Criterio	Eliminar y registrar	Coexistencia
Sigues usando la app	No	Sí
Historial de chats	Se pierde en la app, sin importación	Hasta 180 días sincronizados
Grupos	El número sale de los grupos	Los grupos siguen en la app, pero no llegan a la API
Rendimiento	Estándar de la Cloud API	Fijo en 20 mensajes por segundo
Ideal para	Operación 100 % desde sistema	Quien quiere conservar el celular y automatizar una parte

Para ver en detalle qué pasa y qué no pasa entre la app y la API, consulta coexistencia: qué se sincroniza.

¿Y la verificación en dos pasos?

Hay dos PIN distintos, y suelen confundirse:

• PIN de la aplicación. Es la verificación en dos pasos que el usuario activa en la app. Cuando eliminas la cuenta, se va con ella.
• PIN de la Cloud API. Es el PIN de 6 dígitos que defines en register. Meta lo exige para registrar el número y, después, para cambiarlo o eliminar el número. No hay endpoint para desactivarlo. Si lo olvidas, puedes cambiarlo en el WhatsApp Manager, en Configuración del número > Verificación en dos pasos.

Meta está retirando de forma gradual el PIN de 6 dígitos para los números elegibles de la Cloud API. Cuando el número es elegible, la pestaña de verificación en dos pasos desaparece del WhatsApp Manager. Mientras siga ahí, guarda el PIN en el gestor de contraseñas de la empresa, no en la memoria de quien hizo el registro.

Errores comunes en la migración

• Intentar registrar antes de eliminar la cuenta. El registro falla porque el número sigue en uso en WhatsApp.
• Eliminar la cuenta sin respaldo y descubrir después que el historial hacía falta para la atención.
• Eliminar la cuenta de un número de la app Business cuando la coexistencia lo resolvía.
• Perder el PIN definido por una agencia o por un empleado que ya no está.
• Reintentar el registro demasiadas veces. Meta acepta 10 solicitudes de registro por número en 72 horas. Si te pasas, recibes el error 133016 y el registro queda bloqueado las 72 horas siguientes.
• Olvidar el límite de números del portafolio. Un portafolio nuevo registra hasta 2 números, y el límite sube a 20 con la verificación de la empresa o al alcanzar el límite de 2.000 mensajes.

Los mensajes de error de la Graph API durante el registro están en errores de la API de WhatsApp.

Cómo hacerlo con Vectalk

Vectalk ofrece los dos caminos. Con coexistencia, el número sigue en la app WhatsApp Business y también funciona en la API. Si prefieres registrar el número solo en la API, la API de Vectalk tiene los mismos pasos que Meta: POST /phone-numbers/request-code, POST /phone-numbers/verify-code, POST /phone-numbers/register con el PIN y POST /phone-numbers/deregister para cancelar el registro. Consulta la documentación y crea tu cuenta.

Preguntas frecuentes

¿Desinstalar WhatsApp libera el número?

No cuentes con eso. La documentación de Meta pide eliminar la cuenta desde la propia aplicación (Ajustes > Cuenta), no solo quitar la app del celular.

¿Cuánto tiempo después de eliminar la cuenta puedo registrar en la API?

Meta indica que puede tardar hasta 3 minutos en que el número desconectado quede disponible.

¿Pierdo mis chats al migrar?

Si eliminas la cuenta, sí, en la app. Haz un respaldo antes. Con coexistencia, el historial de los últimos 180 días puede sincronizarse con la API, salvo los grupos.

¿Puedo usar el mismo número en el WhatsApp común y en la API?

No. Un número registrado en la Cloud API no puede usarse en WhatsApp Messenger. Usar la app junto con la API solo es posible con WhatsApp Business, por coexistencia.

Mi número está bloqueado. ¿Puedo registrarlo en la API?

No directamente. Meta exige que se levante el bloqueo mediante el proceso de apelación antes del registro.

---

Fuentes oficiales consultadas el 25/10/2026: Migrar un número de WhatsApp existente a una cuenta empresarial, Números de teléfono de la Cloud API, Verificación en dos pasos, Registro y cancelación de registro, Onboarding de usuarios de la app WhatsApp Business (coexistencia), Centro de ayuda de WhatsApp: cómo eliminar tu cuenta, Documentación de la API de Vectalk.