WhatsApp Cloud API explicada
La WhatsApp Cloud API es la versión de la API de la plataforma WhatsApp Business que Meta aloja por ti. Tu software envía mensajes con solicitudes HTTPS y recibe respuestas y estados de entrega por webhook. Meta cerró la antigua API On-Premises el 23 de octubre de 2025, así que hoy las empresas usan la Cloud API.
Por Mousa Alhelo, fundador, E-SAFQA · Actualizado · 7 min de lectura · Cómo escribimos y probamos estas guías
¿Qué es la WhatsApp Cloud API?
La WhatsApp Cloud API es la interfaz de la plataforma WhatsApp Business que aloja Meta. Un desarrollador, o un proveedor que crea la integración por ti, la llama por HTTPS a través de la Graph API de Meta para enviar mensajes de texto, multimedia e interactivos desde un número de teléfono de empresa. Las respuestas y las actualizaciones de estado de los mensajes vuelven a una URL de webhook que controlas tú. No gestionas ningún servidor de WhatsApp, y por eso el blog para desarrolladores de Meta la describe como la Cloud API, alojada por Meta.
Es un producto para desarrolladores, no una app. No hay bandeja de entrada ni panel hasta que tú o un proveedor lo construyen, y por eso muchas tiendas conocen la Cloud API a través de un Business Solution Provider o de una app creada sobre ella.
¿Qué pasó con la API On-Premises?
Antes de la Cloud API, una empresa podía alojar el cliente On-Premises de WhatsApp en sus propios servidores. Meta lo retiró por etapas, y su página de cierre da las fechas siguientes (comprobadas en octubre de 2026).
- Si un proveedor o una integración antigua todavía habla de alojamiento On-Premises, pregunta si ya se migró a la Cloud API.
| Fecha | Qué cambió |
|---|---|
| 9 de enero de 2024 | Las funciones nuevas llegan solo a la Cloud API. El cliente On-Premises recibe únicamente correcciones de errores y de seguridad. |
| 1 de julio de 2024 | Los números de empresa nuevos solo pueden registrarse para la Cloud API. Intentar registrar uno para On-Premises devuelve el código de error 1005. |
| 23 de octubre de 2025 | Venció la última versión On-Premises. Ya no puede enviar mensajes, y los mensajes hacia o desde números que sigan registrados en ella no se entregan. |
¿Qué necesitas para empezar a usar la Cloud API?
La guía de inicio de Meta enumera los requisitos a octubre de 2026: una cuenta de Facebook o una cuenta de Meta administrada, el registro como desarrollador, un portafolio comercial y un dispositivo con WhatsApp para los mensajes de prueba. Estos son los pasos principales.
- Crea una app de Meta con el caso de uso de WhatsApp en el panel de apps de Meta (Meta App Dashboard) y asocia tu portafolio comercial.
- Conecta una cuenta de WhatsApp y una cuenta de mensajería (Messaging account). La documentación más reciente de Meta usa estos dos términos; la cuenta de mensajería guarda tus plantillas de mensajes y los datos de facturación, y tu antiguo ID de WABA ahora la identifica.
- Envía un mensaje de prueba desde el número de prueba con un token de acceso temporal.
- Configura un webhook para que las actualizaciones de estado y las respuestas de los clientes lleguen a tu servidor.
- Crea un usuario del sistema y un token de acceso permanente con los permisos whatsapp_business_messaging y whatsapp_business_management.
- Registra tu propio número de empresa y asígnale un nombre visible. Un número que ya se usa en WhatsApp debe eliminarse primero, salvo que lo incorpores con la función de coexistencia de Meta para usuarios de la app WhatsApp Business.
¿Cómo funcionan los mensajes y los límites en la Cloud API?
Meta indica tres formas de subir el límite inicial de 250 a 2000: verificar tu empresa, que un socio la verifique o entregar 2000 mensajes de plantilla de alta calidad en 30 días. Los niveles superiores de 10 000, 100 000 e ilimitado se desbloquean automáticamente a medida que crecen tu calidad y tu uso.
| Regla | Qué documenta Meta |
|---|---|
| Consentimiento (opt-in) | Solo puedes escribir a personas que han aceptado recibir mensajes de tu empresa. |
| Ventana de atención al cliente | Cuando un cliente te escribe, se abre una ventana de 24 horas que se reinicia con cada mensaje nuevo del cliente. Dentro de ella puedes enviar mensajes de servicio de texto libre. |
| Mensajes de plantilla | Fuera de la ventana solo puedes enviar plantillas preaprobadas de las categorías marketing, utilidad o autenticación. |
| Límite de mensajería | El número de clientes únicos a los que puedes escribir fuera de una ventana de servicio en 24 horas móviles se fija por portafolio comercial. Los portafolios nuevos empiezan en 250. |
| Rendimiento (throughput) | Un número de empresa envía hasta 80 mensajes por segundo de forma predeterminada, y puedes solicitar más. |
¿Cuánto cuesta la WhatsApp Cloud API?
Meta cobra por cada mensaje entregado. Desde el 1 de julio de 2025 el precio es por mensaje y no por conversación, y la tarifa depende de la categoría del mensaje (marketing, utilidad, autenticación o servicio) y del prefijo telefónico del país del destinatario. Arabia Saudita es uno de los mercados que figuran en la tarifa de Meta, así que los mensajes a números +966 se cobran a su propia tarifa (consulta /es/blog/whatsapp-api-saudi-arabia-pricing). Meta no cobra los mensajes que los clientes envían a una empresa.
Desde el 1 de octubre de 2026 también se cobran las respuestas de servicio dentro de la ventana de 24 horas. La página de precios de Meta indica un nivel gratuito de 1000 mensajes de servicio por número de empresa cada mes. Los proveedores añaden sus propias tarifas de plataforma, que no figuran en la tarifa de Meta. Para ver las tarifas vigentes y un ejemplo práctico, consulta nuestra guía de precios en /es/blog/whatsapp-business-api-pricing-explained.
¿Cloud API, app de WhatsApp Business o app de dispositivo vinculado?
| Cloud API | App de WhatsApp Business | App de dispositivo vinculado (WhatsApp Pilot) | |
|---|---|---|---|
| Quién crea la experiencia | Un desarrollador o un proveedor | WhatsApp, como app gratuita | WhatsApp Pilot, una app de Shopify de E-SAFQA |
| Número | Un número de empresa registrado en la API | Tu número en la app | Tu propio número, conectado con un código QR |
| Tarifas de Meta por mensaje | Sí, por cada mensaje entregado | Ninguna | Ninguna |
| Plantillas | Obligatorias fuera de la ventana de 24 horas | No se usan | Texto libre que editas en la app |
| Estado de entrega y lectura | Se informa por webhook | Se muestra en la app | No disponible con un dispositivo vinculado |
| Ideal para | Gran volumen, campañas, varios agentes, chatbots | Una persona que responde chats | Una tienda que envía mensajes de pedido desde su propio número |
¿Una tienda Shopify necesita la Cloud API?
No siempre. Si necesitas gran volumen, plantillas aprobadas, estado de entrega y lectura, o un chatbot, la Cloud API es la base adecuada, normalmente a través de un proveedor. Si una sola tienda quiere sobre todo confirmaciones de pedido, avisos de envío y recordatorios con consentimiento desde el número de WhatsApp que sus clientes ya conocen, una app de dispositivo vinculado es más sencilla.
WhatsApp Pilot, una app de Shopify de E-SAFQA, conecta tu propio número de WhatsApp como dispositivo vinculado escaneando un código QR. No hay API de WhatsApp Business ni tarifa de Meta por mensaje; Pro cuesta USD 15 cada 30 días. A cambio, no están disponibles las confirmaciones de entrega ni de lectura. Los detalles están en /es/how-it-works/whatsapp-connection.
Preguntas frecuentes
¿Qué es la WhatsApp Cloud API?
Es la API de la plataforma WhatsApp Business alojada por Meta. El software le envía mensajes por HTTPS y recibe respuestas y actualizaciones de estado por webhook, sin gestionar servidores propios de WhatsApp.
¿Es gratuita la WhatsApp Cloud API?
No. Meta cobra por cada mensaje entregado según la categoría y el país, y los proveedores añaden tarifas de plataforma. Desde el 1 de octubre de 2026 también se cobran las respuestas de servicio, tras un nivel gratuito de 1000 por número de teléfono cada mes.
¿Qué pasó con la API On-Premises?
Meta dejó de añadir funciones en enero de 2024, cerró los registros nuevos el 1 de julio de 2024 y terminó el soporte el 23 de octubre de 2025. Los números de empresa ahora funcionan con la Cloud API.
¿Puedo usar la Cloud API y la app de WhatsApp Business con un mismo número?
Solo mediante la función de coexistencia de Meta, que se configura durante la incorporación. De lo contrario, un número que ya se usa en WhatsApp debe eliminarse antes de poder registrarlo para la Cloud API.
¿Necesito la verificación de empresa para usar la Cloud API?
Puedes empezar sin ella. Meta la indica como una forma de subir tu límite de mensajería de 250 a 2000 clientes al día, y el estado de Cuenta oficial de empresa la exige.
¿Listo para poner WhatsApp a trabajar en tu tienda?
Empieza con el widget gratis. Pásate a Pro para tener mensajes de pedido y de envío, recuperación de carritos, códigos de recompra, el botón inteligente de producto, avisos de reposición y Demanda de productos.