Guías
Costos de Meta
Cuánto cuesta WhatsApp: estimado vs oficial, pantalla de Costos, conversión de moneda, tope de gasto y GET /v1/usage/costs.
Messajo muestra cuánto cobra Meta por tus mensajes y puede pausar campañas cuando el gasto del mes llega al tope que definas. Los valores de los ejemplos de esta página son ilustrativos.
Qué cobra Meta
Sección titulada «Qué cobra Meta»- Solo WhatsApp tiene cobro. Instagram y Messenger no entran.
- El cobro es por mensaje entregado, por categoría (marketing, utilidad, autenticación, servicio) y país del destinatario.
sentno se cobra. - Los mensajes
free_*ypaid_exemptno entran en la cuenta. - La factura sale en la moneda de la cuenta de WhatsApp.
Estimado vs oficial
Sección titulada «Estimado vs oficial»- Estimado: se guarda al entregar. El precio sale, en este orden, del costo real de tu cuenta en el mismo mercado y categoría en los últimos 30 días (ya con descuento por volumen), de la tabla de precios descargada de Meta o de la tabla que viene en el repositorio. El origen queda guardado en cada mensaje (
calibrated,rate_cardoseed). - Oficial: valor aproximado que Meta informa por día. Messajo lo busca cada día a las 06:00 UTC, de los últimos 3 días. Los días son en UTC.
- La diferencia viene del descuento por volumen y del redondeo. El panel avisa cuando pasa de 10% en un día.
Pantalla de Costos
Sección titulada «Pantalla de Costos»En Costos eliges el período y la conexión y ves las tarjetas, el gráfico diario y las pestañas de desglose. Campaña y plantilla siempre son estimados. Aparece “sin estimación” cuando el destinatario no tiene teléfono, la moneda no tiene tabla o la categoría está fuera de la tabla.
Conversión de moneda
Sección titulada «Conversión de moneda»La conversión usa la cotización del BCE del día de cada gasto. FX_PROVIDER=none la desactiva. Una moneda que el BCE no cotiza no se convierte.
Tope de gasto
Sección titulada «Tope de gasto»- En Configuración → Costos el dueño o admin define un monto mensual por moneda, los porcentajes de aviso y si las campañas se pausan al 100%.
- El mes sigue la zona horaria de la organización.
- Con la pausa activada, las campañas en curso se pausan con motivo
spend_cap. Los envíos sueltos y de servicio siguen. - Iniciar o reanudar devuelve
409spend_cap_reachedhasta que cambie el mes o subas el tope. La reanudación es manual.
Por la API
Sección titulada «Por la API»GET /v1/usage/costs exige el permiso read. Parámetros: from, to, connection_id, currency y group_by.
curl -H "Authorization: Bearer $MESSAJO_API_KEY" \ "https://api.messajo.com/v1/usage/costs?from=2026-11-10&to=2026-11-11¤cy=BRL&group_by=day"{ "currency": "BRL", "items": [ { "key": "2026-11-10", "estimate": "37.5", "official": "36.92" }, { "key": "2026-11-11", "estimate": "12.25", "official": null } ]}message.status trae el campo cost:
{ "type": "message.status", "data": { "status": "delivered", "pricing": { "billable": true, "pricing_model": "PMP", "category": "marketing", "type": "regular" }, "cost": { "estimate": "0.35", "currency": "BRL", "rate_card_version": "2026-10" } }}cost viene solo en el estado que generó el cobro (delivered, o read si el delivered no llegó) y es null en los demás. estimate: null significa cobrada, sin estimación.