WhatsApp Cloud API (Meta)

WhatsApp Cloud API es la puerta oficial de Meta para automatizar WhatsApp en un negocio. A diferencia de las plataformas que la revenden con su propio panel (WATI, respond.io, 360dialog), aquí hablas directamente con la infraestructura de Meta: envías mensajes con una llamada HTTP y recibes las respuestas en un Webhook que apunta a tu servidor. Es la opción de menor coste por mensaje y máximo control, a cambio de que tú pongas el código, el servidor y la operativa.

El problema que resuelve es el de tener WhatsApp como canal serio de negocio sin pagar markup a un intermediario y sin perder control. Una pyme con tres mensajes al día puede vivir con la app gratuita; cuando entras en el terreno de cientos o miles de conversaciones, automatizaciones con tu CRM, notificaciones disparadas por eventos de tu app y atención multiagente, la Cloud API es la respuesta oficial. Y es la única vía aprobada por Meta para hacerlo sin riesgo de baneo: las soluciones no oficiales pueden suspenderte el número.

A quién rinde: a equipos con perfil técnico (un desarrollador interno o externo basta) que quieren WhatsApp integrado con sus sistemas y que prefieren pagar por código una vez antes que una mensualidad de SaaS a perpetuidad. También a startups que necesitan iterar rápido sobre flujos a medida que no encajan en plataformas no-code.

Por qué importa

WhatsApp es el canal de mensajería dominante en buena parte del mundo (España, Latinoamérica, India, gran parte de Europa) y se ha convertido en el sitio donde la gente espera atender lo importante: reservas, confirmaciones, soporte, ventas. Ignorarlo como canal de negocio es dejar dinero en la mesa. La Cloud API es la vía con menor fricción para integrarlo en tus procesos.

Importa también porque cambia la economía. Antes de que Meta lanzara la Cloud API en 2022, integrar con WhatsApp Business obligaba a pasar por un BSP (Business Solution Provider) que añadía coste y latencia. Ahora la API la opera Meta directamente, gratis la puesta en marcha y con tarifas más transparentes por conversación. Eso democratiza el acceso para negocios pequeños y para proyectos individuales.

Y a nivel técnico, ofrece capacidades que el WhatsApp normal no tiene: mensajes interactivos (botones, listas), plantillas multimedia, recepción de estados de entrega y lectura, integración con catálogos, mensajes con localización y contactos. Construir experiencias ricas (un asistente que muestra opciones tappables, un bot que manda audio o vídeo) requiere esta API.

Cómo se usa en la práctica

Lo primero es crear una app en Meta for Developers (el portal de Facebook para desarrolladores). Eliges tipo “Business” y le añades el producto “WhatsApp”. Meta te da automáticamente un número de prueba asociado a tu cuenta y un Business Account de WhatsApp, sin que tengas que verificar nada todavía. Esto sirve para experimentar gratis durante el desarrollo.

Del panel sacas dos valores clave: el Phone Number ID (el identificador del número que vas a usar) y un token de acceso temporal (que dura unas horas, suficiente para probar). Con esos dos valores ya puedes mandar tu primer mensaje. El endpoint base es https://graph.facebook.com/v23.0/PHONE_NUMBER_ID/messages (la versión del endpoint cambia con el tiempo, consulta la doc para la vigente), y un POST con el cuerpo JSON apropiado es todo lo que necesitas. El ejemplo en curl del cuerpo de la skill cubre el caso más sencillo: texto plano.

El segundo paso es configurar el webhook. Tu servidor tiene que exponer una URL pública con HTTPS válido. Meta te pedirá un token de verificación que tú eliges (un string aleatorio), te enviará un challenge a esa URL y, si respondes correctamente, queda activado. A partir de ese momento, todo mensaje entrante y todo cambio de estado (entregado, leído, fallido) llega como POST a tu webhook.

En desarrollo, lo más práctico es usar un túnel como ngrok o cloudflared para exponer tu servidor local con HTTPS. En producción, despliegas en un dominio propio con certificado válido. Si el certificado falla, Meta deja de enviarte eventos sin avisar.

Para producción “de verdad” hay tres pasos adicionales: registrar tu propio número (que no esté usado en la app normal de WhatsApp), pasar la verificación del negocio en Meta Business Manager (con documentos de la empresa) y generar un token permanente. El token permanente se crea creando un System User en Business Manager, asignándole permisos sobre la app y generando el token desde ahí. Este token no caduca, así que es el adecuado para tu servidor en producción.

A partir de aquí, vas construyendo: catálogo de plantillas (mensajes predefinidos que Meta tiene que aprobar para iniciar conversaciones o escribir fuera de la ventana de 24 horas), lógica de respuesta en tu backend, integraciones con tu base de datos o CRM. Si no quieres escribir backend, puedes orquestarlo todo con n8n, Make o Zapier, que ya traen nodos para la Cloud API y te dejan montar flujos sin servidor propio.

Para que el bot dé respuestas inteligentes, conectas tu backend con un proveedor de modelos (Claude, GPT, Gemini, un modelo local) y mandas a la API de WhatsApp lo que el modelo decida responder. Ese es el patrón estándar de “agente IA sobre WhatsApp”.

Monitorizar es importante. La API devuelve códigos de error específicos (límite de mensajes, plantilla rechazada, número bloqueado), y conviene loguearlos para entender qué falla. Meta también te enseña la “calidad” de tu número, que sube o baja según el comportamiento de los usuarios: muchos bloqueos la bajan y encarecen los mensajes.

Casos de uso reales

SaaS que avisa de eventos de la cuenta. Una herramienta de gestión manda por WhatsApp el aviso de “tu factura está lista” o “ha entrado un ticket urgente”. Cada evento del backend dispara un POST a la Cloud API con la plantilla correspondiente. El usuario lo recibe en el canal donde sí mira.

Bot de soporte 24/7 con escalado a humano. Una empresa monta su backend con la Cloud API y un modelo de IA. El bot responde el 80% de consultas; cuando detecta frustración o un tema complejo, manda un mensaje interactivo con un botón “Hablar con una persona” y la conversación se enruta al equipo humano en horario laboral.

Notificaciones logísticas en ecommerce. Una tienda con plataforma propia dispara desde sus eventos de envío plantillas con el estado del pedido: confirmado, enviado, en reparto, entregado. Si el cliente responde, su mensaje cae en el sistema de atención. Sustituye a los emails que nadie abre.

Integración con n8n para automatizar sin código. Un equipo sin desarrollador propio monta el flujo en n8n: cuando entra un mensaje al webhook, n8n consulta un Google Sheet, decide la respuesta y manda el mensaje de vuelta vía la Cloud API. Es una puerta de entrada sencilla a la API sin escribir un backend.

Errores comunes y cómo evitarlos

• Mandar texto libre fuera de la ventana de 24 horas. Solo funciona con plantillas aprobadas. Si intentas un texto suelto, la API responde con error y el mensaje no llega; revisa siempre cuándo fue el último mensaje del usuario antes de elegir el tipo.
• Confiar en el token temporal en producción. Vence en horas y deja tu servicio mudo. Crea un System User y genera un token permanente desde Business Manager para producción.
• Webhook sin HTTPS válido. Meta rechaza la verificación inicial y, peor aún, puede dejar de enviar eventos si el certificado caduca después. Renueva los certificados a tiempo (Let’s Encrypt automatiza esto).
• Mandar plantillas a contactos sin opt-in. Sube los bloqueos, baja tu calificación de calidad del número y encarece los mensajes futuros. Asegúrate de tener consentimiento explícito antes de iniciar conversaciones masivas.
• Olvidar las versiones del endpoint. El v23.0 del ejemplo no será para siempre; Meta deprecia versiones con cierta cadencia. Mantén la versión actualizada en tu código y revisa el changelog oficial periódicamente.
• No manejar reintentos ni colas. En picos, la API puede limitarte. Construye tu backend con cola de salida y reintentos exponenciales para no perder mensajes.

Cuándo NO usarla

No tiene sentido si no tienes (ni piensas tener) equipo técnico que opere un backend y un webhook. La Cloud API es flexible pero requiere código, despliegue y mantenimiento; si no, una plataforma no-code como WATI o respond.io te da el mismo resultado funcional sin que toques una línea.

Tampoco si tu volumen es muy bajo (decenas de mensajes al mes) y tu necesidad es solo atender desde el móvil: la app de WhatsApp Business gratuita cubre eso de sobra. La Cloud API tiene sentido cuando hay automatización, integración con sistemas o varios agentes atendiendo a la vez.

Y si tu prioridad es atención multicanal (WhatsApp + Instagram + Messenger + email + chat web) en una sola bandeja con IA encima, una plataforma comercial te ahorrará semanas de integración por canal.

Combinarla con otras herramientas

El combo más habitual es Cloud API + un backend propio (Node, Python, lo que prefieras) + un proveedor de modelos de IA para los bots inteligentes. Por encima, un CRM (HubSpot, Pipedrive) o una base de datos propia para guardar conversaciones y contactos. Para despliegue, cualquier nube ligera (Vercel para funciones serverless, Fly.io, Render, Railway o un VPS) sirve, siempre que tenga HTTPS estable.

Si quieres orquestar sin escribir backend, n8n y Make tienen nodos nativos de WhatsApp Cloud API y te permiten montar flujos enteros visualmente. Y si lo que quieres es un agente con IA, kits como WhatsApp AgentKit te dan el esqueleto y tú pones la lógica encima.

Mini-ejercicio

Crea una app en Meta for Developers tipo Business, añade el producto WhatsApp, copia el Phone Number ID y genera un token temporal. Desde tu terminal, ejecuta el comando curl del bloque de ejemplo de la skill cambiando los placeholders por tus valores reales y un número de prueba (el tuyo, dado de alta en la lista permitida del panel). Comprueba que el mensaje llega a tu móvil. Después monta un webhook básico con cualquier framework (Express, FastAPI, Flask) y exponlo con ngrok; configúralo en el panel de Meta y verifica que recibes el evento cuando respondes desde el móvil.

Sabrás que está bien si ves dos cosas: el mensaje saliente llega a tu WhatsApp en menos de cinco segundos, y tu servidor local registra en consola el JSON del mensaje entrante cuando contestas desde el móvil.