Esportazioni Asincrone

I grandi set di dati (contatti, report di consegna, cronologia messaggi) vengono esportati in modo asincrono. L'API mette in coda un job che puoi seguire con GET /exports fino a quando l'esportazione è pronta per il download.

Workflow di esportazione

1. Richiedi esportazione  →  2. Controlla stato  →  3. Scarica file

Passaggio 1: Richiedi un'esportazione

Scegli il tipo di esportazione di cui hai bisogno:

Tipo di esportazione	Endpoint
Contatti	POST /exports/contacts
Report di consegna	POST /exports/delivery-reports
Cronologia messaggi (CSV)	POST /messages/history/export

L'API risponde immediatamente con 202 Accepted e corpo vuoto. La generazione effettiva del file avviene in background.

Passaggio 2: Controlla il completamento

GET /exports

Elenca le tue esportazioni e controlla il loro stato. Ogni esportazione mostrerà uno di:

• PENDING -- L'esportazione è in fase di generazione.
• COMPLETED -- Il file è pronto per il download.
• FAILED -- Non è stato possibile generare l'esportazione; richiedila di nuovo.

Un'esportazione completata resta scaricabile fino a expiresAt. Dopo quella data isAvailableForDownload diventa false e puoi rigenerarla.

Passaggio 3: Scarica il file

Una volta che lo stato dell'esportazione è COMPLETED:

GET /exports/{exportId}

Questo restituisce un URL di download. Usalo per scaricare il file esportato.

Rigenerare esportazioni scadute

I link di download scadono dopo un periodo di tempo. Se il tuo link è scaduto, rigeneralo:

POST /exports/{exportId}

Questo crea un nuovo URL di download per gli stessi dati esportati.

Esportazione cronologia messaggi

La cronologia messaggi ha un endpoint di esportazione separato che produce un file CSV:

POST /messages/history/export

Il corpo della richiesta riceve un intervallo di date, startDateTime e endDateTime (ISO 8601 con offset, ad esempio 2026-01-01T00:00:00+01:00), e i filtri facoltativi sender e recipient. L'esportazione copre SMS, RCS e WhatsApp in un unico file; non esiste un filtro per canale o per stato di consegna. L'API risponde 202 Accepted con corpo vuoto: segui l'esportazione con GET /exports come sopra.

Per sfogliare la cronologia messaggi senza esportare, usa:

GET /messages/history

Questo restituisce risultati paginati con filtri per canale, intervallo di date e stato.

Riferimento rapido

Azione	Endpoint
Esporta contatti	POST /exports/contacts
Esporta report di consegna	POST /exports/delivery-reports
Esporta cronologia messaggi	POST /messages/history/export
Elenco esportazioni	GET /exports
Ottieni link download	GET /exports/{exportId}
Rigenera link scaduto	POST /exports/{exportId}
Sfoglia cronologia messaggi	GET /messages/history

Consulta il Riferimento API Esportazioni e il Riferimento API Cronologia Messaggi per tutti i dettagli.