Analítica
GET /analytics requiere emails:read. Devuelve agregados del workspace separados por producto; no es una muestra del listado de emails ni tiene paginación.
curl "$SENDIRO_API_BASE/v1/workspaces/$SENDIRO_WORKSPACE_ID/analytics?period=last_7_days&mode=provider" \
-H "Authorization: Bearer $SENDIRO_API_KEY"Selecciona el período
period admite all_time (predeterminado), last_7_days, last_30_days, current_month y custom. Con custom, aporta from y to como YYYY-MM-DD; ambos días se incluyen en UTC. No envíes esas fechas con otros períodos.
Últimos 7 o 30 días incluye hoy UTC y los 6 o 29 días anteriores. Este mes empieza el día 1 UTC y termina al finalizar el día UTC actual.
La fecha de selección es acceptedAt. Una apertura posterior sigue contando si pertenece a un email aceptado dentro del período. La respuesta indica scope, dateBasis: "acceptedAt", timezone: "UTC", filtros efectivos y range con inicio inclusivo y fin exclusivo.
Filtra modo y contexto
mode admite all (predeterminado), provider o simulation. Puedes añadir un solo contexto: broadcastId, automationId o emailId. Combinar varios, repetir parámetros o enviar filtros desconocidos devuelve error.
El permiso emails:read permite consultar ambos productos del workspace. Un contexto de Marketing no cambia la cuota de Transactional ni el mes original de las reservas.
Lee las métricas
Aceptación de Sendiro, aceptación del transporte, entrega y observaciones de interacción son etapas distintas. Una entrega no garantiza bandeja principal; aperturas y clics pueden depender de privacidad y precarga de los clientes de correo. Un resultado incierto no equivale a fallo conocido.
Una selección vacía produce ceros; una consulta fallida es indisponibilidad y debe mostrarse como tal. Para investigar un mensaje usa su detalle y eventos.
La salud de recepción y recuperación de eventos requiere sesión humana; no se ofrece a claves en /analytics/health ni /provider-events. Consulta analítica de Marketing.