WhatsApp Cloud API: una guía para principiantes sobre el nivel gratuito

La WhatsApp Cloud API suena intimidante, pero la idea central es simple: es la forma gratuita de alojar de Meta para enviar y recibir mensajes de WhatsApp desde tu propio software. Esta guía explica qué es, qué es realmente gratis y cómo enviar tu primer mensaje, sin la jerga.

Qué es en realidad la Cloud API

La WhatsApp Cloud API forma parte de la Plataforma de WhatsApp Business. En lugar de teclear mensajes en un teléfono, tus sistemas los envían y reciben de forma programática. Meta la aloja en la nube, así que no tienes que ejecutar ningún servidor de WhatsApp por tu cuenta: un cambio importante frente a la antigua API on-premise.

Impulsa las cosas que la app gratuita de WhatsApp Business no puede hacer:

• Confirmaciones de pedido, actualizaciones de envío y recordatorios automáticos.
• Una bandeja compartida donde varios agentes gestionan chats desde un solo número.
• Chatbots e integraciones con CRM/servicio de ayuda.
• Marketing a escala hacia usuarios con consentimiento.

Si solo necesitas chats entrantes desde un enlace, no necesitas esto: un enlace wa.me de nuestro generador gratuito de enlaces de WhatsApp es suficiente. La Cloud API es para la automatización y la escala.

Alojamiento gratuito frente a mensajería gratuita — no los confundas

Se mezclan dos "gratis" diferentes:

1. El alojamiento es gratis. A diferencia de la antigua API on-premise, Meta aloja la Cloud API sin costo. No hay servidores que alquilar.
2. La mensajería tiene un nivel gratuito más un uso de pago. WhatsApp factura por conversación (una ventana de 24 horas), con algunas conversaciones gratuitas y otras de pago según la categoría.

En 2025 llegó un gran cambio: las conversaciones de servicio iniciadas por el usuario pasaron a ser gratuitas — cuando un cliente te escribe y respondes dentro de la ventana de servicio, por lo general eso no se factura. Las categorías iniciadas por el negocio como marketing y (en muchos casos) utilidad/autenticación son de pago. Los límites y precios exactos cambian y varían según el país, así que confirma siempre las tarifas actuales en la documentación de precios de Meta en vez de fiarte de una cifra fija.

Las categorías de conversación en términos sencillos

La facturación gira en torno a las categorías de conversación:

• Servicio — el cliente inicia el chat; respondes dentro de una ventana de 24 horas. En gran parte gratis desde el cambio de 2025.
• Marketing — promocionas de forma proactiva (ofertas, lanzamientos). De pago, y requiere consentimiento + plantillas aprobadas.
• Utilidad — actualizaciones transaccionales ligadas a una acción (pedido enviado, recordatorio de cita). Usa plantillas; los precios varían.
• Autenticación — códigos de un solo uso y verificación. Usa plantillas.

La regla general: las respuestas de servicio iniciadas por el cliente son el carril barato/gratis; el marketing iniciado por el negocio es el carril de pago.

Mensajes de sesión frente a mensajes de plantilla

• Dentro de la ventana de servicio de 24 horas (después de que un usuario te escriba), puedes enviar mensajes de formato libre.
• Fuera de esa ventana, o para iniciar una conversación, debes enviar un mensaje de plantilla preaprobado. Las plantillas evitan que los negocios envíen spam en frío a los usuarios.

Qué necesitas para empezar

Para enviar tu primer mensaje configurarás:

1. Una cuenta de Meta (Facebook) Business.
2. Una app de la Plataforma de WhatsApp Business en el panel de desarrolladores de Meta.
3. Un número de teléfono registrado en la plataforma (para empezar se proporciona un número de prueba).
4. Credenciales de API — un token y el ID de tu número de teléfono.

Meta proporciona un número de prueba y un pequeño margen para que experimentes antes de salir en vivo.

Enviar tu primer mensaje (la forma que tiene)

Una vez configurado, enviar es una petición HTTP a la Graph API de Meta. Conceptualmente:

POST https://graph.facebook.com/v22.0/${PHONE_NUMBER_ID}/messages
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "972541234567",
  "type": "text",
  "text": { "body": "Hello from the Cloud API!" }
}

Para escribir a alguien que no te ha contactado primero, cambia type: "text" por un mensaje de template que haga referencia a una plantilla aprobada. Sustituye ${PHONE_NUMBER_ID} y ${ACCESS_TOKEN} por tus propios valores, y ten en cuenta que la versión de la API (v22.0 aquí) cambia con el tiempo.

Recibir mensajes: webhooks

Los mensajes entrantes llegan mediante un webhook — una URL que tú alojas y que Meta llama cada vez que un usuario te escribe. Verificas el webhook una vez y luego Meta le envía los eventos de mensajes. Así es como los bots y las bandejas compartidas "escuchan" a los clientes.

¿Debería usarla un principiante?

Hazte dos preguntas:

• ¿Necesito automatización o una bandeja de equipo? Si no, quédate con la app gratuita de WhatsApp Business.
• ¿Estoy enviando a escala a usuarios con consentimiento? Si sí, la Cloud API es la vía conforme a las normas.

Muchos pequeños negocios llegan a la Cloud API a través de un proveedor de soluciones empresariales (como Twilio, 360dialog o MessageBird) o de una herramienta sin código, que oculta la mayor parte de la API en crudo. Para una ruta sin código, consulta Automatiza WhatsApp con Zapier y Make, y para planificar costos, precios de la API de WhatsApp Business.

Conclusiones clave

• El alojamiento es gratis; la mensajería tiene un nivel gratuito más categorías de pago.
• Las conversaciones de servicio iniciadas por el usuario son en gran parte gratuitas desde 2025.
• Marketing/utilidad/autenticación usan plantillas aprobadas y suelen ser de pago.
• Los principiantes sin necesidades de automatización no necesitan la API en absoluto: un enlace wa.me cubre los chats entrantes.

Empieza sencillo con un enlace gratuito de WhatsApp y da el salto a la Cloud API cuando la automatización lo exija.