WhatsApp Cloud API: Guia Completa de Meta para Empresas [2026]

La WhatsApp Cloud API es la version alojada por Meta de la WhatsApp Business Platform. Permite a empresas de cualquier tamano conectar sus sistemas con WhatsApp sin necesidad de servidores propios, sin infraestructura compleja y sin depender de intermediarios para el hosting. Desde su lanzamiento en 2022, se ha convertido en la via de acceso principal para empresas que quieren automatizar su comunicacion por WhatsApp a escala. En esta guia os explicamos que es exactamente, en que se diferencia de la version On-Premise, como configurarla paso a paso, cuanto cuesta y que funcionalidades ofrece. Si buscais una vision mas amplia del ecosistema, consultad nuestra guia completa de WhatsApp Business API.

Que Es WhatsApp Cloud API y en Que Se Diferencia de On-Premise

La WhatsApp Cloud API es la interfaz de programacion oficial de Meta para WhatsApp Business, alojada integramente en la infraestructura de Meta. Esto significa que Meta se encarga de los servidores, las actualizaciones, la escalabilidad y el mantenimiento. Tu empresa solo necesita conectarse a los endpoints REST de la API y configurar webhooks para recibir mensajes entrantes.

Antes de la Cloud API, la unica forma de acceder a la WhatsApp Business API era mediante la version On-Premise: desplegabas contenedores Docker en tus propios servidores (o en los de un BSP) y tu equipo tecnico se encargaba de actualizaciones, escalado y disponibilidad. Era potente, pero costosa y reservada a empresas con recursos de ingenieria significativos.

Meta lanzo la WhatsApp Cloud API en mayo de 2022 con un objetivo claro: democratizar el acceso. Desde entonces, la version On-Premise ha ido perdiendo protagonismo y Meta recomienda oficialmente migrar a Cloud API. Si quereis entender la arquitectura tecnica completa, la explicamos en detalle en como funciona la WhatsApp Business API.

Cloud API vs On-Premise API

Estas son las diferencias fundamentales entre ambas versiones:

La diferencia mas notable es operativa: con la Cloud API no gestionais infraestructura. No hay contenedores que actualizar, no hay bases de datos que escalar, no hay incidencias de madrugada por un servidor caido. Meta absorbe toda esa complejidad.

Ventajas de migrar a Cloud API

Tres razones por las que la migracion es practicamente obligatoria en 2026:

1. Meta prioriza Cloud API. Las nuevas funcionalidades llegan primero a Cloud API. Los mensajes interactivos avanzados, los flujos de WhatsApp Flows y las mejoras en throughput se despliegan semanas antes en Cloud que en On-Premise. Quedarse en On-Premise es quedarse atras.

2. Coste total de propiedad inferior. Aunque la API en si tiene el mismo coste por conversacion, eliminais los gastos de servidores, mantenimiento, equipo DevOps y actualizaciones. Para la mayoria de empresas, la Cloud API reduce el coste total entre un 30 % y un 60 %.

3. Velocidad de implementacion. Una empresa puede estar enviando mensajes por Cloud API en menos de una hora. Con On-Premise, el proceso de certificacion, despliegue y verificacion tardaba dias. Si estais empezando desde cero, no hay razon para elegir On-Premise. Podeis consultar nuestra guia de configuracion de WhatsApp API para ver el proceso completo.

Como Empezar con WhatsApp Cloud API: Guia de Configuracion

Configurar la WhatsApp Cloud API requiere cuatro pasos. No necesitais experiencia previa con APIs, pero si un minimo de familiaridad con herramientas de desarrollo. Si preferis un BSP que se encargue de todo, podeis revisar los mejores proveedores BSP para WhatsApp API.

Crear cuenta Meta Business

El primer requisito es tener una cuenta de Meta Business (antes Facebook Business Manager). Si vuestra empresa ya gestiona paginas de Facebook o campanas de Instagram Ads, probablemente ya la teneis.

Acceded a business.facebook.com y verificad que vuestra empresa esta registrada. Si no, creareis una nueva cuenta con el nombre legal de la empresa, direccion y datos fiscales. Este paso es gratuito.

Importante: para usar la WhatsApp Cloud API sin limitaciones, necesitais completar la verificacion de negocio de Meta. Esto implica subir documentacion oficial (CIF, escritura, factura de servicios) y esperar entre 2 y 10 dias habiles para la aprobacion. Sin verificacion, estareis limitados a 250 conversaciones en 24 horas.

Configurar app en Meta Developers

Acceded a developers.facebook.com y cread una nueva aplicacion de tipo Business. Dentro de la app, anadid el producto WhatsApp desde el catalogo de productos disponibles.

Meta os proporcionara automaticamente:

• Un numero de telefono de prueba gratuito (sandbox).
• Un WhatsApp Business Account ID (WABA ID).
• Acceso al panel de WhatsApp Manager dentro de Meta Business Suite.

Desde este panel configurareis vuestro numero de produccion, el perfil de negocio (logo, descripcion, horario) y las plantillas de mensaje.

Obtener token de acceso

Para realizar llamadas a la API necesitais un token de acceso. Meta ofrece dos tipos:

Token temporal: se genera desde el panel de Meta Developers, dura 24 horas y es ideal para pruebas. No lo useis en produccion.

Token permanente: se obtiene creando un System User en Meta Business Suite, asignandole permisos sobre la app de WhatsApp y generando un token desde la configuracion del System User. Este es el que usareis en produccion.

El endpoint base de la API es:

https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages

Todos los mensajes se envian mediante peticiones POST a este endpoint con el token en la cabecera Authorization: Bearer {TOKEN}.

Enviar primer mensaje de prueba

Con el token en mano, podeis enviar vuestro primer mensaje. Aqui teneis un ejemplo con curl:

curl -X POST \
  'https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "34600000000",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": {
        "code": "es"
      }
    }
  }'

Si la respuesta incluye un campo messages con un id, el mensaje se ha enviado correctamente. El template hello_world viene preaprobado por Meta, asi que no necesitais crear plantillas personalizadas para la primera prueba.

Para entornos de produccion, configurareis webhooks que notifiquen a vuestro servidor cuando lleguen mensajes entrantes, cambios de estado de entrega o eventos de lectura. El webhook se configura desde el panel de Meta Developers indicando una URL HTTPS de vuestro servidor y un token de verificacion. Si quereis profundizar en el desarrollo con la API, tenemos una guia especifica para developers de WhatsApp API.

Precios y Costes de WhatsApp Cloud API

Uno de los puntos que mas confusion genera. Vamos a aclararlo. El acceso a la WhatsApp Cloud API de Meta es gratuito: no hay cuota mensual por usar la API. Lo que pagais son las conversaciones.

Modelo de conversaciones de Meta

Meta cobra por ventana de conversacion de 24 horas, no por mensaje individual. Una vez que se abre una conversacion (ya sea porque el usuario os escribe o porque vosotros le enviais un template), podeis intercambiar mensajes ilimitados durante 24 horas por el precio de una unica conversacion. Esto es una diferencia importante respecto a los BSP que cobran por mensaje.

Conversaciones de servicio vs marketing

Meta clasifica las conversaciones en cuatro categorias con precios diferentes:

Los precios varian por pais. Espana se encuentra en la franja europea, con tarifas intermedias. Podeis consultar el detalle actualizado en los precios de WhatsApp API.

Calculadora de costes

Para estimar vuestro gasto mensual:

1. Contad cuantas conversaciones unicas teneis al mes (no mensajes, conversaciones).
2. Clasificadlas por categoria (servicio, utilidad, autenticacion, marketing).
3. Multiplicad por la tarifa correspondiente.
4. Restad las primeras 1.000 conversaciones de servicio gratuitas cada mes.

Ejemplo practico: una empresa con 3.000 conversaciones de servicio y 500 de marketing al mes en Espana pagaria aproximadamente: (2.000 x 0,0311) + (500 x 0,0603) = 62,20 + 30,15 = 92,35 EUR/mes en costes de Meta. A esto sumad el coste del BSP si utilizais uno (como GuruSup, que incluye funcionalidades de automatizacion con agentes IA en su tarifa).

La buena noticia es que estas tarifas son competitivas comparadas con el coste de un agente humano atendiendo esas mismas conversaciones. Si automatizais el 70 % de las consultas con un chatbot para WhatsApp Business, el ROI es inmediato.

Funcionalidades Clave de WhatsApp Cloud API

La WhatsApp Cloud API no es solo enviar y recibir texto. Ofrece un ecosistema completo de funcionalidades para comunicacion empresarial avanzada.

Mensajes de plantilla

Los templates (plantillas) son mensajes preestructurados que Meta debe aprobar antes de su uso. Son la unica forma de iniciar conversaciones con usuarios que no os han escrito primero (conversaciones outbound).

Los templates soportan:

• Variables dinamicas: Hola {{1}}, tu pedido {{2}} esta en camino.
• Botones de respuesta rapida: hasta 3 opciones predefinidas.
• Botones de URL: enlace directo a web o app.
• Cabecera multimedia: imagen, video o documento adjunto.

La aprobacion por parte de Meta tarda entre 1 minuto y 24 horas. Los rechazos mas comunes son por contenido ambiguo, falta de variable de opt-out o incumplimiento de las politicas de comercio. Tenemos una guia dedicada a plantillas de mensaje para WhatsApp API con ejemplos aprobados y mejores practicas.

Mensajes interactivos

Mas alla de los templates, la Cloud API permite enviar mensajes interactivos dentro de conversaciones activas:

• Botones de respuesta: hasta 3 opciones que el usuario puede pulsar.
• Listas de seleccion: menu desplegable con hasta 10 opciones agrupadas en secciones.
• Mensajes de producto unico: ficha de un producto con imagen, precio y boton de compra.
• Mensajes de multiples productos: carrusel de hasta 30 productos de tu catalogo.

Ejemplo de envio de un mensaje con botones interactivos:

{
  "messaging_product": "whatsapp",
  "to": "34600000000",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": {
      "text": "Seleccionad una opcion:"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "btn_soporte",
            "title": "Soporte tecnico"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "btn_ventas",
            "title": "Informacion comercial"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "btn_estado",
            "title": "Estado de pedido"
          }
        }
      ]
    }
  }
}

Los mensajes interactivos aumentan la tasa de respuesta entre un 30 % y un 50 % respecto al texto plano, porque eliminan la friccion de escribir. Si quereis automatizar WhatsApp Business de forma eficaz, los mensajes interactivos son fundamentales.

Multimedia y catalogos

La Cloud API soporta el envio y recepcion de:

• Imagenes: JPEG, PNG (hasta 5 MB).
• Videos: MP4 (hasta 16 MB).
• Documentos: PDF, Word, Excel (hasta 100 MB).
• Audio: OGG, MP3 (hasta 16 MB).
• Ubicacion: coordenadas GPS con nombre y direccion.
• Contactos: tarjeta vCard con datos de contacto.

Ademas, podeis vincular un catalogo de productos de Meta Commerce y permitir que los usuarios naveguen vuestro catalogo directamente dentro de WhatsApp, sin salir de la conversacion. Esto es especialmente potente para e-commerce y empresas que usan WhatsApp para empresas como canal de venta directa.

Webhooks y notificaciones

Los webhooks son el mecanismo de comunicacion inversa: cuando un usuario envia un mensaje, cambia el estado de entrega o lee un mensaje, Meta envia una notificacion HTTP POST a la URL que hayais configurado.

Los eventos principales que podeis recibir:

• messages: mensaje entrante del usuario (texto, imagen, audio, ubicacion, etc.).
• statuses: cambio de estado de un mensaje enviado (sent, delivered, read, failed).
• errors: errores en el envio de mensajes.

Vuestro servidor debe responder con un 200 OK en menos de 5 segundos para que Meta considere el webhook procesado. Si fallais 5 veces consecutivas, Meta desactivara el webhook temporalmente.

Rate limits actuales de la Cloud API: el throughput base es de 80 mensajes por segundo, ampliable a 250 o mas solicitando un aumento a Meta. Para la mayoria de empresas en Espana, 80 msg/s es mas que suficiente. Si necesitais mas, consultad nuestra guia sobre WhatsApp marketing para empresas donde tratamos estrategias de envio masivo optimizado.

Preguntas Frecuentes

Que es WhatsApp Cloud API?

La WhatsApp Cloud API es la version de la WhatsApp Business API alojada directamente en los servidores de Meta. Permite a las empresas enviar y recibir mensajes de WhatsApp a traves de peticiones HTTP sin gestionar infraestructura propia. Meta se encarga del hosting, las actualizaciones y la escalabilidad, lo que reduce drasticamente los costes y la complejidad tecnica de implementacion.

Que es la API en la nube en WhatsApp?

Es el mismo concepto que la WhatsApp Cloud API. "API en la nube" es la traduccion literal del servicio que Meta ofrece como alternativa a la version On-Premise. En lugar de desplegar la API en vuestros servidores, os conectais a los servidores de Meta a traves de endpoints REST y webhooks. El resultado funcional es identico, pero sin la carga operativa del hosting.

Cuanto se paga por la API de WhatsApp?

El acceso a la WhatsApp Cloud API es gratuito. El coste viene por las conversaciones: Meta cobra por ventana de 24 horas, con precios que varian segun la categoria (servicio, utilidad, autenticacion, marketing) y el pais. En Espana, una conversacion de servicio cuesta aproximadamente 0,0311 EUR y una de marketing 0,0603 EUR. Las primeras 1.000 conversaciones de servicio cada mes son gratuitas. Tenemos un desglose completo en nuestro articulo de precios de WhatsApp API.

Cual es la diferencia entre WhatsApp Business y WhatsApp API?

WhatsApp Business es la aplicacion gratuita que descargais en el movil, pensada para autonomos y microempresas. Permite respuestas rapidas, catalogo basico y etiquetas. La WhatsApp Business API (incluyendo la Cloud API) es una interfaz de programacion sin aplicacion visual propia, disenada para empresas que necesitan multi-agente, automatizacion avanzada con chatbots o agentes IA, integracion con CRM y envio masivo. Son productos diferentes para escalas diferentes. Comparamos ambos en detalle en WhatsApp Business vs API.

Es posible usar WhatsApp Cloud API gratis?

Si, parcialmente. El acceso a la API no tiene coste. Ademas, Meta ofrece 1.000 conversaciones de servicio gratuitas al mes. Para pruebas, podeis usar el numero de telefono de sandbox que Meta proporciona sin coste. Sin embargo, para produccion con volumen real, pagareis por cada conversacion que supere la cuota gratuita y necesitareis verificacion de negocio completada.

Como afecta la Cloud API a la privacidad de datos?

Con la Cloud API, los mensajes pasan por los servidores de Meta. Meta cumple con el RGPD europeo y ofrece la opcion de almacenamiento de datos en la Union Europea para empresas que lo soliciten. Si la residencia de datos es un requisito critico para vuestra empresa (sector sanitario o financiero regulado), evaluad si la localizacion de los centros de Meta cumple con vuestra normativa sectorial.

Como GuruSup Mejora Tu WhatsApp Cloud API

Tener acceso a la WhatsApp Cloud API es el primer paso. Pero la API por si sola es una herramienta tecnica: endpoints, JSON, webhooks. Lo que la convierte en un canal de soporte productivo es lo que construis encima.

Funcionalidades Clave de GuruSup

GuruSup se integra directamente con la WhatsApp Cloud API y anade la capa de inteligencia que la API nativa no tiene:

• Agentes IA conversacionales que entienden el contexto del cliente, consultan vuestra base de conocimiento y resuelven consultas sin intervencion humana. No son chatbots de flujos rigidos: son agentes IA basados en LLM que mantienen conversaciones naturales.
• Panel multiagente donde vuestro equipo de soporte gestiona las conversaciones que el agente IA escala, con historial completo y contexto.
• Automatizacion inteligente de respuestas, enrutamiento y clasificacion de conversaciones. Los tickets se asignan automaticamente al departamento correcto.
• Analitica de resolucion con metricas de tasa de resolucion automatica, tiempo medio de respuesta y satisfaccion del cliente.

Como Empezar con GuruSup

La integracion con la WhatsApp Cloud API es directa: conectais vuestro numero de WhatsApp Business, configurais la base de conocimiento del agente IA y empezais a resolver consultas de forma autonoma en minutos.

Prueba GuruSup gratis y comprobad como un agente IA en WhatsApp puede resolver el 70 % de las consultas de vuestros clientes sin intervencion humana. Sin infraestructura propia, sin equipo DevOps, sin semanas de configuracion.

Solicitar demo gratuita de GuruSup