WhatsApp Cloud API: Guía Completa de la API Oficial de Meta

La WhatsApp Cloud API es la forma oficial y gratuita de alojamiento que Meta ofrece para que las empresas conversen con clientes a escala dentro de WhatsApp. Si ya te has perdido entre siglas como BSP, plantilla, ventana de 24 horas y precio por mensaje, esta guía desmitifica todo: qué es, cómo funciona, cuánto cuesta realmente y cuándo tiene sentido para tu negocio.

TL;DR

• La WhatsApp Cloud API está alojada por la propia Meta, sin coste de servidor: solo pagas por los mensajes que envías.
• Desde el 1 de julio de 2025, el cobro es por mensaje entregado, y no por conversación.
• Las conversaciones iniciadas por el cliente (atención al cliente) son gratuitas e ilimitadas dentro de la ventana de 24 horas.
• Los límites de envío comienzan bajos (250 mensajes/día sin verificación) y crecen según verificación, calidad y volumen.
• La API es solo la tubería: todavía necesitas una plataforma de atención al cliente por encima de ella.

Qué es la WhatsApp Cloud API (y qué no es)

La WhatsApp Cloud API es una de las tres formas en que una empresa puede conectarse a WhatsApp dentro de la llamada WhatsApp Business Platform — el conjunto de productos corporativos de Meta. En la práctica, es una interfaz de programación (API) que tu empresa, o el software que contrates, utiliza para enviar y recibir mensajes de forma automatizada, sin que nadie escriba en el móvil.

La palabra clave es Cloud: a diferencia de la antigua versión On-Premises, aquí es la propia Meta la que aloja toda la infraestructura en sus servidores, de forma gratuita. No mantienes servidor, no actualizas versión, no te preocupas por el tiempo de actividad de la tubería. Esto reduce drásticamente la barrera técnica para empezar.

Ahora, lo que no es: la Cloud API no es una aplicación. No tiene pantalla, no tiene bandeja de entrada, no tiene botón de enviar. Es un motor. Para que un humano atienda, o para que un agente de IA responda, necesitas una capa de software encima — ya sea una plataforma lista para usar o un sistema propio. Confundir la API con la solución completa es el error número uno de quienes empiezan.

Cloud API, On-Premises y Business App: las tres puertas de entrada

Existen tres caminos oficiales para usar WhatsApp de forma profesional, y elegir el equivocado cuesta tiempo y dinero. La tabla siguiente resume las diferencias.

Característica	WhatsApp Business App	Cloud API	On-Premises API
Quién aloja	Tu móvil	Meta (nube)	Tu servidor
Coste de infraestructura	Gratis	Gratis	Servidor + mantenimiento
Agentes simultáneos	Hasta 5 dispositivos	Ilimitados	Ilimitados
Automatización real	Limitada	Completa	Completa
Estado en 2026	Activo	Recomendado	Descontinuada

La Business App es la aplicación gratuita de la tienda, ideal para microempresas con bajo volumen — pero se bloquea cuando necesitas varios agentes y automatización seria. La On-Premises API era la versión antigua que se ejecutaba en tu servidor; Meta la descontinuó y finalizó el soporte en octubre de 2025, migrando a todos a la nube. Por eso, hoy, la WhatsApp Cloud API es la elección estándar para cualquier operación que se tome en serio la atención al cliente. Si aún dudas entre app y API, vale la pena leer nuestra comparativa detallada en WhatsApp Business App vs API Oficial.

Cómo funciona la WhatsApp Cloud API por dentro

Entender tres conceptos resuelve el 90% de la confusión sobre la API oficial. Son las plantillas, la ventana de 24 horas y los webhooks.

Plantillas de mensaje

No puedes enviar cualquier texto a quien no te ha hablado primero. Para iniciar una conversación, la empresa debe usar una plantilla (modelo de mensaje) previamente aprobada por Meta. Cada plantilla tiene una categoría — marketing, utilidad o autenticación — y esa categoría define cuánto pagas. Las plantillas son precisamente lo que protege al usuario del spam y lo que mantiene la calidad del ecosistema.

La ventana de atención de 24 horas

Cuando un cliente te envía un mensaje, se abre una ventana de atención de 24 horas. Dentro de ella, respondes libremente, con cualquier contenido, sin plantilla y — desde noviembre de 2024 — sin pagar nada. ¿Pasaron las 24 horas sin que el cliente respondiera? Para reabrir la conversación, necesitas una plantilla de pago. Este mecanismo es el corazón del modelo de coste.

Webhooks

La Cloud API se comunica con tu sistema a través de webhooks: cada vez que llega un mensaje, Meta envía una notificación a una dirección (URL) que configuras. Así es como tu plataforma sabe que el cliente respondió y puede activar un humano o un agente de IA en tiempo real.

Cuánto cuesta: el modelo de precio por mensaje

Aquí reside la mayor fuente de mitos. Hasta mediados de 2025, Meta cobraba por conversación (bloques de 24 horas). Desde el 1 de julio de 2025, el modelo cambió a precio por mensaje entregado (per-message pricing): pagas por cada mensaje de plantilla que llega al destinatario, y el valor depende de la categoría y del país del número que recibe.

Categoría	Cuándo se usa	Cobro
Servicio (atención)	Respuesta dentro de la ventana de 24h	Gratuita
Utilidad	Confirmaciones, recibos, actualizaciones de pedido	De pago (gratis dentro de la ventana)
Autenticación	Códigos de verificación (OTP)	De pago, por mensaje
Marketing	Promociones y campañas	De pago, generalmente la más cara

Dos puntos que casi nadie explica bien: primero, los mensajes de atención al cliente son gratuitos e ilimitados — si tu negocio es mayoritariamente reactivo (el cliente llama, tú respondes), el coste de mensajería puede ser casi cero. Segundo, Meta ha comenzado a ofrecer tarifas más bajas por volumen para plantillas de utilidad y autenticación. Las tarifas varían mucho según el país, así que consulta siempre la tabla oficial de la categoría que más uses.

Para hacerlo concreto, piensa en una tienda que envía la confirmación de un pedido (utilidad) y el cliente responde con una duda. La confirmación dentro de la ventana abierta puede salir gratis, y todo el intercambio de atención posterior también. En cambio, una campaña promocional enviada a mil contactos que no han interactuado recientemente cae en la categoría de marketing — la más cara — y cada mensaje entregado se cobra. La lección práctica es directa: cuanto más tu flujo sea de atención y utilidad, menor el coste; cuanto más sea de marketing frío, mayor. Diseñar los flujos con esto en mente es lo que separa una operación eficiente de una cara.

Atención a un coste oculto: el intermediario. Muchas plataformas añaden un margen (markup) sobre el precio de Meta por cada mensaje. En volumen, esto se convierte en un valor relevante. Detallamos esta trampa en Markup en los Mensajes de WhatsApp.

Límites de envío y throughput: cómo escalar sin ser bloqueado

La WhatsApp Cloud API no libera envío infinito desde el primer día — y esto es intencionado, para contener el spam. Toda cuenta nueva comienza en un nivel de mensajería bajo y sube por mérito.

• Sin verificación de negocio: 250 mensajes iniciados por empresa en 24 horas.
• Verificado y con buena calidad: los límites suben en escalones — 1.000, 10.000, 100.000 y, en algunos casos, ilimitado.
• Avance de nivel: desde octubre de 2025, el límite se cuenta por Portafolio de Negocios (ya no por número), y Meta reevalúa la mejora cada pocas horas.

También está el throughput, que es la velocidad de envío. Por defecto, la Cloud API procesa alrededor de 80 mensajes por segundo, y las cuentas con nivel elevado pueden llegar a 1.000 por segundo. Para la mayoría de las pymes, este techo nunca es un problema.

Lo que derriba una cuenta no es el volumen en sí, sino la calidad. Si mucha gente bloquea o denuncia tus mensajes, tu puntuación de calidad baja, el nivel deja de subir y el número puede ser restringido. Como la propia API oficial reduce — pero no elimina — este riesgo, vale la pena entender las buenas prácticas en Cómo Evitar el Bloqueo del WhatsApp Empresarial.

Cómo empezar con la WhatsApp Cloud API: paso a paso

Técnicamente, se puede poner en marcha un número de prueba en minutos. Para producción, el camino es el siguiente:

1. Cuenta en Meta Business Manager — el panel central donde se gestiona todo.
2. Verificación del negocio (Business Verification) — envío de documentos de la empresa; es lo que desbloquea los límites mayores.
3. Cuenta de WhatsApp Business (WABA) — creada dentro del Business Manager.
4. Registro del número — un número de teléfono que no esté vinculado a un WhatsApp común o Business App. Este punto atrapa a mucha gente.
5. Aprobación de las plantillas — registra y espera la revisión de Meta.
6. Configuración de los webhooks — para recibir las respuestas en tu sistema.

Cuándo NO hacerlo solo: si no tienes equipo de desarrollo, integrar la API cruda da mucho trabajo y mantenimiento continuo. En esos casos, contratar una plataforma que ya lo entregue todo listo sobre la Cloud API suele salir más barato que mantener un sistema propio.

Errores comunes que derriban cuentas en la Cloud API

Después de implementar la WhatsApp Cloud API en decenas de operaciones, los tropiezos se repiten:

• Usar un número personal ya activo en WhatsApp común. Un número registrado en la API no puede existir simultáneamente en la app normal. Migrar requiere eliminar la cuenta antigua de ese número.
• Tratar la plantilla de marketing como atención. Enviar promociones a quien no las pidió destroza la puntuación de calidad y el coste.
• Ignorar la ventana de 24 horas. Intentar responder fuera de ella sin plantilla simplemente no se entrega.
• Comprar la API pensando que es la solución final. Sin una capa de atención por encima, tienes un motor sin coche.
• Descuidar la categoría de la plantilla. Registrar como utilidad algo que es claramente marketing lleva al rechazo o a la reclasificación por parte de Meta, y puede encarecer lo que parecía barato.

La buena noticia es que todos estos errores se pueden evitar con planificación. La mayoría de ellos, de hecho, desaparecen cuando usas una plataforma que abstrae el registro, la categorización y el respeto a la ventana de 24 horas. Si tu número ya ha sido restringido alguna vez, la migración a la API oficial suele ser la salida más segura — tema que profundizamos en WhatsApp Bloqueado: la API Oficial es la Salida.

La Cloud API es el motor, no el coche

Vale repetirlo, porque es el malentendido más caro: la WhatsApp Cloud API sola no atiende a nadie. Transporta mensajes. Quien organiza colas, distribuye conversaciones entre agentes, guarda historial, lanza automatizaciones y pone un agente de IA para responder 24/7 es la plataforma que se ejecuta sobre la API.

Es exactamente ese el papel de soluciones como Voyia, que usan la API oficial por debajo y ofrecen la experiencia completa de atención — sin que tengas que lidiar con webhooks, plantillas y Business Manager manualmente. Si tu equipo hoy paga por agente, vale la pena ver por qué este modelo ya no cuadra en Agentes Ilimitados en WhatsApp.

Conclusión: cuándo tiene sentido la WhatsApp Cloud API

Si tu empresa necesita varios agentes, automatización real y quiere estar del lado correcto de las reglas de Meta, la WhatsApp Cloud API es el camino — gratuita de alojar, se paga solo por mensaje y cada vez más con atención sin coste. El secreto es dejar de verla como producto final y tratarla como la base sobre la que tú (o un socio) construyes la atención al cliente.

El siguiente paso es simple: haz una lista hoy de cuántos agentes y qué volumen de mensajes tienes realmente. Con esos dos números en mano, es fácil decidir entre la Business App, la API cruda o una plataforma lista — y dejar de pagar por lo que no usas.