Suite | Growth, Professional, Enterprise, or Enterprise Plus |
Support | Professional or Enterprise |
Puoi esportare i dati dell’account, quali ticket, utenti o organizzazioni, in un file JSON, CSV o XML. Se vuoi esportare solo i dati relativi ai membri del team (agenti e amministratori), consulta Esportazione dei dati dei membri del team.
Gli strumenti di esportazione descritti in questo articolo non sono disponibili con i piani Team. Tuttavia, i clienti con tutti i piani Zendesk possono usare l'API REST di Zendesk per esportare i dati, come descritto in questo articolo.
Per motivi di sicurezza, puoi limitare gli utenti che possono esportare i dati. Puoi anche disattivare l’esportazione dei dati nel tuo account, se è stata abilitata da Zendesk. Consulta Come limitare o disattivare l’esportazione dei dati dell’account.
Esportazione dei dati dell’account
Gli amministratori Zendesk possono esportare i dati degli account, come ticket, utenti o organizzazioni, in file JSON, CSV o XML. Consulta Informazioni sulle opzioni di esportazione dei dati per verificare quali tipi di dati dell’account possono essere esportati da ciascun tipo di file.
Per esportare i dati di ticket, utenti o organizzazioni dall'account
- Se non l’hai già fatto, chiedi a Zendesk di abilitare l’esportazione dei dati nel tuo account.
Il proprietario dell’account deve contattare l’assistenza clienti Zendesk per abilitare l’esportazione dei dati nell’account. Assicurati di includere il nome del tuo sottodominio Zendesk Support nella richiesta.
Torna a questo passaggio una volta abilitate le esportazioni dei dati nel tuo account.
-
Nel Centro amministrativo, fai clic su Account
nella barra laterale, quindi seleziona Strumenti > Report.
Se non vedi questa opzione ma l'esportazione dei dati è abilitata nel tuo account, potresti avere delle limitazioni nell'esportazione dei dati. Consulta Limitazione delle esportazioni dei dati a determinati amministratori.
Se necessario, fai clic sulla scheda Esporta per visualizzare le opzioni di esportazione di dati. In alcune versioni legacy di Zendesk, le opzioni di esportazione sono visualizzate in una scheda distinta.
- Seleziona un'opzione di esportazione.
-
Esportazione JSON: consigliata per gli account con più di 200.000 ticket. Non disponibile nelle istanze sandbox.
Per eseguire un’esportazione JSON, seleziona un intervallo di date, seleziona i ticket, gli utenti o le organizzazioni e fai clic su Esporta.
Per maggiori informazioni, consulta Esportazione JSON completa.
-
Esportazione CSV: Non disponibile nelle istanze sandbox.
Per eseguire un’esportazione CSV, seleziona un intervallo di date e fai clic su Esporta.
Per maggiori informazioni, consulta Esportazione CSV.
-
Esportazione XML:
Per eseguire un’esportazione XML, seleziona il file di richiesta accanto a ciascuna opzione. L’impostazione di un intervallo di date o la selezione di un tipo di dati non sono disponibili.
Per maggiori informazioni, consulta Esportazione XML completa ed Esportazione XML utente.
Nota: Se si verifica un errore durante il processo di esportazione, modifica il periodo di tempo e riprova. -
Esportazione JSON: consigliata per gli account con più di 200.000 ticket. Non disponibile nelle istanze sandbox.
export_YYYY_MM_DD_uniqueID_X
, dove:-
YYYY
è l’anno -
MM
è il mese -
DD
è il giorno -
uniqueID
viene generato automaticamente ed è univoco per un’esportazione -
X
è un valore numerico correlato al numero di file nel file zip. Se il file zip contiene un solo file, quest’ultimo termina con_1
; se sono presenti due file, i file terminano con_1
e_2
; ecc. I numeri alla fine del file non sono correlati all'ordine dei dati all'interno dei file.
A seconda dell'intervallo di date richiesto e del livello di attività dei ticket dell'account, il processo di esportazione può richiedere da pochi minuti a un giorno o più. In caso di dubbi su una particolare esportazione che stai aspettando, contatta l’assistenza clienti Zendesk.
Se non hai ricevuto la notifica email, puoi fare clic su più recenti accanto a Esportazione JSON completa, Esportazione CSV, Esportazione XML completao Esportazione XML utenti per scaricare l’ultimo report generato. Il report più recente visualizza i dati dell'account contenuti nell'ultimo file richiesto e non i dati dell'account correnti. Consulta Ritardi nella ricezione dell'email con il file di esportazione dei dati scaricabili.
Opzioni di esportazione dei dati
Sono disponibili le seguenti opzioni di esportazione dei dati:
Esportazione JSON completa
Esporta ticket, utenti o organizzazioni in file JSON. Gli account con oltre un milione di ticket vengono scaricati con incrementi di 31 giorni.
name
e deleted_at
. Zendesk esporta i dati nel formato “NDJSON” o JSON delimitato da nuova riga. Questo formato consente ai sistemi di inviare in flusso gli oggetti JSON uno alla volta anziché leggere l’intero file in una volta sola. Questo è utile nel caso di file di esportazione di grandi dimensioni, che potrebbero risultare eccessivi per i lettori JSON tradizionali.
Se preferisci un singolo file JSON contenente tutte le tue informazioni anziché una versione streaming, puoi racchiudere gli oggetti ticket in un array JSON. Ad esempio, se Zendesk esporta i seguenti oggetti ticket:
{"ticket":{"id":....}}
{"ticket":{"id":....}}
{"ticket":{"id":....}}
Puoi creare un file JSON valido racchiudendo gli oggetti in un array "ticket" come mostrato di seguito:
{
"tickets": [
{"ticket": {"id":....}},
{"ticket": {"id":....}},
{"ticket": {"id":....}}
]
}
Gli intervalli di date per queste esportazioni usano un timestamp generato dal sistema. In genere, questi timestamp corrispondono all'aggiornamento più recente registrato nel ticket, nell’utente o nell’organizzazione (non alla data di creazione). In alcuni casi, gli aggiornamenti di sistema non generano eventi ticket. In questi casi, è possibile che l'output includa alcuni ticket imprevisti.
- Un file JSON contenente tutti i ticket esportati, inclusi i ticket che hanno superato il limite di 1 MB e sono stati esportati senza commenti.
- Un file JSON contenente i ticket che hanno superato il limite di 1 MB e un messaggio di errore indicante che i commenti non sono stati inclusi in quanto il ticket ha superato il limite di 1 MB. Esempio:
Esportazione CSV
Esporta i dati dei ticket in file CSV. I dati non includono ticket eliminati, commenti ai ticket o descrizioni di ticket.
Se un singolo ticket contiene più di 1 MB di dati, viene escluso dal report. Tuttavia, questo accade di rado, perché le esportazioni CSV non includono i commenti al ticket, che in genere sono il componente di dati più grande in un ticket.
Tutti i valori di data e ora vengono convertiti nel fuso orario predefinito dell’account (al momento dell’esportazione). Le date visualizzate nel file CSV potrebbero non corrispondere alle date riportate nell’esportazione JSON (UTC) o in Explore, visualizzate nel fuso orario dell’utente. Per ulteriori informazioni sul fuso orario di un account, consulta Impostazione del fuso orario e del formato per Zendesk Support.
Il periodo di tempo per questa esportazione usa un timestamp generato dal sistema.
I dati dei ticket nel report includono i dati mostrati nella tabella seguente. I campi di testo su più righe e a selezione multipla, così come i campi data personalizzati, sono esclusi dalle esportazioni CSV, ma possono essere inclusi nei report JSON e XML.
Dati | Descrizione |
---|---|
ID | Il numero di ticket. |
Requester | Il nome del richiedente. |
Requester ID | Il numero ID del richiedente. |
Requester external id | L'ID di un sistema esterno. Facoltativo per gli account per i quali Single Sign-On Professional o Enterprise viene abilitato usando JWT o SAML. |
Requester email | L'indirizzo email principale del richiedente. Se vuoi esportare un elenco di indirizzi email secondari degli utenti, devi usare l’endpoint API Elenca utenti durante il caricamento laterale delle identità (esempio: |
Dominio richiedente | Il dominio email dell'indirizzo email principale del richiedente. |
Submitter | Il nome del mittente iniziale. Il nome del richiedente viene visualizzato se il richiedente ha inviato il ticket. Se un agente ha inviato il ticket per conto del richiedente, viene usato il nome dell'agente. Se il richiedente viene modificato, il mittente non cambia. |
Assegnatario | L'assegnatario al momento dell'esportazione. |
Group | Il gruppo al momento dell'esportazione. |
Subject | L’oggetto del ticket. |
Tags | I tag aggiunti al ticket al momento dell'esportazione. |
Status | Lo stato al momento dell'esportazione. |
Priority | La priorità al momento dell'esportazione. |
Via | Il canale ticket da cui è stato originato il ticket. |
Ticket type | Il tipo al momento dell'esportazione. |
Created at | L'ora e la data di creazione originali. Vengono visualizzate nel fuso orario dell’account. |
Data/ora di aggiornamento | L'ora e la data dell'aggiornamento più recente. Vengono visualizzate nel fuso orario dell’account. |
Data/ora assegnazione | La data e l’ora dell'ultima assegnazione a un agente (ad esempio, l'ora dell’assegnazione all'assegnatario corrente). Vengono visualizzate nel fuso orario dell’account. |
Organizzazione | L’organizzazione del richiedente attuale (se presente). |
Scadenza | La data di scadenza al momento dell'esportazione. Vengono visualizzate nel fuso orario dell’account. |
Data/ora assegnazione iniziale | L'ora e la data della prima assegnazione a un agente (non a un gruppo). Vengono visualizzate nel fuso orario dell’account. |
Data/ora soluzione | La data e l’ora del passaggio finale o più recente allo stato Risolto. Vengono visualizzate nel fuso orario dell’account. |
Tempo di soluzione | Il tempo di soluzione finale o più recente in ore, arrotondato all'ora intera. |
Satisfaction Score | Lo stato corrente della valutazione della soddisfazione (Non offerta, Offerta, Positiva o Negativa). |
Group stations | Il numero di modifiche apportate alle assegnazioni di gruppi. Anche l'assegnazione iniziale alla creazione del ticket conta come stazione. |
Assignee stations | Il numero di modifiche apportate alle assegnazioni di agenti. Anche l'assegnazione iniziale alla creazione del ticket conta come stazione. |
Riaperture | Il numero di volte in cui lo stato di un ticket è stato modificato da Risolto ad Aperto (dall'agente o dall'utente finale). |
Risposte | Il numero di risposte pubbliche degli agenti a un commento in un ticket aggiunto da un agente o un utente finale. |
First reply time in minutes | Il tempo in minuti tra l’ora di creazione del ticket e il timestamp del primo commento pubblico di un agente. |
First reply time in minutes within business hours | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
Tempo di prima soluzione in minuti | Il tempo in minuti tra l’ora di creazione del ticket e il timestamp della prima modifica dello stato in Risolto. |
Tempo di prima soluzione in minuti nell’orario di attività | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
Tempo di soluzione completa in minuti | Il tempo in minuti tra l’ora di creazione del ticket e il timestamp della modifica finale o più recente dello stato in Risolto. |
Tempo di soluzione completa in minuti nell’orario di attività | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
Tempo di attesa agenti in minuti | Il tempo totale in minuti nello stato In attesa. |
Agent wait time in minutes within business hours | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
Requester wait time in minutes | Il tempo totale combinato negli stati Nuovo e Aperto. Se il ticket viene riaperto dopo essere stato risolto, viene conteggiato anche il tempo nello stato Risolto. Il tempo dopo la modifica finale allo stato Risolto non è incluso. |
Requester wait time in minutes within business hours | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
On hold time in minutes | Il tempo totale in minuti nello stato In sospeso. |
On hold time in minutes within business hours | Come sopra, ma viene conteggiato solo il tempo trascorso durante l'orario di attività elencato. |
Esportazione XML completa
Consente di esportare i dati in un file XML. Questa opzione di esportazione non è disponibile se l’account ha più di 200.000 ticket. In tal caso, usa l’opzione di esportazione JSON.
- Account: tutte le impostazioni dell’account
- Gruppi: informazioni dettagliate sui gruppi
- Organizzazioni: informazioni dettagliate sulle organizzazioni
- Ticket: tutti i dettagli (inclusi i commenti) di tutti i ticket
- Utenti: elenco di tutti gli utenti (utenti finali, agenti e amministratori)
Esportazione XML utenti
- Gruppi: informazioni dettagliate sui gruppi
- Organizzazioni: informazioni dettagliate sulle organizzazioni
- Utenti: elenco di tutti gli utenti (utenti finali, agenti e amministratori).
Per i dati utente e organizzazione, sono inclusi i tag, ma non i campi utente e i campi organizzazione personalizzati. Per recuperare i campi utente personalizzati, puoi usare l’endpoint Elenca campi utente nell’API Zendesk. Per recuperare i campi organizzazione personalizzati, puoi usare l’endpoint Elenca campi organizzazione nell’API Zendesk.
Esportazione dei dati dell’account con l’API Zendesk
Puoi usare l’API Zendesk anche per esportare i dati dal tuo account. Ad esempio, puoi usare l’endpoint Elenca utenti per esportare tutti gli utenti nel tuo account. Per informazioni sul come, consulta Esportazione degli utenti con l’API nella Guida per sviluppatori Zendesk. L’articolo mostra come creare un piccolo script che esporti tutti gli utenti nel tuo account in un file CSV. Puoi quindi importare il file CSV nella tua applicazione per fogli di calcolo preferita.
84 commenti
Natalia Tomchyshyn
Migrating help desk data to Zendesk is now simpler with Help Desk Migration's automated solution. You can export data from Zendesk to a CSV file and transfer it to any other help desk platform or import data into Zendesk from a CSV or another system. The process minimizes the need for manual effort while ensuring accurate data mapping for a smoother transition. This approach reduces downtime and helps prevent errors, making the migration process more efficient and less disruptive. For more details, visit: https://www.zendesk.com/marketplace/partners/1065/help-desk-migration-by-relokia/
2
Debra Garzolini
Can I export custom user fields? We have set up Type of Customer field for all users and need to find which ones need completed or updated.
0
Jahn Bronilla
Hello 1264158221429 1263082060269 - is XML no longer supported completely?
0
Carl Joseph
Hi 6285860803098. Thanks for pointing out this documentation error on deactivating data exports. We've updated the document with the correct details now.
0
David Durr
Hi 1263082060269
That article is incorrect, I have already opened a support ticket with proof showing that an “agent” within my Zendesk can easily export ticket data via CSV from their view. This includes the names of both requestors and assignee. Also, the article is wrong as I have already provided screenshots of the below not being there on my Zendesk instance.
Deactivating data exports
You can deactivate the ability to export account data in your account. However, you'll need to contact Zendesk Customer Support to reactivate it (see Exporting ticket, user, or organization data from your account).
To deactivate data exports
In Admin Center, click
Account in the sidebar, then select Tools > Reports.
If necessary, click the Export tab to display data export options. Some legacy versions of Zendesk show export options on a separate tab.
0
Amy Dee
Hi 6285860803098 !
That is a valid security concern, and it's one that Zendesk shares.
These account exports are always restricted to administrators. Agents don't have permission to see or initiate them. In addition, the account owner can restrict exports to administrators in specific email domains (or disable exports entirely). We have more information in this article: Restricting or deactivating account data exports.
Those settings apply to the account export tools described in this article. It doesn't extend to the API. That said, while agents can access some data through the API, the Incremental Exports API endpoints are all admin-only as well.
I hope this helps!
-1
David Durr
is there any way to enable the “export” feature for admins only? this seems like a security concern if a regular agent does this without permission. Since it might contain PII or company PI within the ticket.
0
Christine
Full XML export will include:
Comments include both public comments (external) and internal notes.
Please note that this export option is not available if your account has more than 200,000 tickets. In that case, use the Full JSON export option.
0
Roger Souza
Does the complete XML extraction include the ticket's dialogue information, such as internal and external responses?
0
Dainne Kiara Lucena-Laxamana
Hi 1900248813724
Going back, you can't pick a timeframe for the CSV format in our Export page. That's why we recommended using JSON instead so you can pick a smaller timeframe to export and do it bit-by-bit. For example, the JSON export would only download March's data. Another export would be for April & so on.
0
Accedi per lasciare un commento.