Riepilogo AI verificato ◀▼
Gli amministratori possono importare in blocco i dati degli utenti usando un file CSV per aggiungere o aggiornare le informazioni sugli utenti, inclusi ruoli e appartenenze alle organizzazioni. Prima dell’importazione, assicurati che l’importazione dei dati sia abilitata e che le organizzazioni vengano importate. Tieni presente le limitazioni come un massimo di 2.000 righe per file e l'impossibilità di importare determinati tipi di dati. Prendi in considerazione le impostazioni email di benvenuto per gestire le notifiche per i nuovi utenti.
Zendesk consiglia di usare l’ importatore di dati per importare i dati degli utenti anziché la pagina delle azioni in blocco legacy descritta in questo articolo. Tuttavia, se preferisci, puoi comunque usare la pagina Azioni in blocco per importare informazioni utente nuove o aggiornate.
Gli amministratori possono aggiungere più utenti tramite un’importazione in blocco anziché aggiungerli manualmente uno alla volta. A tal fine, è necessario creare un file con valori separati da virgola (CSV) contenente i dati dell’utente. Oltre ai dati utente essenziali, quali indirizzo email e numero di telefono, puoi anche impostare ruoli utente, definire i privilegi di un agente e aggiungere utenti a un'organizzazione. Puoi usare l’importazione in blocco per aggiungere nuovi utenti o aggiornare quelli esistenti. L’importazione in blocco tramite file CSV funziona solo per utenti e ruoli Support.
Per importare in blocco utenti e organizzazioni, devi essere un amministratore.
- Per proteggere i dati nel tuo account Zendesk, le importazioni di dati non sono abilitate per impostazione predefinita. Il proprietario dell’account o un amministratore deve contattare l’assistenza clienti Zendesk per abilitare l’esportazione dei dati e l’accesso alla pagina delle importazioni.
- Se vuoi importare in blocco utenti e organizzazioni, devi prima importare le organizzazioni .
Considerazioni sull’importazione in blocco degli utenti (legacy)
Esistono diverse limitazioni e considerazioni da esaminare prima di importare in blocco gli utenti.
Limitazioni per l’importazione in blocco di utenti e organizzazioni (legacy)
Puoi importare un set di dati di base relativi a utenti e organizzazioni. Ad esempio, puoi importare i dati descritti nella tabella seguente. Tuttavia, non puoi importare fusi orari, foto, preferenze di lingua e altri dati. Per importare dati non elencati nella tabella, devi usare l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk o Importazione di organizzazioni con l’API Zendesk.
- Quando si usano le pagine delle azioni multiple, il file di dati CSV di importazione può contenere un massimo di 2.000 righe. Ovvero, una riga di intestazione e fino a 1.999 righe di dati.
- Non includere lo stesso utente o la stessa organizzazione più di una volta in un file CSV. In caso contrario, l’importazione potrebbe non riuscire.
- Non vi è alcuna garanzia che i record verranno creati o aggiornati nell’ordine in cui vengono mostrati nel file CSV.
- Puoi importare un solo file CSV alla volta. Pertanto, se disponi di un numero di dati superiore al numero massimo di righe supportate per il file CSV, devi creare file separati per ciascun batch e importarli uno dopo l'altro. Quando non usi l’ importatore di dati, fino a due batch vengono accodati ed eseguiti in background. Se vuoi importare più di due batch, devi attendere il completamento dell’importazione dei primi batch per aggiungerne altri.
- Non puoi usare l’importazione in blocco per importare informazioni di contatto dagli account Facebook o Twitter degli utenti finali. Per questa operazione, usa l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk.
Come i dati vengono aggiornati dall’importazione di azioni in blocco (legacy)
- nome
- external_id
- ruolo
- limitazione
- organizzazione
- campi personalizzati
- tag (solo quando si usa l’importatore di dati)
- dettagli
- note
- tag
- telefono (aggiunto come numero di telefono secondario)
- indirizzo email (aggiunto come indirizzo email secondario)
Decidere se inviare un’email agli utenti importati in blocco (legacy)
Prima di eseguire un’importazione in blocco di utenti, è importante controllare le impostazioni delle email di benvenuto. Quando aggiungi nuovi utenti tramite un’importazione in blocco mentre Guide è abilitato, ogni utente riceve un messaggio email di benvenuto. L’email di benvenuto contiene un link per la verifica dell’indirizzo email, che invita l’utente a selezionare una password e a effettuare l’accesso. È possibile evitare che gli utenti ricevano l’email di benvenuto.
Per evitare che l’email di benvenuto venga inviata agli utenti
- Nel Centro amministrativo, fai clic sull’icona Persone
nella barra laterale, quindi seleziona Configurazione > Utenti finali. - Nella sezione Email di benvenuto all’utente, deseleziona Invia un’email di verifica anche quando un nuovo utente viene creato da un agente o un amministratore.
- Fai clic su Salva.
Creazione del file di dati utente CSV (legacy)
Quando crei un elenco di utenti da importare, probabilmente lo genererai da un altro sistema di gestione utenti, come un database dei dipendenti. La maggior parte di questi sistemi offre funzionalità per la creazione di file di esportazione CSV. Se devi creare l’elenco da zero, puoi usare un programma come Microsoft Excel o OpenOffice.org Calc.
- Il file deve essere in formato CSV e deve essere salvato usando la codifica dei caratteri UTF-8.
- La prima riga del file CSV è la riga dell’intestazione e deve essere inclusa nel file.
- La riga dell’intestazione deve contenere tutti i campi obbligatori della tabella esposta di seguito, oltre a qualsiasi altro campo elencato nella tabella che desideri includere.
- I campi inclusi devono apparire nella riga dell’intestazione nell’ordine in cui sono elencati nella tabella.
- Se non stai importando dati per un campo, non elencarlo nella riga dell’intestazione.
- Le colonne di dati vuote nel file sovrascriveranno la maggior parte dei dati esistenti per quell’utente. Per le eccezioni, consulta Come i dati vengono aggiornati mediante l’importazione di azioni in blocco.
- Aggiungi interruzioni di riga alle note o ai campi personalizzati multilinea premendo ALT+INVIO su un computer Windows o CTRL+OPZIONE+INVIO su un Mac.
Nella tabella seguente sono elencati i campi che puoi includere nel file. I campi nome, indirizzo email e limitazione sono obbligatori quando si importano nuovi utenti. Per aggiornare gli utenti esistenti tramite l’importazione in blocco è necessario un solo identificatore univoco (indirizzo email o ID esterno).
| Campo | Descrizione |
|---|---|
| nome | Obbligatorio per importare nuovi utenti. Il nome completo dell’utente. |
| Obbligatorio per importare nuovi utenti. L’indirizzo email completo dell’utente (someuser@mycompany.com). Il campo email può contenere un valore vuoto o nullo. Se il campo email è vuoto o nullo, il sistema crea comunque il profilo utente. | |
| limitazione |
Obbligatorio per importare nuovi utenti. La limitazione definisce i privilegi del membro del team o dell’utente finale, i ticket a cui ha accesso, ecc. È necessaria per importare nuovi utenti quando il ruolo dell’utente è impostato su Agente
Con i piani non Enterprise, sono supportati i seguenti valori di limitazione:
I valori di limitazione “organizzazione” e “richiesto” possono essere assegnati quando il ruolo dell’utente è impostato su “Utente finale”. Tutti gli altri si applicano solo ai membri del team.
Nota: nei piani Enterprise, i ruoli agente hanno la precedenza sulle limitazioni standard applicate agli agenti. Ciò significa che non puoi usare nessuna delle limitazioni standard elencate nella tabella riportata sopra per importare o aggiornare un agente. Devi specificare un ruolo agente. Se per errore utilizzi un nome di ruolo che non esiste in Support, il ruolo dell’utente viene impostato di default su Agente interno.
|
| external_id | Se disponi di un ID diverso dall’indirizzo email dell’utente (ad esempio un ID dipendente o un numero di riferimento cliente), puoi includerlo qui. Gli ID esterni devono essere univoci per ciascun utente, altrimenti i dati verranno sovrascritti. Se devi configurare più indirizzi email o numeri di telefono per un singolo utente, puoi farlo creando più voci per l’utente nel file CSV e usando la stessa colonna external_id per tutte le righe da associare a un singolo utente. Fatta eccezione per gli indirizzi email o i numeri di telefono aggiuntivi, i valori in tutte le altre colonne devono rimanere gli stessi per ciascuna riga. Se un ID esterno, un indirizzo email o un numero di telefono corrisponde a più di un utente esistente, la riga viene rifiutata dall’importazione in blocco.
Nota: se importi utenti con campo external_id come unico identificatore (il che significa che non includi anche l'indirizzo email), devi comunque includere il campo email nel file CSV, senza dati. Ad esempio:
|
| dettagli | Informazioni dettagliate sull’utente, ad esempio un indirizzo. Queste informazioni sono visibili solo ai membri del team, non agli utenti finali. |
| note | Note riguardanti questo utente. Le note sono visibili solo ai membri del team, non agli utenti finali. |
| telefono | Il numero di telefono dell'utente. I numeri di telefono univoci vengono aggiunti come linee dirette. I numeri di telefono già esistenti vengono aggiunti come linee secondarie. Per usare Talk, i numeri di telefono devono essere nel formato E.164 standardizzato a livello internazionale. |
| numero_di_telefono_condiviso | Se si tratta di un numero di telefono condiviso, imposta il campo su “true”. Un numero di telefono condiviso non può essere usato come identità utente. |
| ruolo | Distingue tra maiuscole e minuscole: Utente finale, Agente o Amministratore. Se non imposti un ruolo, il ruolo dell’utente viene impostato su Utente finale. |
| organizzazione | Il nome dell’organizzazione a cui verrà aggiunto l’utente. L’organizzazione deve esistere già, altrimenti l’importazione avrà esito negativo.
Con i piani Professional ed Enterprise, puoi aggiungere un utente a più organizzazioni separando i nomi delle organizzazioni con una barra verticale. Ad esempio: L’organizzazione predefinita di un utente è impostata sulla prima organizzazione in ordine alfabetico. Non è possibile impostare un’organizzazione predefinita diversa durante un’importazione in blocco. Tuttavia, l’organizzazione predefinita di un utente può essere modificata manualmente o usando l’endpoint API Support - Imposta appartenenza come configurazione predefinita. |
| tag | Quando l’associazione di tag a utenti e organizzazioni è abilitata per Zendesk Support (consulta Aggiunta di tag e utenti alle organizzazioni), è possibile aggiungere tag utente. Separa ogni tag con una virgola. |
| brand | Se l’account include più brand, puoi specificare un sottodominio del brand. Il sottodominio del brand specificato determina il brand dell’email di benvenuto inviata all’utente, a condizione che il brand sia attivo e disponga di un centro assistenza abilitato. Se il sottodominio del brand specificato non è attivo, non ha un centro assistenza abilitato o non esiste, la colonna viene ignorata e l’email di benvenuto viene inviata usando il brand predefinito. I sottodomini del brand fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente per essere importati.
Specifica solo il nome del sottodominio del brand. Ad esempio, usa miodominio e non miodominio.zendesk.com. |
| custom_fields.<field key> | Quando esegui un’importazione in blocco di utenti, puoi importare un campo utente personalizzato specificandocustom_fields.prefisso e la chiave del campo. Ad esempio, per la chiave del campodata_abbonamento, usa quanto segue per impostare i valori importati per questo campo. custom_fields.subscription_date Tieni presente che le chiavi dei campi personalizzati fanno distinzione tra maiuscole e minuscole e devono essere inserite in lettere minuscole. Se stai importando informazioni in una casella di spunta, inserisci “true” per selezionarla o “false” per lasciarle deselezionata. Per impostare il valore delle opzioni dell’elenco a discesa, usa il tag aggiunto al momento della creazione dell’elenco a discesa. Per i campi data personalizzati, usa il formato GG/MM/AAAA o GG-MM-AAAA. Per individuare la chiave di un campo utente personalizzato:
Se il valore di un campo non è formattato correttamente, l’importazione avrà esito negativo e riceverai un report di errore che specifica quali record non sono stati salvati.
Nota: se il campo utente personalizzato che stai importando è un campo di relazione di ricerca, inserisci l'ID dell'oggetto correlato come valore per questo campo. Ad esempio, per un’organizzazione, inserisci l’ID dell’organizzazione; per un utente, inserisci l’ID dell’utente; per un record oggetto personalizzato, inserisci l’ID del record. Per trovare l’ID di un’organizzazione, di un utente o di un record oggetto personalizzato, puoi esportare i dati dal tuo account o usare l’API organizzazioni, l’API utenti o l’API record oggetto personalizzato.
|
Utilizzando un’importazione di azioni multiple per importare i dati degli utenti (legacy)
Sebbene Zendesk consigli di usare l’ importatore di dati, puoi comunque usare le pagine delle azioni in blocco per importare informazioni nuove e aggiornate per gli utenti.
- Nel Centro amministrativo, fai clic su Persone nella barra laterale, quindi seleziona Azioni multiple > Importa utenti.
- Seleziona le opzioni di importazione:
-
Crea nuovi utenti: questa opzione è selezionata per impostazione predefinita e non può essere deselezionata. Questo perché gli utenti elencati nel file CSV che non esistono nel tuo account Zendesk vengono sempre creati.
-
Aggiorna utenti esistenti: seleziona questa opzione di importazione se vuoi modificare anche i dati degli utenti esistenti.
È necessario includere un id_esterno o un indirizzo email nel file CSV per ciascun utente per consentirne l’identificazione. Oltre ai campi di identificazione utente, includi solo i campi che vuoi aggiornare nel file CSV. Se non inserisci un valore per un campo nel file CSV, tale valore viene sovrascritto per l’utente esistente.
Se un ID esterno, un indirizzo email o un numero di telefono corrisponde a più di un utente esistente, la riga viene rifiutata dall’importazione in blocco.
Nota: Se non vuoi aggiungere nuovi utenti, devi usare l’ importatore di dati. Quando usi le pagine delle azioni in blocco, se il file CSV contiene informazioni sui nuovi utenti, questi vengono sempre aggiunti, indipendentemente dall’opzione di importazione selezionata. -
- (Facoltativo) Seleziona Includi ID esterno nel file di output CSV.
Al termine del processo di importazione, riceverai una notifica email che include un link a un file dei risultati dell’importazione CSV separato. Usa questo link per scaricare il file e visualizzare i risultati dell’importazione. Il file mostra lo stato dei dati utente che hai tentato di importare (Creati, Aggiornati, Non riusciti, Non modificati). Se selezioni questa opzione, il report include l’indirizzo email o un ID esterno per ciascun utente creato o aggiornato.
Se non selezioni questa opzione, gli ID esterni vengono esclusi dal file dei risultati dell’importazione CSV. Al contrario, per ogni utente creato o aggiornato viene elencato solo l’indirizzo email dell’utente.
- Fai clic su una delle seguenti opzioni: Scegli file o Preferisco incollare i dati.
- Fai clic su Importa.
L’importazione viene aggiunta alla coda e gli utenti vengono aggiunti a Zendesk Support al termine del processo di importazione. Al termine dell’importazione riceverai un’email.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.