Passa al contenuto principale

Elenca storico invii

GET 
/api/partner-gateway/v1/messages/history

Restituisce un elenco paginato dei messaggi inviati per il canale e l'intervallo di date indicati, permettendoti di consultare l'intero storico degli invii con filtri flessibili. Usa questo endpoint quando devi rivedere gli invii passati, verificare le performance di consegna in una finestra temporale o costruire dashboard e report sui tassi di consegna dei messaggi. Il parametro channel è obbligatorio e limita i risultati a un singolo canale di messaggistica (SMS, RCS o WHATSAPP). Per ottenere lo storico su più canali, effettua una richiesta separata per ciascun canale. I parametri from e to definiscono l'intervallo di date di invio (estremi inclusi) e sono obbligatori. Formati accettati: una data sola (2025-01-15, che indica l'intera giornata in UTC: 00:00:00Z come from, 23:59:59Z come to), una data-ora senza offset (2025-01-15T10:30:00, interpretata come UTC) oppure una data-ora ISO-8601 completa con offset (2025-01-15T00:00:00+01:00 o 2025-06-15T23:59:59Z). Ricorda di codificare in percent-encoding il segno + dell'offset come %2B: un + non codificato viene decodificato come spazio. Un valore che non rispetta nessuno di questi formati, o un from successivo a to, riceve in risposta un 400 con un messaggio che indica il parametro e i formati accettati. Il parametro opzionale status ti permette di filtrare per uno specifico stato di consegna: ACCEPTED, REJECTED, DELIVERED, EXPIRED, DELETED, UNDELIVERABLE, ERROR, DISABLED, UNSUPPORTED, CONVERSATION_CLOSED o UNKNOWN. Quali possono comparire dipende dal canale — vedi la tabella Stati di Consegna nella panoramica dell'API. Ometti questo parametro per restituire i messaggi in tutti gli stati. La paginazione è controllata dai parametri page e limit. Le pagine partono da 0 (la prima pagina è page=0). La dimensione di pagina predefinita è 20 se limit non è specificato. Per scorrere tutti i risultati, incrementa il parametro page finché la risposta non restituisce meno elementi del limit richiesto, il che indica che hai raggiunto l'ultima pagina. La risposta è un array JSON di oggetti DeliveryStatusResponse, che può essere vuoto se nessun messaggio corrisponde ai filtri indicati. Per intervalli di date ampi con molti messaggi, valuta l'uso dell'endpoint di esportazione (POST /partner-gateway/v1/messages/history/export) per generare un file CSV scaricabile invece di paginare tra migliaia di risultati. Risposte di errore: 400 per un channel, from o to mancante o malformato; 500 indica un errore imprevisto lato server; riprova dopo una breve attesa.

Richiesta​

Risposte​

Lista dei messaggi inviati (può essere vuota)

Ultimo aggiornamento il