Riepilogo AI verificato ◀▼
Gli amministratori possono importare in blocco i dati degli utenti usando un file CSV per aggiungere o aggiornare gli utenti e impostare ruoli e privilegi. Prima di procedere, assicurati che l’importazione dei dati sia abilitata e che le organizzazioni vengano importate per prime. Tieni conto dei limiti di dimensioni dei file, degli aggiornamenti dei dati e delle notifiche email. Usa l’importatore di dati per gestire le importazioni, garantire la corretta mappatura dei campi e rivedere i dettagli delle importazioni.
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 intendi importare in blocco organizzazioni e utenti, devi cominciare con le organizzazioni.
Considerazioni sull’importazione in blocco degli utenti
Limitazioni per l’importazione in blocco con l’ importatore di dati
Puoi importare un set di dati di base relativi a utenti e organizzazioni. Per importare dati non elencati nella tabella, devi usare l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk.
- Quando si usa l’importatore di dati, le dimensioni del file CSV di importazione non possono superare 1 GB. Consigliamo un massimo di 500.000 righe. Questa è una riga di intestazione e un massimo di 499.999 righe di dati. Inoltre, le dimensioni di ogni riga non possono superare 128 KB.
- Il file CSV di importazione può contenere un massimo di 200 colonne.
- Il file CSV di importazione non può garantire l’ordine di importazione delle righe.
- 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.
Aggiornamento dei dati dei profili utente esistenti
Modalità di aggiornamento dei dati mediante l'importatore di dati
- telefono (aggiunto come numero di telefono secondario)
- indirizzo email (aggiunto come indirizzo email secondario)
Tutti gli altri dati vengono sostituiti dall’importatore di dati.
Decidere se inviare un’email agli utenti importati in blocco
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 CSV con i dati utente
In genere, gli elenchi di utenti da importare vengono generati a partire da un altro sistema di gestione utenti, ad esempio 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.
- Puoi scaricare un modello CSV in Centro amministrativo > Importatore di dati > Importa > Scarica un modello CSV.
- 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 importi dati per un campo, non includerlo 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 Aggiornamento dei dati dei profili utente esistenti.
- 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 |
|---|---|
| name | Obbligatorio per importare nuovi utenti. Il nome completo dell’utente. |
Obbligatorio per importare nuovi utenti. L’indirizzo email completo dell’utente (someuser@mycompany.com). Se includi più indirizzi email per un utente, separali con una barra verticale (|). Ad esempio: first@yourcompany.com|second@yourcompany.com
|
|
| limitazione_ticket |
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.
|
| id_esterno | 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. Per configurare più indirizzi email o numeri di telefono per un singolo utente, crea più voci per l’utente nel file CSV e usa 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. |
| notes | Note riguardanti questo utente. Le note sono visibili solo ai membri del team, non agli utenti finali. |
| telefoni | 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. Se includi più numeri di telefono per un utente, separa i numeri di telefono con una barra verticale (|). Per usare Talk, i numeri di telefono devono essere nel formato E.164 standardizzato a livello internazionale. |
| telefono_condiviso | Il numero di telefono condiviso dell’utente. Per usare Talk, i numeri di telefono devono essere nel formato E.164 standardizzato a livello internazionale. |
| ruolo | Distingue tra maiuscole e minuscole: Utente finale o Agente. Se non imposti un ruolo, il ruolo dell’utente viene impostato su Utente finale. |
| custom_role | Quando il ruolo è impostato su Agente, specifica il nome del ruolo personalizzato, come indicato nella pagina Ruoli nel Centro amministrativo. È accettato anche l’agente interno. |
| skip_verify_email | Per creare utenti senza inviare un’email di verifica, imposta questo valore su true. |
| time_zone | Consiste in una stringa come “Eastern Time (US & Canada)”. Per un elenco di nomi validi, consulta il menu Elenco fusi orari nella pagina Localizzazione (Account > Aspetto > Localizzazione) nel Centro amministrativo. Esempio: Se il menu mostra "(GMT+02:00) Berlin", utilizza "Berlin" come nome del fuso orario time_zone. |
| impostazioni locali | Le impostazioni locali dell’utente. Un tag conforme a BCP-47 per la localizzazione (ad esempio, en-US). Se sono presenti sia locale che locale_id, locale_id viene ignorato e viene utilizzato solo locale. |
| local_id | L’identificatore della lingua dell’utente. |
| moderatore | Valore booleano. Indica se l’utente dispone delle capacità di moderazione del forum. |
| only_private_comments | Valore booleano. Quando è impostato su true, l’utente può solo creare commenti privati. |
| remote_photo_url | Un URL che punta all’immagine del profilo dell’utente. |
| firma | La firma dell’utente. Solo gli agenti e gli amministratori possono avere firme. |
| sospeso | Valore booleano. Indica se l’utente è sospeso. I ticket degli utenti sospesi vengono anch’essi sospesi, e questi utenti non possono accedere al portale per utenti finali. |
| alias | Un alias mostrato agli utenti finali. |
| organizzazioni | Il nome dell’organizzazione a cui verrà aggiunto l’utente. Deve trattarsi di un’organizzazione già esistente, 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. |
| default_group_id |
I nuovi membri del team (amministratori e agenti) vengono aggiunti automaticamente al gruppo predefinitodell’account. Tuttavia, puoi usare questo campo per specificare gruppi predefiniti alternativi per gli utenti durante le importazioni in blocco. Gli utenti finali non possono essere aggiunti ai gruppi. |
| 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. |
| custom_fields.<field key> | Quando esegui un’importazione di utenti in blocco, puoi importare un campo utente personalizzato specificando il prefisso custom_fields. e la chiave del campo. Ad esempio, per la chiave del campo custom_fields.subscription_date 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 verrà visualizzato un report di errore indicante i record che 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 l’importatore di dati per importare i dati degli utenti
Puoi usare l’importatore di dati per importare un file CSV che crea nuovi utenti o aggiorna gli utenti esistenti e per acquisire i registri di tutti i tentativi di importazione tramite la pagina Importatore di dati.
- Nel Centro amministrativo, fai clic su Oggetti e regole
nella barra laterale, quindi seleziona Strumenti > Importatore di dati. - Fai clic su Importa.
- In Destinazione, seleziona Utenti.
- In Tipo di importazione, scegli una delle seguenti opzioni:
- Solo creazione: vengono aggiunti solo nuovi utenti. Tutti i dati nel file CSV relativi agli utenti esistenti vengono ignorati.
- Solo aggiornamento: aggiorna i dati degli utenti esistenti elencati nel file CSV. Per aggiornare gli utenti è richiesto l’id_esterno. Tutti i dati relativi ai nuovi utenti vengono ignorati.
- Crea e aggiorna: aggiungi nuovi utenti e aggiorna i dati degli utenti esistenti elencati nel file CSV.
Nota: 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. Controlla la cronologia delle importazioni. - In Caricamento file, trascina il file oppure fai clic per caricare e seleziona il file CSV nel browser di file.
Se devi cambiare il file che hai selezionato, fai clic sull’icona di eliminazione (
) accanto al nome del file. - Fai clic su Avanti.
- Consulta l’elenco di mappatura dei campi.
- Se la mappatura dei campi è corretta, fai clic su Avanti.
- Se la mappatura dei campi non è corretta, fai clic su Indietro. Modifica il file CSV in modo che soddisfi i requisiti di formato, quindi carica di nuovo il file.
- Consulta il riepilogo dei dettagli dell’importazione nella finestra di dialogo di conferma, quindi fai clic su Avvia importazione.
Una volta avviata l’importazione, le modifiche importate non potranno più essere ripristinate. Per controllare lo stato di un’importazione, controlla la cronologia delle importazioni.