Esta guía documenta, paso a paso, el proceso real para dar de alta un número de WhatsApp en la WhatsApp Business Cloud API de Meta: desde crear la app correcta hasta obtener un token de acceso permanente y recibir mensajes de cualquier número. Está basada en una implementación real (proyecto SSTDG/Talky), incluyendo los errores con los que te vas a topar y cómo resolverlos.
Nota para usuarios de Claude Code: si vas a repetir este proceso con ayuda de un agente de IA, existe una skill de Claude llamada whatsapp-business-meta-setup que automatiza gran parte de este flujo (navegación del panel de Meta, llenado de formularios, manejo de los errores conocidos). Pídele a Claude: "usa la skill whatsapp-business-meta-setup para configurar WhatsApp Business API" y te guiará por estos mismos pasos, pidiéndote solo los datos sensibles (contraseña, códigos de verificación, aprobación de acciones de cuenta) que un agente no debe manejar por ti.
Antes de empezar: qué necesitas listo
- Un número de teléfono libre de WhatsApp activo (si tiene la app de WhatsApp personal instalada y sesión iniciada, Meta lo rechaza).
- Un Business Portfolio en Meta Business Suite (si no tienes uno, se crea en el mismo proceso).
- Datos legales reales del negocio: razón social, domicilio fiscal, RFC (o tu ID fiscal local), correo de contacto.
- Una página de Política de Privacidad y otra de Términos de Servicio publicadas en un dominio que controles (ver sección final para qué deben incluir).
- Un nombre para el perfil de WhatsApp Business — no puede ir en mayúsculas todas (Meta lo rechaza). Si tu marca es "SSTDG", usa "Sstdg".
Paso 1 — Crear la app en Meta for Developers (tipo Business)
Ve a developers.facebook.com/apps/creation y sigue el asistente:
- Escribe el nombre de la app y el correo de contacto.
- En el paso de "casos de uso", si no ves explícitamente una elección "Business vs Consumer", selecciona Other (la última opción) en vez de la tarjeta específica de WhatsApp — este camino sí te lleva a una pantalla dedicada "Select an app type" con las opciones Business/Consumer.
- Selecciona Business explícitamente.
- Conecta la app al Business Portfolio correcto.
⚠️ Error común: si Meta te pide reingresar tu contraseña o verificar el dispositivo a la mitad del proceso de creación, complétalo tú mismo — nunca compartas tu contraseña con un agente automatizado. Si el proceso se interrumpe ahí, la app puede quedar con App type: None, y en ese caso el producto WhatsApp nunca va a aparecer disponible sin importar cuántas veces le des a "Add Product". La solución es borrar esa app y repetir el asistente completo sin interrupciones.
Una vez creada, confirma en el encabezado del dashboard que dice App type: Business, y agrega el producto WhatsApp desde "Available products".
Paso 2 — Revisa que la app no tenga datos de otro dueño
Si la app viene de otro proyecto o no estás seguro de que esté "limpia", ve a App Settings → Basic y revisa:
- Display name, correo de contacto, URL de Privacy Policy, URL de Terms of Service — si hay un dominio o marca que no corresponde al dueño actual, corrígelo antes de seguir. Esto evita problemas de revisión y verificación de negocio más adelante.
Paso 3 — Registrar el número de WhatsApp
Ve a WhatsApp → Step 2. Production setup → Register your WhatsApp phone number → Add new number. Es un diálogo de 3 partes:
- Perfil de WhatsApp Business: nombre (sin mayúsculas), zona horaria, categoría de negocio.
- Número: país + número de teléfono, y método de verificación (SMS o llamada).
- Verificación: código de 6 dígitos que llega al teléfono.
Errores conocidos en este paso (ambos suelen resolverse recreando la app limpiamente o esperando unos minutos y reintentando):
- Unexpected null value for wabaID
- Failed to check phone number eligibility
Al verificar con éxito, anota el Phone Number ID y el WhatsApp Business Account ID (WABA ID) que muestra la tabla — los vas a necesitar para la API.
Paso 4 — Verificación de negocio (recomendada, no siempre obligatoria)
Con el negocio sin verificar el número ya puede enviar y recibir mensajes reales — no es un bloqueo total. Lo que cambia son los límites y el "sello" de confianza. Ver la sección "¿Qué pasa si no verifico mi negocio?" más abajo para el detalle exacto.
Dicho esto, en algunos flujos (por ejemplo, si intentas registrar el número directamente vía llamada a la API en vez del asistente del panel) Meta sí puede devolver un bloqueo duro:
Phone Link to WABA Failed - Unverified WABA: You cannot proceed with this operation since your WhatsApp Business account is not verified.
Si te topas con ese error específico, o si quieres subir tu límite diario de mensajes iniciados por el negocio, completa la verificación en Meta Business Suite → Settings → Business Info:
- En "Business details", asegúrate de que el nombre legal, domicilio y Tax ID (RFC) coincidan exactamente con el documento oficial que vas a subir.
- En "Business verification status", da clic en "View details" para abrir el asistente formal donde subes el documento (acta constitutiva, comprobante fiscal, etc.).
¿Qué pasa si no verifico mi negocio? (restricciones reales, en palabras simples)
- 250 números únicos por 24 horas para mensajes que el negocio inicia. Si ustedes le escriben primero a alguien que no les ha escrito recientemente, solo pueden hacerlo con 250 personas distintas por día.
- Con negocio verificado, ese límite sube a 2,000. Verificar el negocio ante Meta les da más "cupo" diario si algún día quieren contactar gente por su cuenta, no solo responder.
- Los mensajes que inician los clientes están exentos de ese límite. Cuando alguien le escribe primero al bot y este responde, eso no cuenta para ningún límite — pueden recibir y contestar tantos mensajes como lleguen, sin tope.
- No hay check verde de "negocio verificado". Es solo la insignia visual de confianza que ven los usuarios — no afecta que el bot funcione, es más una cuestión de imagen.
Fuente oficial: developers.facebook.com/docs/whatsapp/messaging-limits — ahí Meta documenta los niveles de mensajería (tiers), cómo se sube de nivel, y qué cuenta como "ventana de servicio al cliente" (customer service window) vs. mensaje iniciado por el negocio.
Paso 5 — Generar un token de acceso permanente
Ve a Meta Business Suite → Business Settings → Users → System users:
- Clic en + Add. Acepta la política de no-discriminación si aparece.
- Nombra el usuario de sistema (evita espacios o la palabra "WhatsApp" en el nombre; usa algo tipo miproyecto-admin).
- Rol: Admin.
- Asigna assets: la app (acceso completo) y la cuenta de WhatsApp/WABA (acceso de administración de números y plantillas).
- Clic en Generate token: elige la app, expiración Never (los tokens de system user no caducan como los de usuario normal), y en permisos busca "whatsapp" y selecciona:
- whatsapp_business_management
- whatsapp_business_messaging
- whatsapp_business_manage_events
Trata este token como una contraseña. Cópialo tú mismo y guárdalo en un lugar seguro (gestor de contraseñas o variable de entorno del servidor) — nunca lo compartas por canales no seguros.
Paso 6 — Configurar el webhook
En WhatsApp → Step 2 → Configure Webhooks, captura:
- Callback URL: el endpoint de tu servidor (ej. https://tudominio.com/webhook)
- Verify Token: una cadena secreta que tu servidor debe validar
Solo da clic en "Verify and save" cuando tu servidor ya esté desplegado y respondiendo — si el endpoint no existe todavía, la verificación falla. Una vez que funciona, Meta suscribe automáticamente la app a los eventos principales (mensajes, actualizaciones de plantillas, llamadas, etc.).
Paso 7 — Pasar la app a modo Live
Esta es la restricción que sí bloquea por completo la recepción de mensajes de cualquier número: mientras la app esté en modo Development, Meta solo entrega webhooks de prueba a los admins/desarrolladores de la app — los mensajes de números reales no llegan, sin importar que el número y el webhook ya funcionen.
Para cambiar a Live (el switch junto al App ID, arriba del dashboard) necesitas tener lista una Privacy Policy URL válida en App Settings → Basic — si falta, Meta bloquea el cambio con el mensaje: "You must provide a valid Privacy Policy URL in order to take your app Live."
La verificación de negocio (Paso 4) no es requisito para pasar a Live ni para recibir mensajes — solo afecta tu límite diario de mensajes iniciados por el negocio, como se explicó arriba.
¿Cuánto cuesta?
Para un caso de uso como este (el cliente escribe primero al bot y este responde dentro de la ventana de 24 horas): $0, gratis.
Desde julio de 2025, Meta cambió el modelo de cobro de WhatsApp Business a "por mensaje" (antes era por plantilla). Los mensajes iniciados por el cliente, y las respuestas del negocio dentro de esas 24 horas, no tienen costo. Solo se cobra por mensajes que el negocio inicia fuera de esa ventana (por ejemplo, campañas de marketing con plantillas aprobadas).
Qué debe incluir tu página de Política de Privacidad
Como mínimo, para cumplir con los requisitos de Meta:
- Identidad legal del negocio (razón social, domicilio, contacto).
- Qué datos se recopilan vía WhatsApp (número, nombre, contenido de mensajes).
- Para qué se usan (soporte, el propósito específico del bot).
- Con quién se comparten (Meta/WhatsApp como plataforma, y cualquier otro backend como CRM o IA).
- Cuánto tiempo se conservan los datos.
- Derechos del usuario (solicitar borrado, darse de baja).
- Un contacto de privacidad.
Checklist final — datos que debes tener al terminar
- ☐ App ID (tipo Business confirmado)
- ☐ Phone Number ID
- ☐ WhatsApp Business Account ID (WABA ID)
- ☐ Token de acceso permanente
- ☐ Webhook configurado y verificado
- ☐ App en modo Live (requiere Privacy Policy URL válida)
- ☐ (Opcional) Verificación de negocio completa — sube el límite de 250 a 2,000 mensajes/día iniciados por el negocio, y agrega el check verde
Guía basada en una implementación real. Si usas Claude Code, la skill whatsapp-business-meta-setup automatiza este proceso y ya incorpora los errores y soluciones descritos aquí.