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 mettre en conformité avec la syntaxe .csv encodée en UTF-8 avant de les télécharger ou de les ajouter à une liste :

  • Chaque enregistrement ligne est terminé ligne par un ligne flux ou un retour de chariot / paire d’alimentation.
  • Les noms de colonne 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.
  • 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

    Au minimum, un fichier.csv doit contenir une colonne de numéros de téléphone. Par exemple, une seule Ne pas appeler colonne convient aux listes :

    Téléphone
    317-123-4567

    Remarque : Les caractères de formatage sont ignorés, à l'exception du signe plus (+) avec les numéros formatés E.164.

    La plupart des listes de contacts nécessitent davantage de colonnes, telles que le nom du contact ou le code du compte. Assurez-vous de définir toutes les colonnes nécessaires dans votre fichier.csv.

    Lorsque vous le téléchargez pour créer une nouvelle liste, le système crée une table avec des colonnes correspondantes dans le nuage. Par la suite, vous ne pouvez pas ajouter de données contenant un ensemble de colonnes différent.

    Ne pas dépasser 50 colonnes

    Le nombre maximum de colonnes autorisé dans une liste de contacts est 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 colonne de la première ligne doivent être uniques. Si vous dupliquez un nom de colonne, le fichier n’est pas importé.

    Inclure une colonne d’identifiant unique

    Inclure une colonne dans le fichier.csv qui identifie de manière unique chaque ligne. Cela garantit que vous pouvez ajouter avec précision des données nouvelles ou mises à jour à 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. À l’aide de cette colonne, le processus d’ajout peut très bien faire correspondre les données entrantes aux 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. Les utilisateurs ne s’attendent pas à ce comportement lorsqu’ils exportent une liste, la modifient, puis ajoutent (téléchargent) leurs données.

    Lorsque vous utilisez un identifiant unique, le système remplace à la place l’enregistrement existant.

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

    Vous pouvez composer un identifiant unique à partir de caractères alphanumériques. Les espaces, barres obliques inverses, et ces caractères spéciaux ne fonctionnent pas avec les URL :

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

    Utiliser les colonnes de zone

    Les enregistrements de liste de contacts stockent souvent plusieurs numéros de téléphone par contact, tels que des numéros de travail, de cellulaire 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 nommée «  Zone fuseau horaire de temps à domicile » pour contenir le correspondant à chaque numéro dans la colonne «  Home Phone ». Ne pas appelerles listes n’utilisent pas de colonnes de zone, soit dit en passant.

    • Il est recommandé de 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) lors de la création d’une liste de contacts.

    • Vous ne pouvez pas ajouter de colonnes de zone ultérieurement, mais vous pouvez renseigner ou mettre à jour des colonnes de zone existantes en ajoutant (en téléchargeant) des enregistrements ayant le même ID 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 zone doivent exister.

    • Associez fuseau horaire chaque colonne à une colonne de numéros de contact, ce que vous faites habituellement lorsque vous créez la liste. Si vous oubliez, vous pouvez modifier la liste de contacts plus tard, et mapper ses colonnes de fueaux horaires aux colonnes de numéro de téléphone en sélectionnant à partir de la liste de colonnes.

      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, basculez l'option Trim leading/trailing whitespace sur No.

    Utilisez une feuille de calcul au lieu d’un éditeur de texte pour modifier les fichiers.csv

    Nous vous recommandons d’enregistrer As.csv à partir d’un éditeur de feuilles de calcul. 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.

    tableur_data

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

    Last Name, First Name,Home Phone, Home Time Zone,Cell Phone,Cell Time Zone,Balance Due,Account Code,HomeAddress
    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"
    
    
    Remarque : Si vous utilisez Excel comme tableur pour créer des listes CSV pour les 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 ne spécifiez pas de formatage personnalisé, le formatage par défaut d'Excel supprime le préfixe '+'.