Objetivos de aprendizaje
Después de leer este artículo podrás:
- Entender qué es la API oficial de WhatsApp y qué exige
- Saber qué mensajes cobra Meta y cuáles son gratuitos
- Estimar el costo mensual y decidir cuándo conviene la API oficial
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 de plantilla entregado. La página oficial de precios no lista una mensualidad de la plataforma, solo el precio por mensaje.
Las plantillas (templates) son mensajes que Meta aprueba de antemano, y cada una pertenece a una de tres categorías:
| Categoría | Para qué sirve | Cuándo se cobra |
|---|---|---|
| Marketing | Promociones, ofertas, reactivación | Siempre que se entregue |
| Utilidad | Confirmación de pedido, estado de envío, recordatorio de pago | Fuera de la ventana de atención; dentro de ella es gratuita |
| Autenticación | Códigos de verificación (OTP) | Siempre que se entregue |
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.
¿Qué mensajes son gratuitos?#
Dos situaciones ponen el cobro en cero:
- Ventana de atención (24 horas). Se abre cuando el usuario te escribe. Mientras está abierta, los mensajes sin plantilla y las plantillas de utilidad son gratuitos. Pasadas las 24 horas, solo puedes enviar plantillas, y esas se cobran.
- Ventana de punto de entrada gratuito (72 horas). Aplica cuando el usuario llega por un anuncio Click to WhatsApp o por un botón de llamada a la acción de la Página de Facebook, desde la app móvil (escritorio y web no cuentan). Si respondes dentro de las 24 horas, se abre una ventana de 72 horas en la que todos los mensajes, plantillas incluidas, son gratuitos.
En la práctica, un bot de soporte donde el cliente siempre inicia la conversación cuesta poco o nada en tarifas de Meta. La cuenta crece 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 este artículo no fija un precio por mensaje: descarga la tarifa del trimestre actual y usa el cálculo de abajo.
El script estima el costo mensual. 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 };
// Mensajes ENTREGADOS por mes que se cobran.
// Utilidad enviada dentro de la ventana de 24 h es gratis: no la cuentes.
const volume = { marketing: 2000, utility: 1500, authentication: 800 };
let total = 0;
for (const [category, count] of Object.entries(volume)) {
const cost = count * rates[category];
console.log(`${category}: ${count} 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 1230,00 (en la moneda de la tarifa), de los cuales 1000,00 vienen de marketing. 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, MXN, ARS, CLP, COP y PEN. Revisa en qué moneda se factura tu cuenta, porque cada moneda tiene su propia tarifa.
- 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.
Hosting de bots
Tu bot en línea 24/7, con reinicio automático
Preguntas frecuentes
¿La API oficial de WhatsApp es de pago?
Sí, pero por uso. Desde el 1 de julio de 2025 Meta cobra cada mensaje de plantilla (template) entregado, con precio por categoría y país. La página de precios de Meta no lista una mensualidad de la plataforma. El texto libre dentro de la ventana de 24 horas no se cobra.
¿Qué mensajes son gratuitos en la API oficial?
Los mensajes sin plantilla enviados mientras la ventana de atención de 24 horas está abierta, y las plantillas de utilidad enviadas dentro de esa ventana. Si el cliente llega por un anuncio Click to WhatsApp o un botón de la Página de Facebook y respondes en 24 horas, se abre una ventana de 72 horas con todos los mensajes gratuitos.
¿Necesito un proveedor (BSP) para usar la API oficial?
No es obligatorio. Puedes usar la Cloud API directamente, con un portafolio comercial en Meta y un número comercial. Los proveedores ofrecen panel y soporte, con tarifa propia; revisa qué cobran además de Meta.
¿Puedo usar mi número personal en la API oficial?
No como número personal. La Cloud API exige un portafolio comercial y un número de teléfono comercial, que puede ser real o virtual.
¿Cuánto cuesta un mensaje de marketing?
Depende del país del destinatario y puede cambiar cada trimestre. Meta publica la tarifa por país y moneda (CSV y PDF) en su página de precios. Consúltala antes de calcular, porque las estimaciones de terceros difieren mucho entre sí.
Más en Bots
Ver los 33 artículos- ¿Cuánto cuesta hospedar un bot de Discord?El costo de hospedar un bot de Discord depende de la RAM, el tiempo en línea, la base de datos y los servicios externos. Aprende a estimar el tuyo.
- Correr un bot en el celular (Termux) o en tu PC vs hospedarloUn bot en tu PC o celular (Termux) se cae cuando el equipo se apaga, se suspende o pierde la red. Compara las tres opciones y cuándo sirve cada una.
- Cómo mantener tu bot de Discord en línea 24/7Para mantener un bot de Discord en línea 24/7, ejecuta el proceso en una máquina siempre encendida con reinicio automático. Compara PC, VPS con pm2 o systemd.
- Por qué tu bot de Discord se apaga o aparece offlineUn bot de Discord aparece offline cuando el proceso se cae, el token es inválido, falta una intent o se acaba la memoria. Diagnostica y corrige cada causa.