Entrega y tasa de apertura por período
Estadísticas de entrega y apertura/lectura agregadas en una ventana de fechas — de toda la organización o de una lista de campañas. Es la versión por período de Entrega y tasa de apertura por campaña: los mismos números, la misma lectura, respondiendo "cómo nos fue en septiembre" en vez de "cómo le fue a esta campaña".
start y end son YYYY-MM-DD y inclusivos en ambos extremos. La ventana
corre por insertedAt — cuándo entró el mensaje a la cola, que es lo que lo
ata a la campaña que lo disparó, y no cuándo respondió el proveedor.
Por canal y en total devuelve opened, delivered, accepted, failed,
queued, unconfirmed, attempted, sent, más deliveryRate (entregados /
attempted) y openRate (abiertos / entregados).
Dos cosas que conviene saber antes de leer las tasas:
deliveredya incluye lo que se abrió.delivery_statusguarda el estado más avanzado alcanzado, así que los conteos son disjuntos: quien leyó está enread, no endelivered. Este endpoint lo acumula por ti —deliveredaquí es entregado o mejor. Sumar los estados crudos a mano parte la tasa a la mitad.- Un proveedor que no confirma entrega se detiene en
sent. Eso no es "no entregado", es entrega sin confirmación: va aunconfirmedy queda fuera deattemptedy de ambas tasas. Hoy solo WhatsApp y email confirman entrega por webhook.sentes el total general que salió de la cola:attempted + unconfirmed.
Con groupBy=sequence también viene bySequence, una fila por campaña ordenada
por volumen, cada una con los mismos totales más su propio byChannel. Los
mensajes disparados fuera de campaña (envío directo/hub) vuelven en una fila con
sequence: null.
Nota: el conteo es por secuencia. Dos campañas que comparten el mismo
messageSequence se suman aquí.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Send your user token in the x-guper-authorization header.