Esportazioni Asincrone

I grandi set di dati (contatti, report di consegna, cronologia messaggi) vengono esportati in modo asincrono. L'API restituisce un riferimento al job che puoi interrogare 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 un ID di esportazione. 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.
• EXPIRED -- Il link di download è scaduto (puoi rigenerarlo).

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

Puoi filtrare per canale, intervallo di date e stato di consegna prima di esportare.

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.