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 :

Téléphone
317-123-4567
….
Note: Les caractères de formatage sont ignorés, à l'exception du signe plus en tête avec les nombres formatés E.164.

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.

Ne pas utiliser de caractères spéciaux dans les identifiants uniques

Composer un identifiant unique à partir de caractères alphanumériques. Les espaces, les barres obliques inversées et les caractères spéciaux suivants ne fonctionnent pas avec les URL :

– . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

Utiliser les colonnes de zone

Les enregistrements de listes de contacts contiennent souvent plusieurs numéros de téléphone par contact, tels que les numéros de travail, de téléphone portable et de domicile. Pour utiliser le temps d’appel fonctionnalité, chaque colonne de numéro fuseau horaire de téléphone doit avoir une colonne correspondante contenant le nom de zone dans Base de données Tz format. Par exemple, une colonne intitulée Fuseau horaire domicile contient le fuseau horaire correspondant à chaque numéro de la colonne Téléphone domicile. Notez que les colonnes de zones ne sont pas utilisées dans les listes de personnes à ne pas contacter.

  • La meilleure pratique consiste à spécifier un identifiant unique et une colonne de zone correspondant à chaque colonne de numéro de téléphone - par exemple, domicile ou travail - lorsque vous créez une liste de contacts.
  • Vous ne pouvez pas ajouter de colonnes de zone ultérieurement, mais vous pouvez remplir ou mettre à jour les colonnes de zone existantes en ajoutant des enregistrements qui ont le même identifiant unique. Lorsque Genesys Cloud trouve une ligne correspondante, il met à jour les colonnes à l’aide des données du fichier d’ajout. Par exemple, le système met à fuseau horaire jour toutes les colonnes de zone dans un enregistrement avec des données lues à partir du fichier.csv. Les colonnes de la zone doivent exister.
  • Associez chaque colonne de fuseau horaire à une colonne de numéro de contact, ce que vous faites généralement lorsque vous créez la liste. En cas d'oubli, vous pouvez modifier la liste de contacts ultérieurement et faire correspondre ses colonnes de fuseaux horaires aux colonnes de numéros de téléphone en les sélectionnant dans la liste déroulante des colonnes de fuseaux horaires.
    La figure montre comment associer une colonne de numéro de téléphone à une colonne qui identifie sonfuseau horaire

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 sous .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.

La figure montre l'édition d'un fichier .csv à l'aide d'un tableur.

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

Nom, prénom, téléphone à domicile, fuseau horaire du domicile, téléphone portable, fuseau horaire du portable, solde dû, code du compte, adresse du domicile.
Doe, "James ""Big John"",317-123-4567,America/Indiana/Indianapolis,317-987-6543,America/Indiana/Indianapolis,175,1003, "123 Anystreet, Indianapolis, IN"
Downing,Mary,424-999-2334,America/Los_Angeles,,,234,3799, "724 Bel Air Drive, Los Angeles, CA"
Note: Si vous utilisez Excel comme tableur pour créer des listes CSV pour des campagnes SMS, les colonnes de numéros de téléphone doivent être au format E.164. Pour les colonnes de numéros de téléphone, utilisez le format Excel Custom, avec le code de format de numéro +# ?/ ?. Si vous n'indiquez pas de formatage personnalisé, le formatage par défaut d'Excel supprime le préfixe .