API oficial de WhatsApp: qué es y cuánto cuesta

La API oficial de WhatsApp es la interfaz que Meta mantiene para que las empresas envíen y reciban mensajes desde código. Su nombre técnico es WhatsApp Business Platform, y la forma más común de usarla es la Cloud API, alojada por la propia Meta.

No hay un precio único: depende de la categoría del mensaje, del país del destinatario y de quién inició la conversación. Meta puede cambiar precios y reglas cada trimestre, así que consulta la página oficial antes de calcular.

¿Qué es la API oficial de WhatsApp y qué exige?#

Es la forma autorizada de automatizar WhatsApp para negocios. No vinculas un celular ni escaneas un código QR: llamas a la Graph API de Meta con un token para enviar, y recibes mensajes y estados de entrega por webhook (una URL pública con HTTPS válido).

Los requisitos, según la documentación de la Cloud API:

• un portafolio comercial en Meta;
• un número de teléfono comercial, real o virtual;
• un servidor propio para recibir los webhooks.

Al empezar, Meta crea una cuenta y un número de prueba, que envían plantillas sin pedir método de pago. En producción, cada número tiene un límite predeterminado de mensajes por segundo y un ritmo máximo de envío al mismo usuario; los valores actuales están en la documentación de la Cloud API. Para compararla con las librerías no oficiales, mira Baileys, whatsapp-web.js o API oficial.

¿Qué cobra Meta?#

Desde el 1 de julio de 2025, el cobro es por mensaje entregado. La página oficial de precios no lista una mensualidad de la plataforma, y Meta no cobra los mensajes que el usuario te envía.

Cada mensaje que envía la empresa cae en una categoría. Tres son plantillas (templates), mensajes que Meta aprueba de antemano y que pueden salir en cualquier momento; la cuarta es la respuesta libre, sin plantilla:

El valor depende de la categoría y del código de país del destinatario. Utilidad y autenticación tienen tramos de volumen: cuanto más envías, menor el precio. Marketing no los tiene. Las respuestas de Meta Business Agent, el agente de IA de la propia Meta, forman una categoría aparte que se cobra por tokens.

¿Qué mensajes son gratuitos?#

La ventana de atención de 24 horas se abre cuando el usuario te escribe, y cada nuevo mensaje suyo reinicia el reloj. Con ella abierta puedes responder con texto libre; cerrada, solo con plantillas. La ventana define qué puedes enviar, pero desde octubre de 2026 ya no deja la cuenta en cero por sí sola.

Dos situaciones siguen siendo gratis:

1. Tramo gratuito de servicio. Cada número comercial tiene 1000 mensajes de servicio gratuitos al mes. Lo que no usas no se acumula, y el cobro empieza en el mensaje 1001.
2. Ventana de punto de entrada gratuito. Cuando el usuario llega por un anuncio Click to WhatsApp, desde la app de Android o iOS (escritorio y web no cuentan), y respondes dentro de la ventana de atención, esa respuesta no se cobra y abre una ventana que puede durar hasta 7 días. Mientras está abierta, los mensajes de marketing, utilidad, autenticación y servicio son gratuitos.

En la práctica, un bot de soporte pequeño, donde el cliente siempre inicia la conversación, puede caber entero en el tramo gratuito. La cuenta crece cuando las respuestas pasan de 1000 al mes o cuando es la empresa la que inicia el contacto.

¿Cómo estimar el costo mensual?#

Meta publica la tarifa por país y moneda, en CSV y PDF, en su página de precios. Solo modifica precios el 1 de enero, abril, julio u octubre, con al menos un mes de aviso. Por eso aquí no aparece ningún precio por mensaje: descarga la tarifa del trimestre actual y usa el cálculo de abajo.

El script estima el costo mensual de un número. Completa rates con los valores de la tarifa oficial; los del ejemplo son ficticios, solo para que el cálculo corra.

// node estimate.js
// ATENCIÓN: tarifas ficticias. Cámbialas por los valores de la tarifa oficial de Meta.
const rates = { marketing: 0.5, utility: 0.1, authentication: 0.1, service: 0.05 };

// Mensajes ENTREGADOS por mes en un número comercial.
// No cuentes los enviados en una ventana de punto de entrada gratuito.
const volume = { marketing: 2000, utility: 1500, authentication: 800, service: 3000 };
const FREE_SERVICE = 1000; // mensajes de servicio gratuitos por mes, por número

let total = 0;
for (const [category, count] of Object.entries(volume)) {
  const billed = category === "service" ? Math.max(0, count - FREE_SERVICE) : count;
  const cost = billed * rates[category];
  console.log(`${category}: ${billed} x ${rates[category].toFixed(2)} = ${cost.toFixed(2)}`);
  total += cost;
}
console.log(`Total estimado: ${total.toFixed(2)} por mes`);

Con esos números ficticios el total sería 1330,00 (en la moneda de la tarifa). Marketing aporta 1000,00; las 3000 respuestas de servicio cuestan solo 100,00, porque las primeras 1000 son gratis. Eso es lo que muestra el cálculo: marketing suele dominar el total, así que reducir los envíos promocionales baja el costo más que cualquier otro ajuste. Y solo cuenta el mensaje entregado.

¿Qué costos ocultos hay?#

• Proveedor (BSP). No estás obligado a usar uno, pero muchos ofrecen panel, bandeja de entrada y soporte. Revisa si cobran mensualidad o un margen sobre el precio de Meta y pide la tarifa completa antes de contratar.
• Servidor. El webhook necesita una aplicación siempre en línea. Es un costo pequeño, pero real.
• Moneda. Meta publica tarifas en varias monedas, entre ellas USD, EUR, BRL, MXN, ARS, CLP, COP y PEN, cada una con su propia tarifa. La moneda se elige al crear la cuenta de mensajería y no se puede cambiar después (Meta ofrece una API de migración de moneda), así que revisa cuál usa tu cuenta.
• Aprobación de plantillas. Una plantilla rechazada retrasa las campañas; el costo es el tiempo de tu equipo.

¿Cuándo conviene la API oficial?#

Conviene cuando el número es de un negocio que no puede quedar fuera de servicio: atención al cliente, ventas, notificaciones de pedidos, códigos de verificación. El costo por mensaje es predecible y evitas el riesgo de bloqueo del número que traen los clientes no oficiales.

No conviene cuando el proyecto es personal o de estudio, o cuando debe funcionar en un número que no puede volverse comercial. En esos casos, las librerías no oficiales cuestan solo el servidor, pero traen el riesgo de bloqueo y de fallas sin aviso. La decisión de fondo está en el comparativo Baileys, whatsapp-web.js o API oficial, y la implementación paso a paso en cómo hacer un bot de WhatsApp.

Para envíos masivos, la cuenta de marketing pesa y la calidad de las plantillas importa. Si el bot debe estar en línea todo el tiempo, mira también cómo alojar un bot de WhatsApp 24/7.

Cómo hacerlo en Square Cloud#

Fuera de las tarifas de Meta, lo que queda es alojar el servidor que recibe el webhook. Square Cloud es hosting self-service: tú haces el deploy y controlas memoria, variables y reinicios desde el panel. Soporta la Cloud API oficial, además de Baileys, WPPConnect y whatsapp-web.js. Meta sigue cobrando los mensajes; el hosting es un costo aparte.

Para el webhook, la aplicación web recibe un subdominio squareweb.app con HTTPS, que puede servir como URL de callback. Los contenedores están siempre encendidos, sin modo de suspensión, con reinicio automático (activado por defecto en el deploy desde el panel) cuando el proceso termina con error.

Todos los planes son de pago y se cobran en reales. El Hobby cuesta R$12,49 al mes, con 1 GB de RAM compartido entre tus aplicaciones (mínimo de 512 MB por aplicación web). Puedes hacer el deploy por ZIP, CLI, GitHub o la extensión de VS Code. Los detalles están en la página de hosting de bots de WhatsApp.