Analytics

KPI aggregati, trend giornalieri e top template da pannello e API.

La sezione Analytics del pannello visualizza volume invii, aperture, clic e performance dei template. Sotto chiama endpoint analytics protetti da JWT (non disponibili solo con API key).

Endpoint

Endpoint	Restituisce
`GET /analytics/summary`	KPI aggregati del tenant (inviati, consegnati, aperti, clic, bounce)
`GET /analytics/daily`	Serie temporale per giorno
`GET /analytics/top-templates`	Template ordinati per invii o engagement

Esempio summary

GET /analytics/summary?from=2026-06-01&to=2026-06-30
Authorization: Bearer <accessToken>
X-Tenant-Id: clxxxxxxxx

La risposta tipica include conteggi e tassi del periodo. Lo schema esatto e nella reference OpenAPI.

Trend giornalieri

GET /analytics/daily?from=2026-06-01&to=2026-06-30

Utile per grafici del pannello o reporting proprio con proxy JWT lato server.

Top template

GET /analytics/top-templates?limit=10&from=2026-06-01&to=2026-06-30

Identifica quali template pubblicati generano piu engagement.

Pannello vs API

Pannello — grafici pronti, selettore date, senza codice
API — export verso BI; richiede token sessione admin

Per log per messaggio (programmatico), usa GET /emails/logs con API key con scope email:read.