Utilisation des données dans le fichier source.csv
External ID is the required key field that Genesys Cloud’s import process uses to determine unique contacts. This field helps identify contacts so that you can easily update existing contacts via the same spreadsheet. For each unique External ID, the import process creates one Genesys Cloud external contact record. The import process imports all the contact fields in the row to the corresponding Genesys Cloud external contact record.
Lorsque vous créez un identifiant externe, vous pouvez utiliser n'importe quelle combinaison de lettres et de chiffres. Par exemple, vous pouvez utiliser un identifiant unique provenant de votre système CRM ou ERP, ou vous pouvez créer une clé composite qui vous est utile. Il peut s'agir de n'importe quel identifiant externe que vous souhaitez utiliser pour identifier l'enregistrement, à condition qu'il respecte la limite des 255 caractères. Si votre fichier .csv est extrait d'un CRM, nous vous recommandons d'utiliser les identifiants uniques (UUID) de votre CRM. Les UUID permettent de synchroniser les contacts de votre CRM dans les prochaines mises à jour.
Si vous envisagez d’importer l’enregistrement une seule fois, vous pouvez utiliser n’importe quel ID externe. Le système génère des ID internes pour correspondre à ces ID externes.
- Si vous avez précédemment importé vos contacts à l'aide du processus d'importation en bloc old, le système n'utilise que les identifiants Téléphone ou Adresse e-mail pour faire correspondre et mettre à jour votre contact avec le nouvel identifiant externe.
- Pour réussir à fusionner les contacts existants avec les nouveaux enregistrements, il est important, lors de l'importation en masse de fichiers .csv, que tous les numéros de téléphone du fichier .csv respectent le format E.164 lors de l'appariement par téléphone.
- Si les numéros de téléphone de votre fichier .csv ne respectent pas le format E.164, l'étape de validation des données du processus d'importation de déclenche des avertissements. Bien que le processus d'importation se poursuive, rien ne garantit que l'algorithme de résolution des identités corresponde et fusionne correctement les contacts sur la base des numéros de téléphone.
- Si vos anciens contacts n'ont pas d'adresse électronique ou de numéro de téléphone correspondant à l'adresse électronique ou au numéro de téléphone de votre nouveau fichier .csv, le système crée un enregistrement avec l'ID externe que vous avez spécifié dans le fichier .csv.
- Si les informations d'un contact sont répétées plusieurs fois dans le même fichier, le contact est mis à jour plusieurs fois et le compteur de lignes importées reflète la répétition. Toutefois, l'ordre des mises à jour n'est pas garanti.
Lorsque vous mettez à jour des contacts importés précédemment, veillez à utiliser les mêmes ID externes pour éviter de créer des enregistrements en double.
Par exemple, si vous importez une feuille de calcul avec un enregistrement utilisant "A" comme ID externe et que vous réimportez ensuite la même feuille de calcul avec "B" comme ID externe pour cet enregistrement, Genesys Cloud crée un enregistrement au lieu de mettre à jour l'enregistrement existant. Pour mettre à jour un enregistrement existant, utilisez toujours le même identifiant externe.
Organisations externes
TL'ID externe de l'organisation est le champ clé , que le processus d'importation utilise pour déterminer les organisations uniques. Pour chaque ID externe d'organisation externe unique, le processus d'importation crée un enregistrement d'organisation externe Genesys Cloud. Le processus d'importation importe tous les champs de compte de la ligne vers l'enregistrement d'organisation externe Genesys Cloud correspondant.
Lorsque vous créez un identifiant externe d'organisation externe, vous pouvez utiliser n'importe quelle combinaison de lettres et de chiffres. Vous pouvez créer une clé composite significative pour vous, à condition de respecter la limite de 255 caractères. Si votre fichier .csv est extrait d'un CRM, nous vous recommandons d'utiliser les identifiants uniques (UUID) de votre CRM. Les UUID permettent de synchroniser les contacts de votre CRM dans les prochaines mises à jour.
Associer un contact externe à une organisation externe
Pour associer un contact externe à une organisation externe, saisissez-les sur la même ligne dans le fichier source .csv.
Dans cet exemple, Angus Reid est un résolveur de problèmes pour la Fondation Phoenix II. Le processus d'importation crée un enregistrement d'organisation externe pour la Fondation Phoenix II et un enregistrement de contact externe pour Angus Reid. Dans Contacts externes, Angus Reid apparaît comme un contact externe pour l'organisation Phoenix Foundation II.
Associer plusieurs externes contacts avec un externe organisation
Pour associer plusieurs contacts externes à une organisation external , attribuez-leur le même identifiant externe d'organisation.
Dans cet exemple, Kathryn, Josh et Rebecca sont tous des contacts pour l’organisation Office Mart.
- Si plusieurs lignes partagent un ID externe d'organisation, tous les champs spécifiques à l'organisation doivent être identiques (par exemple, Nom du compte) et Genesys Cloud crée une seule organisation externe pour tous les contacts liés. Genesys Cloud n'importe qu'une seule ligne par ID externe, crée une organisation externe pour tous les contacts liés et ne garantit pas la ligne utilisée. S'il existe des différences entre les lignes, chaque ligne est envoyée séparément pour être mise à jour à l'organe externe.
- Vous ne pouvez pas utiliser un fichier.csv pour importer des membres dans une organisation que vous avez créée manuellement.
Comment le processus d'importation en bloc gère les actions de fusion
Dans cet exemple, nous n'importons que des contacts et supposons que tous les champs d'organisation des contacts externes dans le fichier .csv sont vides.
Au cours du processus d'importation en bloc, les options suivantes ont été sélectionnées dans l'écran Profil d'importation :
- Faites correspondre les contacts par: ID externe, numéro de téléphone et adresse électronique
- Fusionner des contacts appariés: Fusionner et mettre à jour tous les contacts correspondants
Dans cet exemple, les identifiants suivants sont recherchés :
- ID externe : 123AABC
- téléphone : +1 919 432 5523
- Courriel : tom.sellenta@sag.aftra.com
Le numéro de téléphone professionnel du fichier .csv est associé au numéro de téléphone portable du contact C. Un nouveau ContactD fusionné est créé.
Dans le tableau suivant,
- La colonne Nom du champ indique le nom du champ dans le fichier .csv.
- La colonne Données CSV (demande d'enrichissement) indique les données du fichier .csv.
- La colonne Contact B est un contact géré dans Genesys Cloud.
- La colonne Contact C est un contact géré dans Genesys Cloud.
- La colonne Contact D correspond au contact fusionné à l'issue de l'importation.
- La colonne Explication décrit comment les données de la colonne Contact D ont été importées.
| Nom du champ | Données CSV (demande d'enrichissement) | Contact B | Contact C | Contact D (Contact fusionné) | Explication : |
|---|---|---|---|---|---|
| ID externe | 123AABC | 123AABC | L'identifiant externe de l'enregistrement .csv enrichit l'enregistrement fusionné en tant qu'identifiant primaire. L'ID de contact utilisé par l'ancienne importation .csv n'est plus utilisé ni affiché dans les enregistrements de contact. | ||
| Prénom | Tom | Tommy | Tom | Tom | Conflit de données, le contact fusionné conserve les données les plus récentes du fichier .csv. |
| middleName | T | T | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact C est utilisée. | ||
| Nom de famille | Selleck | Selk | Selleck | Conflit de données, le contact fusionné conserve les données les plus récentes du fichier .csv. | |
| titre | Résoudre les problèmes | Résoudre les problèmes | La valeur du contact C est utilisée. | ||
| salutation | Mister | Mr. | Mister | Conflit de données, le contact fusionné conserve les données les plus récentes du fichier .csv. | |
| travail Courriel | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com | Conflit de données, le contact fusionné conserve les données les plus récentes du fichier .csv. |
| Courriel personnel | tom@hotmail.com | tommy@yahoo.com | tom@gmail.com | Les courriels et les numéros de téléphone sont traités avec soin lors des fusions afin d'éviter toute perte de données. Si deux contacts utilisent le même champ (par exemple, workEmail), les données sont déplacées vers un autre champ disponible (par exemple, personalEmail ou otherEmail). Dans cet exemple, "tom@gmail.com" est déplacé de workEmail à personalEmail au lieu d'être supprimé. Ce processus se poursuit de manière itérative jusqu'à ce que tous les champs possibles soient utilisés. Si l'espace est limité, les courriels plus anciens sont supprimés pour tenir compte des valeurs demandées. |
|
| Autre courriel | tommy@hotmail.com | Les noms des champs ne sont pas importants et les données des contacts fusionnés sont préservées dans la mesure du possible. S'il n'y a plus de champs disponibles pour la relocalisation, les données sont abandonnées. | |||
| Téléphone portable | +1 919 432-5523 | Le téléphone professionnel du fichier .csv correspond au téléphone portable du contact C. | |||
| Téléphone professionnel | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | La case à cocher Importer le champ ayant été décochée, le téléphone professionnel du contact C reste inchangé après l'importation. | |
| Téléphone à domicile | Aucune mise à jour, aucune valeur dans les contacts. | ||||
| Autre téléphone | Pas de mise à jour, pas de valeur dans les contacts |
Cet exemple n'importe que les contacts. L'hypothèse est que les champs External Org du fichier .csv sont vides.
Au cours du processus d'importation en bloc, les options suivantes ont été sélectionnées dans l'écran Profil d'importation :
- Contacts de match par : ID externe, adresse électronique, téléphone
- Fusionner des contacts appariés: Mise à jour du premier contact apparié uniquement
Dans cet exemple, l'ordre des identifiants recherchés est le suivant : (L'adresse électronique précède ExternalID)
- ID externe : 123AABC
- Courriel : tom.selleck@sag.aftra.com
- téléphone : +1 919 432-5523
L'adresse électronique professionnelle du fichier .csv correspond à l'adresse électronique professionnelle du contact C et le téléphone professionnel correspond au téléphone portable du contact B. Comme l'option Fusionner et mettre à jour tous les contacts correspondants n'est pas sélectionnée, seul le contact C sera mis à jour après l'importation et le contact B restera inchangé, même si les deux contacts correspondent partiellement aux données CSV.
Dans le tableau suivant,
- La colonne Nom du champ indique le nom du champ dans le fichier .csv.
- La colonne Données CSV (demande d'enrichissement) indique les données du fichier .csv.
- La colonne Contact B est un contact géré dans Genesys Cloud.
- La colonne Contact C est un contact géré dans Genesys Cloud.
- La colonne Contact C mis à jour contient les données après l'achèvement de l'importation.
- La colonne Explication décrit comment les données de la colonne Contact D ont été importées.
| Nom du champ | Données CSV (demande d'enrichissement) | Contact B | Contact C | Contact actualisé C | Explication : |
|---|---|---|---|---|---|
| ID externe | 123AABC | 123AABC |
L'identifiant externe de l'enregistrement .csv enrichit l'enregistrement Contact C en tant qu'identifiant principal. L'identifiant de compte utilisé par l'ancienne importation .csv n'est plus utilisé ni affiché dans les fiches de contact. |
||
| Prénom | Tom | Tommy | Tom | Tom | Pas de conflit, pas de changement. |
| middleName | T | T |
.csv n'a pas de valeur pour middleName, mais Contact C en a une. Par conséquent, la valeur middleName du contact C ne change pas. |
||
| Nom de famille | Selleck | Selk | Selleck | Conflit. Mettre à jour le contact C avec les données du fichier .csv. | |
| titre | Résoudre les problèmes | Résoudre les problèmes | Aucune mise à jour puisque le champ Importation n'est pas coché. | ||
| salutation | Mister | Mr. | Mister | Conflit. Mettre à jour le contact C avec les données du fichier .csv. | |
| travail Courriel | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com |
L'adresse électronique professionnelle du fichier .csv est comparée à l'adresse électronique professionnelle du contact C. Ce contact est mis à jour après l'importation et le contact B reste inchangé car il n'était pas le premier contact apparié et le contact C était le premier contact apparié. |
| Courriel personnel | tommy@yahoo.com | tom@yahoo.com | Aucune mise à jour puisque le champ Importation n'est pas sélectionné. | ||
| Autre courriel | Aucune mise à jour, aucune valeur dans les contacts. | ||||
| Téléphone portable | +1 317 845-1232 | +1 317 845-1232 | Pas de mise à jour puisque le champ d'importation n'est pas sélectionné. | ||
| Téléphone professionnel | +1 919 432-5523 | +1 317 845-1232 | +1 919 432-5523 | En cas de conflit, le contact C est mis à jour avec les données du fichier .csv. | |
| Téléphone à domicile | Aucune mise à jour, aucune valeur dans les contacts. | ||||
| Autre téléphone | Aucune mise à jour, aucune valeur dans les contacts. |
Dans cet exemple, certains contacts sont identifiés et d'autres font l'objet d'une curation.
Les contacts peuvent être de trois types :
- Ephémère: Un contact autogénéré qui est associé à un identifiant web côté client ou à un cookie, mais qui ne contient pas d'autres informations. En d'autres termes, il s'agit d'un contact vide sur lequel pointe un cookie web/un identifiant côté client. Ils ont une limite de 60 jours de temps de vie (TTL).
- Identifié: Un contact autogénéré qui ne contient pas d'informations nominatives et dont la durée de vie est limitée à 60 jours.
- Curated: Contacts qui ont été créés ou _promus_ par des agents ou des appels API. Ils n'ont pas de limite TTL.
Les contacts éphémères et identifiés sont générés par le système et n'apparaissent pas dans les API de recherche, les recherches de pages blanches inversées ou les analyses.
Les deux contacts suivants sont appariés dans le système :
- Contact B (Curated)
- Contact C (identifié)
Au cours du processus d'importation en bloc, les options suivantes ont été sélectionnées dans l'écran Profil d'importation :
- Faites correspondre les contacts par: ID externe, adresse électronique et numéro de téléphone.
- Fusionner des contacts appariés: Fusionner et mettre à jour tous les contacts correspondants.
Dans cet exemple, les identifiants suivants sont recherchés :
- ExternalID:123AABC
- Courriel : johnny@gmail.com
- téléphone : +1 919 432-5523
Le champ Email personnel du fichier .csv est mis en correspondance avec l'autre champ Email du contact C, c'est-à-dire johnny@gmail.com.
Le téléphone professionnel figurant dans le fichier .csv correspond au téléphone portable du contact B, à savoir +1 919 432-5523.
Dans le tableau suivant,
- La colonne Nom du champ indique le nom du champ dans le fichier .csv.
- La colonne Données CSV (demande d'enrichissement) indique les données du fichier .csv.
- La colonne Contact B est un contact géré dans Genesys Cloud.
- La colonne Contact C est un contact identifié dans Genesys Cloud.
- La colonne Contact D correspond au contact fusionné à l'issue de l'importation.
- La colonne Explication décrit comment les données de la colonne Contact D ont été importées.
| Nom du champ | Données CSV (demande d'enrichissement) | Contact B | Contact C | Contact D | Explication |
| ID externe | 123AABC | 123AABC | L'identifiant externe de l'enregistrement .csv enrichit l'enregistrement du contact D fusionné en tant qu'identifiant principal. | ||
| Prénom | Johnny | Johnny | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact C est utilisée. | ||
| middleName | Matthieu | M | Matthieu | As there is a conflict, the value from the newest curated contact is used. | |
| Nom de famille | Banques IV | Banques | Banques IV | Banques IV | La valeur du fichier .csv est prioritaire. |
| titre | Johnny Boy | Johnny Boy | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact C est utilisée. | ||
| salutation | Mr | Mr | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact B est utilisée. | ||
| travail Courriel | Banks@gmail.com | Banks@gmail.com | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact B est utilisée. | ||
| Courriel personnel | johnny@gmail.com | johnny@gmail.com | L'adresse électronique personnelle du fichier .csv est comparée à l'autre adresse électronique du contact C. La valeur du fichier .csv est utilisée pour l'adresse électronique personnelle du contact D fusionné. |
||
| Autre courriel | johnny@gmail.com |
L'adresse électronique personnelle du fichier .csv est comparée à l'autre adresse électronique du contact C. L'autre adresse électronique du contact fusionné reste vide dans ce scénario puisque l'adresse électronique personnelle a déjà pris cette adresse électronique et que les doublons de téléphone ou d'adresse électronique ne sont pas enregistrés. |
|||
| Téléphone portable | +1 919 432-5523 |
Le téléphone professionnel figurant dans le fichier .csv correspond au téléphone portable du contact B. Le téléphone portable du contact fusionné reste vide dans ce scénario car le téléphone professionnel a déjà pris cette valeur de numéro de téléphone, et les valeurs de téléphone ou d'e-mail dupliquées ne sont pas sauvegardées. |
|||
| Téléphone professionnel | +1 919 432-5523 | +1 919 432-5523 | Le téléphone professionnel figurant dans le fichier .csv correspond au téléphone portable du contact B. | ||
| Téléphone à domicile | Aucune mise à jour, aucune valeur dans les contacts. | ||||
| Autre téléphone | Pas de mise à jour, pas de valeur dans les contacts |
