Résumé IA vérifié ◀▼
Les administrateurs peuvent importer les données utilisateur en masse en utilisant un fichier CSV pour ajouter ou mettre à jour des utilisateurs et définir des rôles et des droits. Avant d’importer les données, vérifiez que les importations de données sont activées et que les organisations sont importées en amont. Prenez en considération les limites de taille de fichiers, les mises à jour des données et les notifications par e-mail. Utilisez l’importateur de données pour gérer les importations, en vous assurant que les champs sont mappés correctement et en vérifiant les détails de l’importation.
Plutôt que d’ajouter les utilisateurs manuellement les uns après les autres, les administrateurs peuvent en ajouter plusieurs à la fois en effectuant une importation en masse. Pour cela, il suffit de créer un fichier CSV (valeurs séparées par des virgules) contenant les données des utilisateurs. En plus des données utilisateur de base (adresse e-mail et numéro de téléphone), vous pouvez aussi définir les rôles des utilisateurs et les privilèges des agents, et ajouter des utilisateurs à une organisation. Vous pouvez utiliser l’importation en masse pour ajouter de nouveaux utilisateurs ou mettre à jour des utilisateurs existants. L’importation en masse via un fichier CSV ne fonctionne que pour les utilisateurs et les rôles Support.
Vous devez être un administrateur pour importer des utilisateurs ou des organisations en masse.
- Pour protéger les données dans votre compte Zendesk, les importations de données ne sont pas activées par défaut. Le propriétaire du compte ou un administrateur doit contacter l’assistance client Zendesk pour demander l’activation des exportations de données et l’accès aux pages des importations.
- Si vous voulez importer des utilisateurs et des organisations en masse, vous devez commencer par importer les organisations.
Considérations pour l’importation d’utilisateurs en masse
Limites de l’importation en masse avec l’importateur de données
Les importations en masse portent sur les données essentielles des utilisateurs ou des organisations. Pour importer les données non répertoriées dans ce tableau, vous devez utiliser l’API Zendesk REST. Consultez Importation d’utilisateurs avec l’API Zendesk.
- Quand vous utilisez l’importateur de données, le fichier CSV d’importation ne peut pas faire plus de 1 Go. Nous conseillons un maximum de 500 000 lignes (une ligne d’en-tête et jusqu’à 499 999 lignes de données). De plus, chaque ligne ne peut dépasser 128 Ko.
- Le fichier CSV d’importation peut contenir 200 colonnes maximum.
- Le fichier CSV d’importation ne peut pas garantir l’ordre d’importation des lignes.
- N’incluez pas le même utilisateur ou la même organisation plusieurs fois dans un même fichier CSV. Votre importation risquerait d’échouer.
- Il n’y a aucune garantie que les enregistrements soient créés ou mis à jour dans l’ordre dans lequel ils apparaissent dans le fichier CSV.
- Vous ne pouvez importer qu’un seul fichier CSV à la fois. Donc, si vous avez plus de données que le nombre maximum de lignes pris en charge par le fichier CSV, vous devez créer des fichiers indépendants pour chaque lot de données et les importer les uns après les autres. Quand vous n’utilisez pas l’importateur de données, jusqu’à deux lots de données sont placés en file d’attente et traités en arrière-plan. Si vous voulez importer plus de deux lots, vous devez attendre que l’importation des deux premiers soit terminée pour en ajouter d’autres.
- Vous ne pouvez pas utiliser l’importation en masse pour importer les coordonnées des comptes Facebook ou X (anciennement Twitter) des utilisateurs finaux. Vous devez utiliser l’API REST de Zendesk. Consultez Importation d’utilisateurs avec l’API Zendesk.
Mise à jour des données de profil utilisateur existantes
Comment l’importateur de données met à jour les données
- phone (ajouté comme numéro de téléphone secondaire)
- email (ajouté comme adresse e-mail secondaire)
Toutes les autres données sont remplacées par l’importateur de données.
Décider d’envoyer un e-mail aux utilisateurs importés en masse
Avant d’effectuer une importation en masse des utilisateurs, il est important de vérifier les paramètres de votre e-mail de bienvenue. Quand vous ajoutez de nouveaux utilisateurs par le biais d’une importation en masse quand Guide est activé, chaque utilisateur reçoit l’e-mail de bienvenue. Cet e-mail de bienvenue contient un lien permettant de vérifier l’adresse e-mail. Chaque utilisateur est ensuite invité à choisir un mot de passe et à se connecter. Vous pouvez empêcher l’envoi de l’e-mail de bienvenue à ces utilisateurs.
Pour empêcher l’envoi de l’e-mail de bienvenue aux utilisateurs
- Dans le Centre d’administration, cliquez sur Utilisateurs (
) dans la barre latérale, puis sélectionnez Configuration > Utilisateurs finaux. - Dans la section Message de bienvenue envoyé à l’utilisateur, désélectionnez l’option Aussi envoyer un e-mail de vérification lors de la création d’un nouvel utilisateur par un agent ou un administrateur.
- Cliquez sur Enregistrer.
Création du fichier CSV (importation d’utilisateurs)
Lorsque vous créez la liste des utilisateurs à importer, vous allez sans doute travailler dans une application existante (par exemple, une base de données des employés). La plupart de ces applications supportent le format de sortie CSV. Si vous devez créer une liste en partant de zéro, vous pouvez utiliser un tableur tel que Microsoft Excel ou OpenOffice Calc.
- Vous pouvez télécharger un modèle CSV dans Centre d’administration > Importateur de données > Importer > Télécharger un modèle CSV.
- Le fichier doit être au format CSV et enregistré avec l’encodage de caractères UTF-8.
- La première ligne du fichier CSV est la ligne d’en-tête et doit être incluse au fichier.
- La ligne d’en-tête doit contenir tous les champs exigés du tableau ci-dessous, plus tout autre champ répertorié dans le tableau ci-dessous que vous souhaitez inclure.
- Les champs inclus doivent s’afficher dans la ligne d’en-tête dans l’ordre dans lequel ils sont répertoriés ci-dessous.
- Si vous n’importez pas de données pour un champ, ne le répertoriez pas dans la ligne d’en-tête.
- Les colonnes de données vides dans le fichier écrasent la plupart des données existantes pour cet utilisateur. Pour les exceptions, consultez Mise à jour des données de profil utilisateur existantes.
- Ajoutez des sauts de ligne aux notes ou aux champs multiligne en appuyant sur ALT+ENTRÉE pour Windows ou CTRL+OPTION+RETOUR sur un Mac.
Le tableau ci-dessous présente la liste des champs que vous pouvez inclure dans le fichier CSV. Les champs de nom, d’adresse e-mail et de restrictions sont tous exigés lors de l’importation de nouveaux utilisateurs. Quand les utilisateurs existants sont mis à jour par le biais d’une importation en masse, seul un identifiant unique (p. ex., une adresse e-mail ou un ID externe) est exigé.
| Champs | Description |
|---|---|
| name | Obligatoire pour l’importation de nouveaux utilisateurs. Nom complet de l’utilisateur. |
| emails |
Obligatoire pour l’importation de nouveaux utilisateurs. Adresse e-mail complète de l’utilisateur (de type someuser@mycompany.com). Si vous incluez plusieurs adresses e-mail pour un utilisateur, séparez-les par des barres verticales (|). Exemple : first@yourcompany.com|second@yourcompany.com
|
| ticket_restriction |
Obligatoire pour l’importation de nouveaux utilisateurs. Les restrictions permettent de définir les privilèges du membre de l’équipe ou de l’utilisateur final, les tickets auxquels il peut accéder, etc. Obligatoire pour l’importation de nouveaux utilisateurs quand le rôle d’un utilisateur est configuré sur Agent. Pour les éditions autres qu’Enterprise, les valeurs de restriction suivantes sont prises en charge :
Les valeurs de restriction organisation et demandeur peuvent être affectées quand le rôle de l’utilisateur est défini sur Utilisateur final. Toutes les autres s’appliquent uniquement aux membres de l’équipe.
Remarque – Dans les éditions Enterprise, les rôles d’agent l’emportent sur les restrictions d’agent standards. Autrement dit, vous ne pouvez pas utiliser les restrictions standards décrites dans le tableau ci-dessus pour importer ou mettre à jour un agent. Vous devez spécifier un rôle d’agent. Si vous spécifiez par erreur un rôle qui n’existe pas dans Support, l’utilisateur est automatiquement affecté au rôle « Agent light »,
|
| external_id | Si un utilisateur dispose d’un ID autre que son adresse e-mail (par exemple, un ID de collaborateur ou un numéro de référence client), vous pouvez le spécifier dans ce champ. Les ID externes doivent être uniques pour chaque utilisateur ou les données seront écrasées. Si vous avez besoin de configurer plusieurs adresses e-mail ou numéros de téléphone pour un seul utilisateur, vous pouvez le faire en créant plusieurs entrées pour cet utilisateur dans le fichier CSV et en utilisant la même colonne external_id pour toutes les lignes associées à cet utilisateur. À l’exception des adresses e-mail ou des numéros de téléphone supplémentaires, les valeurs de toutes les colonnes doivent rester les mêmes pour toutes les lignes. Si un ID externe, une adresse e-mail ou un numéro de téléphone correspond à plusieurs utilisateurs existants, cette ligne est refusée dans l’importation en masse.
Remarque – Si vous importez des utilisateurs avec le champ external_id comme seul identifiant (c’est-à-dire sans inclure l’adresse e-mail), vous devez quand même inclure le champ d’adresse e-mail dans le fichier CSV, même s’il est vide. Par exemple :
|
| details | Détails de l’utilisateur, par exemple, son adresse. Ces informations sont visibles uniquement par les membres de l’équipe (jamais par les utilisateurs finaux). |
| notes | Notes relatives à cet utilisateur. Seuls les membres de l’équipe (et non les utilisateurs finaux) peuvent consulter ces notes. |
| phones | Numéros de téléphone de l’utilisateur. Les numéros de téléphone uniques sont ajoutés comme des lignes directes. Les numéros de téléphone qui existent déjà sont ajoutés comme des lignes secondaires. Si vous incluez plusieurs numéros de téléphone pour un utilisateur, séparez-les par des barres verticales (|). Pour fonctionner avec Zendesk, les numéros de téléphone doivent être au format E.164 international normalisé. |
| shared_phone | Numéro de téléphone partagé de l’utilisateur. Pour fonctionner avec Zendesk, les numéros de téléphone doivent être au format E.164 international normalisé. |
| role | Sensible à la casse : Utilisateur final ou Agent. Si vous ne spécifiez pas de rôle, la valeur par défaut est End-user. |
| custom_role | Quand un rôle est défini sur Agent, spécifiez le nom du rôle personnalisé tel qu’il apparaît à la page Rôles du Centre d’administration. Agent light est également accepté. |
| skip_verify_email | Si vous voulez créer des utilisateurs sans envoyer d’e-mail de vérification, définissez cette valeur sur true. |
| time_zone | Une chaîne comme « Heure de l’Est/UTC -5 (États-Unis et Canada) ». Pour une liste des noms valides, consultez le menu Fuseau horaire à la page Localisation (Compte > Aspect > Localisation) du Centre d’administration. Exemple : si le menu contient « (GMT+02:00) Berlin », utilisez « Berlin » comme nom de fuseau horaire. |
| locale | La langue de l’utilisateur. Un marqueur conforme à la norme BCP-47 pour la langue (p. ex., en-US). Si locale et locale_id sont tous les deux présents, locale_id est ignoré et seul locale est utilisé. |
| local_id | L’identifiant de la langue de l’utilisateur. |
| moderator | Booléen. Indique si l’utilisateur a des capacités de modération des forums |
| only_private_comments | Booléen. Quand défini sur true, l’utilisateur peut uniquement créer des commentaires privés. |
| remote_photo_url | Une URL pointant vers la photo de profil de l’utilisateur. |
| signature | La signature de l’utilisateur. Seuls les agents et les administrateurs peuvent avoir des signatures. |
| suspended | Booléen. Indique si l’utilisateur est suspendu. Les tickets provenant d’utilisateurs suspendus sont également suspendus et ces utilisateurs ne peuvent pas se connecter au portail des utilisateurs finaux. |
| alias | Un pseudo affiché pour les utilisateurs finaux. |
| organizations | Nom de l’organisation dans laquelle l’utilisateur doit être ajouté (l’organisation cible doit exister au préalable, sinon l’importation échoue).
Avec les éditions Professional et Enterprise, vous pouvez ajouter un utilisateur à plusieurs organisations en séparant les noms des organisations avec le caractère pipe (barre verticale). Par exemple : La première organisation par ordre alphabétique est définie comme organisation par défaut d’un utilisateur. Il n’est pas possible de définir une autre organisation par défaut pendant une importation en masse. Cependant, vous pouvez modifier l’organisation par défaut d’un utilisateur manuellement ou avec le point de terminaison Support API - Set Membership as Default. |
| default_group_id |
Les nouveaux membres de l’équipe (administrateurs et agents) sont automatiquement ajoutés au groupe par défaut du compte. Cependant, vous pouvez utiliser ce champ pour spécifier d’autres groupes par défaut pour les utilisateurs pendant les importations en masse. Les utilisateurs finaux ne peuvent pas être ajoutés aux groupes. |
| tags | Si les marqueurs sont activés pour les utilisateurs et les organisations dans Zendesk Support (consultez Ajout de marqueurs aux utilisateurs et aux organisations), vous pouvez ajouter des marqueurs utilisateur. Séparez les marqueurs par des virgules. |
| custom_fields.<clé du champ> | Quand vous effectuez une importation en masse d’utilisateurs, vous pouvez importer un champ d’utilisateur personnalisé en spécifiant le préfixe custom_fields. et la clé du champ. Par exemple, pour la clé du champ custom_fields.subscription_date Les clés des champs personnalisés sont sensibles à la casse et doivent être saisies en minuscules. Si vous importez des informations pour une case à cocher, saisissez true pour qu’elle soit cochée ou false pour qu’elle ne le soit pas. Pour définir la valeur des options de la liste déroulante, utilisez le marqueur que vous avez ajouté lorsque vous avez créé la liste déroulante. Pour les champs de dates personnalisés, utilisez le format AA/MM/JJ ou AA-MM-JJ. Pour trouver la clé pour un champ utilisateur personnalisé :
Si une valeur n’est pas formatée correctement, l’importation échouera et vous recevrez un rapport d’erreur spécifiant ce qui n’a pas été enregistré.
Remarque – Si le champ d’utilisateur personnalisé que vous importez est un champ Relation de recherche, saisissez l’ID de l’objet connexe comme valeur pour ce champ. Par exemple, pour une organisation, saisissez l’ID de l’organisation et pour un utilisateur, saisissez l’ID de l’utilisateur. Pour un enregistrement d’objet personnalisé, saisissez l’ID de l’enregistrement. Pour trouver l’ID d’une organisation, d’un utilisateur ou d’un enregistrement d’objet personnalisé, vous pouvez exporter les données de votre compte ou utiliser l’API Organisations, l’API Utilisateurs ou l’API Enregistrements d’objets personnalisés.
|
Utilisation de l’importateur de données pour importer des données utilisateur
Vous pouvez utiliser l’importateur de données pour importer un fichier CSV qui crée de nouveaux utilisateurs ou met à jour les utilisateurs existants et capture les journaux de toutes les tentatives d’importation par le biais de la page Importateur de données.
- Dans le Centre d’administration, cliquez sur Objets et règles (
) dans la barre latérale, puis sélectionnez Outils > Importateur de données. - Cliquez sur Importer.
- Sous Destination cible, sélectionnez Utilisateurs.
- Sous Type d’importation, choisissez l’une des options suivantes :
- Créer des enregistrements uniquement : seuls les nouveaux utilisateurs sont ajoutés. Toutes les données portant sur les utilisateurs existants dans le fichier CSV sont ignorées.
- Mettre à jour des enregistrements uniquement : met à jour les données pour les utilisateurs existants présents dans votre fichier CSV. Le champ external_id est requis pour mettre les utilisateurs à jour. Toutes les données portant sur les nouveaux utilisateurs sont ignorées.
- Créer et mettre à jour des enregistrements : ajoute les nouveaux utilisateurs et met à jour les données pour les utilisateurs existants présents dans votre fichier CSV.
Remarque – Si un ID externe, une adresse e-mail ou un numéro de téléphone correspond à plusieurs utilisateurs existants, cette ligne est refusée dans l’importation en masse. Consultez votre historique des importations. - Sous Téléchargement de fichier, faites glisser et déposez votre fichier ou cliquez pour télécharger et sélectionnez votre fichier CSV dans le navigateur.
Si vous voulez changer le fichier que vous avez sélectionné, cliquez sur l’icône de suppression (
) en regard du nom du fichier. - Cliquez sur Suivant.
- Consultez la liste Mappage des champs.
- Si le mappage est correct, cliquez sur Suiv.
- Sinon, cliquez sur Retour. Modifiez le fichier CSV pour qu’il respecte les exigences de format puis téléchargez-le à nouveau.
- Lisez le résumé des détails de l’importation dans la boîte de dialogue de confirmation, puis cliquez sur Commencer l’importation.
Une fois l’importation commencée, il est impossible d’annuler les modifications importées. Pour connaître le statut d’une importation, consultez votre historique des importations.