# 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

- 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 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_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.

## 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

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

- 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`](/es/errors#spend_cap_reached) hasta que cambie el mes o subas el tope. La reanudación es manual.

## Por la API

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

```bash
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"
```

```json
{
  "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`:

```json
{
  "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.
