WhatsApp Cloud API: qué es y cómo funciona
La infraestructura oficial de Meta para enviar y recibir mensajes de WhatsApp por API, sin servidor propio.
Respuesta corta
La Cloud API es la forma actual (y única) en que Meta ofrece la WhatsApp Business Platform por API: la aloja Meta en su propia infraestructura, así que no necesitas montar ni mantener un servidor de mensajería. Es, de hecho, el mismo producto que la mayoría llama "WhatsApp Business API" — la versión antigua On-Premises, que sí requería servidor propio, dejó de funcionar el 23 de octubre de 2025.
Las piezas que necesitas
Cuenta de WhatsApp Business (WABA)
El contenedor de tu negocio dentro de Meta: agrupa tus números, plantillas y configuración. Detalle en la guía de qué es una WABA.
Número + Phone Number ID
Cada número tiene un ID interno distinto al número visible; lo usas en cada llamada a la API. Cómo localizarlo en la guía del Phone Number ID.
Token de acceso
Autentica cada llamada. Cómo generarlo y protegerlo en la guía de tokens.
Endpoint propio para webhooks
La única parte que sí alojas tú: una URL que reciba los eventos de Meta (mensajes entrantes, estados, plantillas). Ver la guía de webhooks.
Cómo se envía un mensaje, en concreto
Enviar un mensaje es una petición POST a un único endpoint de la API Graph de Meta, con tu token en la cabecera de autorización:
POST https://graph.facebook.com/v26.0/{phone-number-id}/messages
Authorization: Bearer {access-token}
Content-Type: application/json
{
"messaging_product": "whatsapp",
"to": "34600000000",
"type": "text",
"text": { "body": "Hola, ¿en qué puedo ayudarte?" }
}
Si no hay una ventana de servicio abierta con ese usuario (no te ha escrito en las últimas 24h), type tiene que ser "template" en vez de "text", usando una plantilla aprobada por Meta. Ejemplos completos con código en Node.js y Python.
Versión de la API Graph vigente al verificar esta página: v26.0 (fuente: Meta — Registro de cambios de la API Graph, verificado el 31 de agosto de 2026). Meta publica nuevas versiones periódicamente: comprueba siempre cuál es la vigente antes de fijarla en tu código.
Más allá de enviar texto
WhatsApp Flows
Formularios e interacciones guiadas dentro del propio chat, para captar leads o cualificar sin salir de WhatsApp.
Webhooks
Cómo recibes mensajes entrantes, confirmaciones de entrega y cambios de estado de tus plantillas.
Límites de mensajería
Cuántos usuarios únicos puedes contactar fuera de la ventana de servicio por día, y cómo subir de nivel.
Anuncios de clic a WhatsApp
Anuncios que abren directamente una conversación, con atribución por ctwa_clid.
Códigos de error
Busca tu código de error y encuentra la causa probable y la solución.
Changelog en español
Cambios de producto y política con fecha efectiva confirmada.
Embedded Signup
El flujo técnico que genera la WABA y da acceso a un proveedor. Migración v2 a v4 antes de octubre de 2026.
¿Llamar a la API directamente o usar un CRM ya hecho?
La mayoría de negocios no llaman a la Cloud API directamente: usan una plataforma que ya gestiona el token, la bandeja de mensajes, las plantillas y los webhooks por ti. Si estás decidiendo entre construir tu propia integración o usar una plataforma como Mensajes.co, compáralo en nuestra comparativa de construir vs. usar un CRM ya hecho.
Preguntas frecuentes
¿Necesito un servidor propio?
Solo para recibir webhooks (un endpoint HTTPS público). El envío y procesamiento de mensajes en sí lo aloja Meta — no necesitas la infraestructura que exigía la antigua On-Premises API.
¿"WhatsApp Business API" y "Cloud API" son lo mismo?
Hoy sí, en la práctica. "WhatsApp Business API" es el nombre genérico del producto; "Cloud API" es como Meta llama a la única forma soportada de acceder a él desde que la On-Premises API dejó de funcionar en octubre de 2025.
¿Cuánto cuesta usar la Cloud API?
Meta cobra por mensaje entregado según categoría y país. Calcula tu coste real en la calculadora de precios.