Esportazioni

Ciele offre due tipi di esportazione. Un esportazione di Insights è un file di report relativo alle tue misure di Insights. Un'esportazione di Conversation contiene i record completi delle Conversation selezionate.

Crea un esportazione di Insights

Apri Insights.
Seleziona Exports.
Seleziona New export.
Digita un nome in Export name.
Imposta i filtri per il report: l'intervallo di date, l'Assistente, Aggregated, Feedback e Escalated.
Seleziona il tipo di esportazione.
Seleziona il tipo di file: CSV, JSON o XLSX.
Seleziona Create.

Ciele crea il file come processo in background. L'esportazione viene visualizzata nell'elenco con il suo nome, il tipo e il tipo di file. Quando lo stato è Ready, seleziona Download.

I filtri sono gli stessi della pagina Insights. Un'esportazione e la pagina Insights mostrano gli stessi numeri per gli stessi filtri.

Tipi di esportazione di Insights

Aggregated insights: ogni serie di grafici, con una riga per ogni giorno, settimana o mese.
Datapoints: le misure principali per l'intervallo, con una riga per ciascuna misura. Una misura senza dati per l'intervallo presenta una cella vuota.
Languages: il numero di Conversations per ciascuna lingua in cui i Visitor hanno scritto.

Shortcut button clicks viene visualizzato nell'elenco, ma non puoi selezionarlo. Ciele non registra ancora questi clic.

Download

Ciele verifica il tuo accesso ogni volta che scarichi un file. Ciele registra anche ogni download.

Contenuto dell'esportazione delle conversazioni

Ogni record di Conversation utilizza l'attuale formato di esportazione a 29 campi. Il record include informazioni su conversation, Assistant, visitor, session e outcome.

I dettagli del ragionamento dipendono dall'API-key o dal Role del membro. Un Role di livello inferiore non può richiedere il reasoning nascosto tramite un'opzione di esportazione.

Accesso tramite API e CLI

L'API accetta gli ID delle conversazioni selezionati in POST /api/v1/conversations/export.

La CLI può scrivere lo stesso formato di record su un file:

ciele conversations export <conversation-id> --out export.json

Anche lo strumento MCP read_inbox può richiedere un'esportazione. La sua azione di esportazione rimane disponibile in modalità di sola lettura di MCP.

Pianifica un'esportazione di Insights

In New export, abilita la pianificazione dopo aver selezionato il nome del report, i filtri, il tipo di esportazione e il tipo di file.

Scegli un giorno della settimana o un giorno del mese, un'ora in UTC e i destinatari tra i Members dell'Organization. L'interfaccia mostra anche il tuo orario locale.

I report settimanali coprono gli ultimi sette giorni completi in UTC. I report mensili coprono il mese di calendario precedente. Il giorno 31 utilizza l'ultimo giorno del mese quando necessario.

Exports elenca le pianificazioni e i relativi destinatari. Gli editor possono mettere in pausa, riprendere o eliminare una pianificazione. L'eliminazione di una pianificazione lascia intatti i file generati in precedenza.

Ogni slot in scadenza crea un normale job di esportazione. Dopo un periodo di inattività, il worker crea solo l'ultimo report saltato. Non riproduce ogni slot saltato.

I destinatari ricevono un'email quando il file è pronto. L'email contiene un link alla console e richiede l'accesso. Non contiene dati del report né allegati.

I membri che lasciano l'Organization vengono rimossi dagli elenchi dei destinatari. Una pianificazione senza destinatari rimanenti viene messa in pausa automaticamente.

Un'esportazione pianificata non riuscita genera un Alert operativo. La successiva esecuzione riuscita lo risolve. Gli errori di invio delle email generano un Alert separato.

Il worker autenticato deve svuotare gli export almeno ogni cinque minuti. Il worker Docker esterno supporta questa pianificazione su Vercel Hobby.

I client API gestiscono le pianificazioni in /api/v1/exports/schedules. MCP espone le azioni export-schedule tramite manage_configuration.