Créer des listes au format CSV

Créez des listes en téléchargeant des enregistrements au format .csv (valeurs séparées par des virgules). Formatez les données que vous souhaitez respecter avec la syntaxe .csv encodée en UTF-8 avant de les télécharger ou de les ajouter à une liste :

• Chaque enregistrement est une ligne terminée par un saut de ligne (LF) ou un retour de chariot (CRLF).
• Les noms de colonnes ne peuvent pas contenir de caractères spéciaux, tels qu'une barre oblique inverse. (\).
• Utilisez des virgules pour délimiter les éléments de données, appelés champs.
• Le ligne premier doit être une rangée d’en-têtes de noms de champ séparés par des virgules.
• Placez les champs contenant des espaces ou des virgules entre guillemets.
• Placez une chaîne de caractères contenant des espaces en tête ou à la fin entre guillemets.
• Si un champ est vide, insérez une virgule à cette position dans l’enregistrement.
• Placez des champs contenant des virgules entre deux guillemets. Par exemple, "prénom, nom", "numéro de téléphone", "adresse".
• Si un champ contient des guillemets doubles, mettez-le entre guillemets et convertissez chaque caractère de guillemet double en deux.
• Note importante: Le fichier .csv ne doit pas comporter de lignes vides à la fin des données, ce qui peut entraîner un échec de l'importation.

Colonnes obligatoires

Un fichier .csv doit au moins contenir une colonne de numéros de téléphone. Par exemple, une colonne unique pour une liste de personnes à ne pas contacter pourrait ressembler à ceci :

Définissez toutes les colonnes nécessaires à votre fichier .csv, telles que le nom du contact et le code du compte. Lorsque vous téléchargez le fichier .csv pour créer une nouvelle liste, le système crée un tableau avec les colonnes correspondantes dans le nuage. Après la création de cette table, vous ne pouvez pas ajouter des données contenant un ensemble de colonnes différent. 

Ne pas dépasser 50 colonnes

Le nombre maximum de colonnes autorisées dans une liste de contacts est de 50. Un message d'erreur apparaît si cette nouvelle liste de contacts dépasse cette limite, mais aucune entrée n'apparaît pour elle dans l'observateur d'événements.

Les noms de colonnes doivent être uniques

Tous les noms de colonnes de la première ligne doivent être uniques. Si vous dupliquez le nom d'une colonne, le fichier n'est pas importé.

Inclure une colonne d’identifiant unique

Inclure une colonne dans le fichier .csv qui identifie chaque ligne de manière unique. Cela permet de s'assurer que les données nouvelles ou mises à jour pourront être ajoutées avec précision à l'avenir. Les identifiants uniques typiques sont l’identifiant du client ou son numéro de compte. Plus tard, quand vous ajouter des enregistrements dans votre liste de contacts, sélectionnez votre colonne Identifiant unique. Grâce à cette colonne, le processus d'ajout peut faire correspondre de la manière la plus précise les données entrantes avec les contacts existants.

Sans identifiant unique, la ligne entière est la clé primaire. Si vous ajoutez un enregistrement modifié, un téléchargement ultérieur ajoute cet enregistrement en tant que nouvelle ligne, même si une ligne existante a le même identifiant. Ce comportement ne correspond pas aux attentes des utilisateurs lorsqu'ils exportent une liste, la modifient, puis ajoutent et téléchargent leurs données. Lorsque vous utilisez un identifiant unique, le système remplace l'enregistrement existant.

Utiliser les colonnes de zone

Contact list records often store multiple phone numbers per contact, such as work, cell, and home numbers. To use the callable times feature, each phone number column must have a corresponding time zone name column which contains the zone name in Tz database format . For example, a column named Home Time Zone to contain the time zone corresponding to each number in the Home Phone column. Note that zone columns are not used in Do Not Contact lists.

• As a best practice, specify both a unique Id and a time zone name column corresponding to each phone number column–for example, home or work–when you create a contact list.
• You cannot add time zone name columns later, but you can populate or update existing zone name columns by appending–uploading–records that have the same unique ID. When Genesys Cloud finds a matching row, it updates columns using data in the append file. For example, the system updates any zone name columns in a record with time zone data read from the .csv file. The zone name columns must exist.
• Associate each time zone name column with a contact number column when you create a list. You can also edit the contact list later, and map its time zone columns to phone number columns by selecting from the time zone column dropdown list.
  

Ne pas supprimer les espaces blancs de début et de fin.

Lorsque vous enregistrez une liste de contacts, les espaces blancs de début et de fin sont supprimés du champ de contact de la liste de contacts. Si vous ne souhaitez pas supprimer les espaces blancs de votre liste de contacts, réglez l'option Découper les espaces blancs en début et en fin de liste sur No.

Utiliser un tableur pour éditer des fichiers .csv

Nous vous recommandons d'enregistrer au format CSV à partir d'un tableur, et non d'un éditeur de texte. Lorsque la feuille de calcul enregistre un fichier.csv, elle insère automatiquement les guillemets et les virgules nécessaires. L'utilisation d'une feuille de calcul est moins sujette aux erreurs que le formatage manuel des enregistrements.

Par exemple, le dossier > Enregistrer as > CSV (Comma Délimité) la commande de Microsoft Excel génère les enregistrements.csv suivants :