Analytics API

Los endpoints de analitica devuelven metricas de envio agregadas de tu tenant. Usan la sesion JWT del panel (con scope de tenant) — no se exponen por scopes de API key.

Todos aceptan un parametro opcional ?days (por defecto 30, tope 90) y excluyen los logs eliminados por retencion.

Resumen

GET /analytics/summary?days=30

Devuelve totales y tasas del periodo:

{
  "period": { "days": 30, "since": "...", "until": "..." },
  "totals": { "total": 0, "sent": 0, "opened": 0, "clicked": 0, "bounced": 0, "complained": 0, "failed": 0 },
  "rates": { "openRate": 0, "clickRate": 0, "bounceRate": 0, "complaintRate": 0 }
}

sent cuenta SENT + DELIVERED; las tasas son porcentajes redondeados a un decimal.

Serie diaria

GET /analytics/daily?days=30

Devuelve un bucket por dia (rellenado a cero) para graficas:

{ "days": 30, "daily": [{ "date": "2026-07-01", "sent": 0, "opened": 0, "clicked": 0, "bounced": 0 }] }

Top plantillas

GET /analytics/top-templates?days=30

Devuelve las 10 plantillas con mas volumen de envio:

{ "top": [{ "id": "...", "name": "...", "subject": "...", "sent": 0, "opened": 0, "clicked": 0 }] }

Ver Estados de email para saber que cuenta cada contador.