WhatsApp Cloud API: guía de configuración paso a paso (2026)

Poner en marcha la WhatsApp Cloud API parece intimidante si nunca lo has hecho, pero en 2026 el proceso está más ordenado que nunca. Esta guía te lleva paso a paso, desde crear la cuenta de negocio de Meta hasta enviar tu primer mensaje de prueba, sin dar por sentado que ya eres desarrollador.

Antes de empezar: la Cloud API es la versión alojada por Meta (ya no hay que montar servidores on-premise, que Meta descontinuó). Es gratuita de hospedar; solo pagas por las conversaciones que envías.

Qué necesitas antes de empezar

Reúne esto para no frenarte a mitad de camino:

• Una cuenta de Meta Business (Business Manager) verificada o verificable.
• Un número de teléfono que NO esté activo en la app normal de WhatsApp (o que estés dispuesto a migrar).
• Acceso al teléfono/SMS de ese número para recibir el código de verificación.
• El nombre para mostrar de tu negocio, tal como quieres que aparezca.

Paso 1: crea tu cuenta y app en Meta

1. Entra en business.facebook.com y crea (o usa) tu Business Manager.
2. Ve a developers.facebook.com, crea una app de tipo Business.
3. Añade el producto WhatsApp a la app.

Meta te dará un entorno de pruebas con un número de test y un token temporal. Sirve para experimentar, pero para producción necesitas tu propio número.

Paso 2: agrega y verifica tu número

En el panel de WhatsApp de tu app:

1. Añade tu número de teléfono de negocio.
2. Elige el método de verificación (SMS o llamada).
3. Introduce el código que recibas.
4. Configura el nombre para mostrar. Meta lo revisa y puede tardar de minutos a horas.

Consejo: el nombre para mostrar debe cumplir las políticas de Meta (no puede ser genérico ni engañoso). Un nombre rechazado retrasa todo.

Paso 3: entiende el token de acceso

Aquí muchos se traban. Hay dos tipos de token:

• Token temporal: dura 24 horas, útil solo para probar.
• Token permanente (System User): el que usarás en producción, generado desde un usuario del sistema en Business Manager.

Para producción, crea un System User, asígnale el activo de WhatsApp y genera un token permanente con los permisos whatsapp_business_messaging y whatsapp_business_management. Guárdalo de forma segura: es la llave de tu cuenta.

Paso 4: configura el webhook

El webhook es lo que permite recibir mensajes, no solo enviarlos. Necesitas:

1. Una URL HTTPS pública que responda al challenge de verificación de Meta.
2. Un verify token que tú inventas y Meta te devuelve para confirmar.
3. Suscribirte a los campos messages para recibir mensajes entrantes.

Si no quieres programar el servidor de webhooks, una plataforma como Omnifox resuelve toda esta parte: conectas tu número con el Embedded Signup oficial de Meta y la bandeja recibe y envía sin que toques una sola línea de webhook.

Paso 5: crea tu primera plantilla

Fuera de la ventana de 24 horas, solo puedes iniciar conversación con plantillas aprobadas. Crea una:

• Elige categoría: utility, marketing o authentication.
• Escribe el cuerpo con variables {{1}} para personalizar.
• Envíala a revisión. La aprobación suele tardar de minutos a un día.

Evita mezclar tono promocional en una plantilla utility: es la causa número uno de rechazos.

Paso 6: envía tu mensaje de prueba

Con el token y el número listos, un POST al endpoint /messages con el cuerpo de la plantilla envía tu primer mensaje. Si recibes un messages con un id en la respuesta, ¡funciona!

Errores típicos en esta etapa:

• Código 131009: parámetro inválido, revisa el formato del número (E.164, con +).
• Código 190: token expirado o inválido; genera uno permanente.
• Número no en allowlist: en modo de pruebas solo puedes escribir a números verificados.

Del sandbox a producción

Para escalar necesitas:

1. Verificar tu negocio en Meta (Business Verification).
2. Subir el límite de mensajería (empieza en 250/1.000 conversaciones/día y crece con buen comportamiento).
3. Cuidar tu calidad de número (verde/amarillo/rojo): demasiados bloqueos la degradan.

Conclusión

Configurar la WhatsApp Cloud API en 2026 son seis pasos claros: crear la app, verificar el número, generar un token permanente, montar el webhook, crear una plantilla y enviar la prueba. La parte técnica que más asusta —webhooks y tokens— es justo la que una plataforma omnicanal te ahorra.

Si prefieres saltarte el trabajo de servidor y tener tu número activo hoy, conecta WhatsApp con Omnifox mediante el Embedded Signup oficial y empieza a conversar en minutos.