WhatsApp Cloud API: qué es y cómo empezar en 2026
La versión alojada por Meta de la WhatsApp Business Platform: sin servidores propios, con actualizaciones automáticas y acceso a todas las funciones nuevas primero.
TL;DR — Resumen rápido
Qué es la WhatsApp Cloud API
Meta ofrece dos caminos para que una empresa converse con clientes a escala: la WhatsApp Business App (gratuita, manual, hasta un equipo pequeño) y la WhatsApp Business Platform. La Cloud API es la implementación actual de esa plataforma: Meta corre la infraestructura en sus propios servidores y tu sistema solo hace llamadas HTTP.
- • Sin infraestructura propia: no instalas contenedores ni bases de datos de mensajería.
- • Actualizaciones automáticas: las funciones nuevas (Flows, Calling API, mensajes interactivos) llegan primero acá.
- • Multi-agente real: muchas personas y sistemas sobre el mismo número.
- • Webhooks: cada mensaje entrante llega a tu endpoint en tiempo real.
¿La WhatsApp Cloud API es gratis?
Parcialmente. Meta no cobra licencia por usar la infraestructura de la Cloud API: puedes crear una app de prueba y enviar mensajes de test sin pagar nada. Lo que sí se factura son los mensajes de plantilla según su categoría, y la plataforma o socio con el que operas.
Cómo funciona la Cloud API
El flujo es simétrico: tú llamas a Meta para enviar, Meta llama a tu webhook para entregarte lo que entra.
| Paso | Salida (envío) | Entrada (recepción) |
|---|---|---|
| 1 | Tu sistema arma el mensaje | El cliente escribe en WhatsApp |
| 2 | POST a graph.facebook.com/{version}/{phone_number_id}/messages | Meta recibe el mensaje |
| 3 | Meta valida plantilla, ventana y límites | Meta hace POST a tu webhook |
| 4 | Meta entrega al cliente | Tu sistema responde y registra en el CRM |
| 5 | Webhooks de estado: enviado, entregado, leído | Se abre o renueva la ventana de 24 horas |
Cada webhook incluye el identificador del contacto. Si el usuario adoptó un nombre de usuario, ese identificador es el BSUID en lugar del número de teléfono.
Qué necesitas para usarla
| Requisito | Detalle | ¿Obligatorio? |
|---|---|---|
| Cuenta de Meta Business | Con verificación de empresa para escalar los límites | Sí |
| Número de teléfono | Que no esté activo en WhatsApp personal, o migrado con Coexistencia | Sí |
| App en Meta for Developers | Con el producto WhatsApp agregado | Sí |
| Endpoint HTTPS para webhooks | Público, con verificación de token | Sí |
| Perfil de empresa completo | Nombre visible, categoría, descripción | Sí |
| Socio o plataforma | Bandeja compartida, CRM, automatización, soporte local | Recomendado |
| Meta Verified | Tilde de verificación en el perfil | Opcional |
Cómo empezar con la Cloud API
Ruta mínima para pasar de cero a un primer mensaje entregado.
- Crea o reclama tu cuenta de Meta Business y completa la verificación de empresa (documentación legal del negocio).
- Elige el número. Si vas a usar el que ya atiende clientes, revisa la migración con Coexistencia.
- Crea la app en Meta for Developers y agrega el producto WhatsApp; obtienes un
phone_number_idy un token temporal de prueba. - Configura el webhook con tu URL pública y suscríbete a los eventos de mensajes y estados.
- Envía tu primer mensaje de plantilla al número de prueba y verifica que llegan los webhooks de estado.
- Registra el número en producción, carga tus plantillas HSM y espera la aprobación.
- Conecta el CRM y define quién atiende: personas, automatización o un Agente IA.
Preguntas relacionadas
¿La Cloud API funciona igual en todos los países de LATAM?
¿Puedo tener varios números en la misma cuenta?
phone_number_id, su calidad y su propio límite de mensajería. Es lo habitual cuando separas ventas, soporte y cobranzas o cuando operas en varios países.Cloud API vs On-Premise API
La On-Premise fue el primer camino de acceso y quedó discontinuada. Esta tabla resume por qué cualquier proyecto nuevo debe nacer en Cloud.
| Criterio | Cloud API | On-Premise API |
|---|---|---|
| Alojamiento | Servidores de Meta | Servidores propios del negocio o del BSP |
| Mantenimiento | Automático | Manual: parches, escalado, monitoreo |
| Tiempo de alta | Horas o días | Semanas |
| Funciones nuevas | Primero y siempre | Ya no recibe novedades |
| Estado 2026 | Vía oficial y recomendada | Discontinuada por Meta |
Límites de mensajería y calidad
La Cloud API no te deja enviar todo lo que quieras desde el día uno. Meta escalona la capacidad según cómo reaccionan tus clientes.
| Tier | Destinatarios únicos por día | Cómo se sube |
|---|---|---|
| Inicial | 250 | Verificación de empresa |
| Tier 1 | 1.000 | Volumen sostenido + calidad media o alta |
| Tier 2 | 10.000 | Duplicar el uso del tier en 7 días |
| Tier 3 | 100.000 | Mismo criterio, manteniendo calidad |
| Tier 4 | Sin límite | Historial consistente sin caídas de calidad |
Si tu quality rating baja a rojo, Meta congela o reduce el tier. Los bloqueos y los reportes de los usuarios son la principal causa: cuida la relevancia de cada plantilla.
Preguntas frecuentes sobre la WhatsApp Cloud API
Páginas relacionadas
WhatsApp Business API
El panorama completo de la API: casos de uso, alta y operación.
Ver detalles de WhatsApp Business API →☁️Cloud vs On-Premise
Por qué Meta discontinuó la On-Premise y qué implica migrar.
Ver detalles de Cloud vs On-Premise →🔁Migrar de App a API
Paso a paso para llevar tu número actual a la Cloud API.
Ver detalles de Migrar de App a API →📊Límites de mensajes
Cómo funcionan los tiers y cómo escalar sin bloqueos.
Ver detalles de Límites de mensajes →🤝Proveedores y socios
Qué hace un BSP y cuándo conviene integrar directo.
Ver detalles de Proveedores y socios →