Passa al contenuto principale

Esporta lo storico invii come CSV

POST 
/api/partner-gateway/v1/messages/history/export

Accoda un'esportazione CSV asincrona dei messaggi inviati tramite API nell'intervallo di date indicato. Questo endpoint è pensato per scenari di estrazione massiva di dati e di reportistica in cui paginare attraverso l'endpoint di elenco dello storico sarebbe poco pratico. L'esportazione copre tutti i canali (SMS, RCS, WhatsApp) in un unico file, quindi non devi richiedere esportazioni separate per ciascun canale. Sono inclusi solo i messaggi inviati tramite API; i messaggi inviati tramite altre interfacce (come gli strumenti per le campagne o la console web) sono esclusi. Il corpo della richiesta richiede startDateTime e endDateTime come stringhe ISO-8601 OffsetDateTime (ad esempio: 2025-01-01T00:00:00+01:00). Puoi facoltativamente filtrare per mittente o destinatario. Questo endpoint restituisce subito HTTP 202 Accepted, a indicare che il job di esportazione è stato messo in coda ma non è ancora completato. L'esportazione viene eseguita in modo asincrono in background e può richiedere da pochi secondi a diversi minuti, a seconda del volume di dati nell'intervallo di date richiesto. Per verificare lo stato della tua esportazione e recuperare l'URL di download quando è pronta, interroga l'endpoint GET /partner-gateway/v1/exports. Quell'endpoint indicherà se l'esportazione è ancora in corso, completata (con un link di download) o fallita. Il file CSV generato include colonne per ID messaggio, canale, destinazione, stato di consegna, data di invio, data di consegna e altri metadati rilevanti. Errori comuni: richiedere intervalli di date molto ampi (mesi di dati) può comportare tempi di elaborazione lunghi. Se ti serve solo un sottoinsieme dei dati, valuta di restringere l'intervallo di date o di usare invece l'endpoint della lista paginata (GET /partner-gateway/v1/messages/history). Risposte di errore: viene restituito 400 se il corpo della richiesta è malformato o mancano campi obbligatori. 500 indica un errore imprevisto lato server; riprova dopo una breve attesa.

Richiesta​

Risposte​

Lavoro di esportazione accodato

Ultimo aggiornamento il