Ir al contenido

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.

  • 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. sent no se cobra.
  • Los mensajes free_* y paid_exempt no entran en la cuenta.
  • La factura sale en la moneda de la cuenta de WhatsApp.
  • 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_card o seed).
  • 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.

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.

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.

  • 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 409 spend_cap_reached hasta que cambie el mes o subas el tope. La reanudación es manual.

GET /v1/usage/costs exige el permiso read. Parámetros: from, to, connection_id, currency y group_by.

Ventana de terminal
curl -H "Authorization: Bearer $MESSAJO_API_KEY" \
"https://api.messajo.com/v1/usage/costs?from=2026-11-10&to=2026-11-11&currency=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.