Registrar número en WhatsApp Cloud API: guía práctica 2026

Si tenés verificación de negocio en Meta pero no podés registrar tu número en WhatsApp Cloud API, el problema casi nunca es la verificación en sí — es que el número está activo en otra cuenta WhatsApp (personal o Business), está bloqueado por intentos fallidos, o sigue vinculado a un proveedor anterior. Meta requiere pasos adicionales que van más allá de la verificación: desvinculación del dispositivo, validación de código SMS, y creación de System User para tokens permanentes. Resolverlo toma entre 24 horas y varios días según el motivo específico.

En 30 segundos

La verificación de negocio de Meta no es suficiente — el número debe estar desvinculado de cualquier cuenta WhatsApp preexistente
Las causas principales son: número activo en otra cuenta, código SMS bloqueado por Meta, o número registrado en un proveedor anterior (CRM, chatbot, BSP)
Los tokens tienen tres tipos: temporales (24h), larga duración (60 días), y permanentes (System User, nunca expiran) — la mayoría falla usando tokens temporales
Si Meta rechaza verificación o bloquea el número, necesitás esperar 24-48 horas antes de reintentar, y posiblemente contactar soporte con documentación
La solución definitiva es crear un System User en Business Manager, asignar permisos de WhatsApp API, y generar el token desde ahí

¿Qué es WhatsApp Cloud API y por qué falla el registro?

WhatsApp Cloud API es la plataforma de Meta que permite a empresas enviar y recibir mensajes programáticamente sin instalar la app de WhatsApp Business en un teléfono físico. A diferencia de la app de escritorio o la de celular, la Cloud API funciona con números de teléfono registrados en Meta, tokens de autenticación, y webhooks.

El drama arranca cuando creés que con tener Business verified vas a poder registrar cualquier número. Spoiler: no funciona así (si es que eso cuenta como sorpresa). Meta pide que el número cumpla condiciones adicionales: no estar activo en WhatsApp personal, no estar vinculado a otra WABA (WhatsApp Business Account), pasar validación de código SMS o llamada automática, y estar libre de bloqueos de seguridad por intentos fallidos previos.

Muchos equipos se atascan acá porque asumen que completar la verificación de negocio + cargar documentos legales = permiso para registrar el número. La verdad es que esos pasos son requisitos previos, no lo mismo que autorizar el número. Meta te deja crear la WABA, pero cuando intentás registrar el número específico, rechaza con errores tipo “This phone number is not eligible” o “Phone number has verification issues.”

Causa #1: El número está vinculado a otra cuenta de WhatsApp

Esta es la causa más común (80% de los casos que ves en foros). Si el número que querés registrar está activo en WhatsApp personal, en otra WABA de otra empresa, o en un smartphone donde metiste la app — no va a funcionar. En alternativas sin depender de APIs profundizamos sobre esto.

Meta necesita exclusividad: cada número de teléfono puede estar en una sola WABA a la vez. Si tu número está sincronizado con tu celular personal, WhatsApp Cloud API rechaza el registro.

Paso a paso para liberar el número:

En el celular donde está activo el número, desinstala WhatsApp completamente (Ajustes → Aplicaciones → WhatsApp → Desinstalar)
Espera 24 horas — Meta necesita tiempo para procesar la desvinculación
Abrí Meta Business Manager, andá a Configuración de cuenta → Números de teléfono → Verificar estado
Reintentá el registro del número en WhatsApp Cloud API

Ojo: si alguien más en tu organización tiene el número en su teléfono, necesitan desinstalarlo también. Audit de teléfonos: crítico.

Causa #2: Problemas de verificación de código SMS o llamada automática

Cuando metés el número, Meta envía un SMS con un código de 6 dígitos, o hace una llamada automática que te dicta el código. Acá es donde más cosas fallan, subís el código, Meta lo valida — o no.

Los errores típicos:

Código expirado: Tenés 10 minutos para metelo. Si pasó ese tiempo, pedí uno nuevo. El sistema te deja reintentar 5 veces antes de bloquear la cuenta por 24h
SMS bloqueado por tu operador: Algunos números o el SMS de Meta cayó en spam. Pedí que Meta te haga una llamada automática en vez de SMS (hay botón en la interfaz)
Bloqueo de seguridad temporal: Si probaste 5 veces y fallaste, Meta bloquea automáticamente. Esperá 24 horas, reiniciá desde cero
Número no elegible para verificación: Meta rechaza números VoIP, números de prueba, o números que previamente reportaron problemas de fraude

Si después de 24h reintentas y Meta sigue rechazando, contactá a Meta Business Support con prueba de que el número es tuyo (factura, captura de pantalla del número en tu teléfono, documentación corporativa). El equipo de soporte tarda 3-5 días en responder.

Causa #3: El número sigue registrado en un proveedor anterior

Esto pasa cuando migrás desde un CRM, chatbot, o proveedor de WhatsApp API anterior (tipo Twilio, MessageBird, o un BSP local). El número estuvo vinculado a la WABA del proveedor, y aunque ya no lo usas, sigue registrado ahí. Complementá con medidas de seguridad en integraciones.

Meta no te deja registrar el mismo número en dos WABAs simultáneamente. La solución es que el proveedor anterior libere el número de su WABA.

Cómo hacer que lo liberen:

Contactá al proveedor (soporte, account manager, área técnica) y pedí que desvincule el número de su WABA
Pedí que te confirmen el estado: “El número X ha sido removido de la WABA del proveedor”
Una vez que confirmen, esperá 2-4 horas (es tiempo de sincronización con Meta)
Reintentá registrar el número en tu WABA

Si el proveedor no responde o cobra por la liberación, escalá. Acordate que es tu número — aunque el proveedor lo haya registrado, vos pagaste por ese servicio, y el número es activo tuyo.

Cómo generar tokens permanentes: del token temporal al System User

Muchos devs se atascan acá también. Meta genera tres tipos de tokens, y cada uno tiene su propósito y duración.

Tipo de token	Duración	Caso de uso	Riesgo
Token temporal	24 horas	Desarrollo y testing en local	Caduca cada día, necesitás refrescarlo manualmente
Token de larga duración	60 días (aprox.)	Aplicaciones pequeñas, scripts puntuales	Sigue expirando, requiere refresh automático
System User (permanente)	Nunca expira	Producción, aplicaciones escalables, bots 24/7	Si se compromete la key, alguien tiene acceso perpetuo a tu WABA

whatsapp cloud api numero diagrama explicativo

La mayoría de equipos falla porque genera un token temporal, lo pone en producción, y se sorprende cuando caduca a las 24h. Después de eso, todos los webhooks de WhatsApp empiezan a fallar, los mensajes no se envían, y la alarma salta a las 2 de la mañana.

Cómo crear un System User (la solución definitiva):

Abrí Meta Business Manager → Usuarios → System Users → Crear
Dale un nombre descriptivo: “WhatsApp API Production” o lo que sea
En la sección de Permisos, agregá Activos y asignale la WABA de WhatsApp
Dale permisos: whatsapp_business_messaging_api, whatsapp_business_phone_number_verified_name, instagram_manage_messages
Generá las credenciales: System User generará un token permanente y un App ID
Almacená ese token en un vault seguro (1Password, AWS Secrets Manager, lo que uses)
NUNCA lo metas en un repositorio Git. Nunca. Ni siquiera en .env de desarrollo si lo commiteás

Con el System User en lugar, tu integración funciona indefinidamente sin que alguien tenga que refrescar tokens manualmente. Te puede servir nuestra cobertura de herramientas de automatización disponibles.

Verificación completa de negocio: qué chequear antes de registrar el número

Antes de intentar registrar el número, validá que todo esto esté en verde en Meta Business Manager:

Meta Business Manager verificado: Account → Settings → Business info. El estado debe ser “Verificado” (no “Pendiente”, no “Rechazado”)
Información legal completada: Nombre legal de la empresa, número de RFC o cédula, dirección física verificable, website activo que reflejen eso
Email corporativo: No Gmail personal. Meta rechaza verificaciones de empresas que usan [email protected]. Necesita ser [email protected] y que sea accesible
Documentos cargados: Dependiendo del país y tipo de empresa (LLC, SRL, etc.), necesitás facturas, acta constitutiva, o RUT/RFC. Meta lo especifica en el flujo
Datos de pago verificados: Si alguna vez pagaste algo en Meta, esa forma de pago debe estar activa y verificada

Si Meta rechaza la verificación, el rechazo viene con motivo: “Documentación insuficiente”, “Información legal no coincide”, “Sitio web no coincide con datos de empresa”. Arreglá lo específico y resubmitá (Meta te deja 3 intentos antes de bloquear por 30 días).

Errores comunes y cómo resolverlos

Error: “Auth Exception (401)”

El token expiró o es inválido. Verificá que no estés usando un token temporal que ya cumplió 24 horas. Si usás un System User, verificá que el token se copió correctamente y sin espacios al principio o final. Renová el token desde System User si es necesario.

Error: “API Method (400) — User does not have permission…”

El System User no tiene los permisos correctos asignados. Volvé a Meta Business Manager → System Users → el usuario que creaste → Permisos → Agregá “whatsapp_business_messaging_api” explícitamente y asigná la WABA. Esperá 5 minutos y reintentá el request.

Error: “invalid_token”

El token está mal formateado o es del formato viejo. Regenerá desde System User. Si el error persiste, borrá el System User y creá uno nuevo. Ya lo cubrimos antes en almacenar y gestionar credenciales.

Error: “This phone number is not eligible for registration”

El número está activo en otra WABA, bloqueado por Meta, o no pasó validación de código. Desvinculá el número de cualquier otra cuenta, esperá 24h, y reintentá. Si Meta lo bloqueó por múltiples intentos fallidos, esperá 24-48h.

Si tenés problemas con la validación de números, Business verified, but I still can’t register a phone number cubre exactamente eso.

Preguntas Frecuentes

¿Puedo registrar el mismo número en dos WABAs?

No. Meta permite un número por WABA. Si lo necesitás en otra WABA, pedile al proveedor o admin anterior que lo libere, esperá 2-4h, y recién ahí registralo en la nueva WABA.

¿Cuánto tarda Meta en liberar un número?

Entre 2 y 24 horas. Si desinstalaste WhatsApp del teléfono, esperá al menos 24h. Si pediste que un proveedor lo libere, generalmente confirman en 1-4 horas, pero la sincronización con Meta toma hasta 4h adicionales. El peor caso: si Meta bloquea el número por seguridad, esperá 24-48h.

¿Qué pasa si me equivoco al meter el código de verificación?

Meta te deja 5 intentos. Cada intento fallido suma. En el intento 6, Meta bloquea la cuenta por 24 horas. Después de eso, podés reintentar desde cero con un nuevo código.

¿El token de System User es seguro para production?

Sí, si lo almacenás correctamente: en un vault (AWS Secrets Manager, HashiCorp Vault, 1Password), no en .env ni en Git. Si alguien obtiene ese token, tiene acceso permanente a tu WABA, así que tratalo como una contraseña root. Rotá tokens cada 3-6 meses por standard de seguridad.

Conclusión

WhatsApp Cloud API no falla por falta de verificación de negocio — falla porque el número está vinculado a otra cuenta, Meta lo bloqueó por intentos fallidos, o sigue registrado en un proveedor anterior. La solución es siempre la misma: desvinculá el número de todos lados, esperá 24h, y reintentá. Para production, usá un System User con tokens permanentes, nunca tokens temporales.

Si después de 48 horas seguís sin poder registrar, es momento de contactar a Meta Business Support. Llevá documentación: prueba de que el número es tuyo, screenshot del error exacto, y timeline de qué intentaste. Tarda 3-5 días en responder, pero es el último recurso que funciona cuando nada más resuelve.

¿Qué significa ‘registra este número de teléfono con la API de registro’?

Es un error que Meta muestra cuando el número no está registrado correctamente en tu WABA. Significa que vos o tu proveedor deben completar el registro usando la API de registro de Meta. Si trabajás con un BSP o agencia, ellos deben iniciar el trámite desde su lado.

¿Cuál es la diferencia entre la API de registro y WhatsApp Cloud API?

La API de registro es el endpoint de Meta para registrar números en una WABA. Cloud API es la plataforma completa para enviar y recibir mensajes. Primero necesitás registrar el número con la API de registro, y luego podés usarlo en Cloud API.

¿Dónde encontrás la documentación oficial de WhatsApp Cloud API de Meta?

La documentación oficial está en developers.facebook.com/docs/whatsapp/cloud-api. Ahí podés encontrar todos los endpoints, ejemplos de código, y procesos de registro según tu país.