Utilisation des données dans le fichier source.csv
Contacts externes
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. 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 précédemment importés à l'aide du nouveau processus d'importation en masse, veillez à utiliser les mêmes ID externes afin d'éviter de créer des enregistrements en double.
Si les informations d'un contact sont répétées plusieurs fois dans un fichier, le contact est mis à jour plusieurs fois et le nombre d'importations reflète la répétition. Toutefois, l'ordre des mises à jour n'est pas garanti.
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.
- Lorsque le processus d'importation rencontre plusieurs lignes avec le même ID externe de l'organisation, Genesys Cloud s'attend à ce que les données du compte soient identiques dans tous les champs. Par exemple, le nom du compte doit être identique dans toutes les lignes qui ont le même ID externe de l'organisation. Le processus d'importation n'importe qu'une seule des lignes de données de compte lorsque plusieurs lignes ont le même ID externe de l'organisation. Genesys ne garantit pas quelle ligne de données de compte le processus importe. Ce n’est pas nécessairement le premier ou le dernier analyse de cause première dans l’ensemble des lignes du compte. Par conséquent, toutes les lignes de données relatives aux comptes doivent être identiques.
- 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 et mettre à jour tous les contacts correspondants: Mise à jour du premier contact apparié uniquement
Dans cet exemple, l'ordre des identifiants recherchés est le suivant :
- 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 | Pas de conflit | ||
| 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. S'il n'y a plus de champs disponibles, les données sont abandonné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. Ce champ sera mis à jour après l'importation des données .csv du téléphone portable (qui est vide dans ce cas). | |||
| Téléphone professionnel | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | Comme la case Importer un champ n'a pas été 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 :
- Faites correspondre les contacts par: ID externe, numéro de téléphone et adresse électronique
- Fusionner et mettre à jour tous les contacts correspondants: 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. Ce contact sera mis à jour après l'importation et le contact B reste inchangé car l'option Fusionner et mettre à jour tous les contacts correspondants n'est pas sélectionnée.
Dans le tableau suivant,
- La colonne Field Name indique le nom du champ dans le fichier .csv.
- La colonne CSV Data (Enrich Request) indique les données du fichier .csv.
- La colonne Contact B est un contact curatif dans Genesys Cloud.
- La colonne Contact C est un contact curatif dans Genesys Cloud.
- La colonne Updated Contact C est le contact fusionné à l'issue de l'importation.
- La colonne Explanation 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 | Mettre à jour le contact C avec les données du fichier .csv. | |||
| 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. Par définition, les contacts identifiés n'ont pas encore revendiqué d'identifiant dans le système. Les contacts classés ont revendiqué un identifiant au moment de leur création.
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, numéro de téléphone et adresse électronique.
- Fusionner et mettre à jour tous les contacts correspondants: Fusionner et mettre à jour tous les contacts correspondants.
Dans cet exemple, l'ordre des identifiants recherchés est le suivant :
- ExternalID:123AABC
- Courriel : johnny@gmail.com
- téléphone : null
Le champ Email personnel du fichier .csv est mis en correspondance avec l'autre champ Email du contact C.
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 | En cas de conflit, c'est la valeur du contact identifié qui 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 | En cas de conflit, c'est la valeur du contact identifié qui est utilisée. |
| titre | Johnny Boy | Les valeurs nulles ne sont pas utilisées dans les importations .csv. La valeur du contact C est utilisée. | |||
| salutation | 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 courriers électroniques sont traités avec soin lors des fusions afin d'éviter toute perte de données. Par conséquent, bien que l'adresse électronique professionnelle des données .csv soit nulle, nous conservons l'adresse électronique professionnelle du contact B après la fusion et la plaçons dans l'adresse électronique professionnelle du contact D fusionné. | ||
| 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 | johnny@gmail.com | Les courriers électroniques sont traités avec soin lors des fusions afin d'éviter toute perte de données. Par conséquent, bien que l'adresse électronique professionnelle des données .csv soit nulle, nous conservons l'autre adresse électronique du contact C après la fusion et la plaçons dans l'autre adresse électronique du contact D fusionné. | ||
| Téléphone portable | Aucune mise à jour, aucune valeur dans les contacts. | ||||
| Téléphone professionnel | Pas de mise à jour, pas de valeur dans les contacts | ||||
| 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 |
Contacts externes (ancienne procédure d'importation)
Contact ID est le champ de clé requis. Le processus d’importation de PureCloud l’utilise pour déterminer des contacts uniques. Il permet d'identifier les contacts afin que vous puissiez facilement mettre à jour les contacts existants à l'aide de la même feuille de calcul. Pour chaque ID de contact unique, le processus d'importation crée un enregistrement de contact externe Genesys Cloud. Le processus d’importation importe tous les champs de contact de la ligne dans l’enregistrement de contact externe PureCloud correspondant.
Lorsque vous créez un ID de contact, vous pouvez utiliser n’importe quelle combinaison de lettres et de chiffres. Par exemple, vous pouvez utiliser un identifiant unique de votre système CRM ou ERP, ou ytu peux créer un clé composite qui a du sens pour vous. Il peut s'agir de n'importe quel ID que vous souhaitez utiliser pour identifier de manière unique l'enregistrement.
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 et souhaitez mettre à jour les enregistrements, assurez-vous que vous utilisez les mêmes ID de contact pour les contacts existants. Sinon, PureCloud crée un nouvel enregistrement au lieu de mettre à jour l’existant.
Par exemple, supposons que vous ayez une feuille de calcul avec un enregistrement et que vous l’importiez avec A comme ID de contact. Plus tard, vous souhaitez mettre à jour cet enregistrement en réimportant la même feuille de calcul. L’ID de contact pour cet enregistrement doit être le même que lors de l’importation précédente. Si, à la place, vous réimportez la feuille de calcul avec B comme ID de contact pour cet enregistrement, PureCloud crée un nouvel enregistrement au lieu de mettre à jour l’existant.
Organisations externes
Tl'identifiant du compte est le champ clé utilisé par le processus d'importation pour déterminer les organisations uniques. Pour chaque ID de compte unique, le processus d'importation crée un enregistrement d'organisation externe Genesys Cloud. Le processus d’importation importe tous les champs du compte de la ligne dans l’enregistrement d’organisation externe PureCloud correspondant.
Lorsque vous créez un identifiant de compte, vous pouvez utiliser n’importe quelle combinaison de lettres et de chiffres. Vous pouvez créer une clé composite qui a du sens pour vous.
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, Kathryn Smith est une acheteuse pour Office Mart. Le processus d’importation crée l’enregistrement d’organisation externe pour Office Mart et un enregistrement de contact externe pour Kathryn Smith. Dans Contacts externes, Kathryn Smith apparaît en tant que contact externe pour l’organisation Office Mart.
Associer plusieurs externes contacts avec un externe organisation
Pour associer plusieurs contacts externes à un externe organisation, attribuez-leur tous le même identifiant de compte.
Dans cet exemple, Kathryn, Josh et Rebecca sont tous des contacts pour l’organisation Office Mart.
- Lorsque le processus d’importation rencontre plusieurs lignes avec le même ID de compte, PureCloud s’attend à ce que les données de compte soient les mêmes dans tous les champs. Par exemple, le nom du compte doit être identique dans toutes les lignes qui ont le même ID de compte. Le processus d’importation importe une seule des lignes de données de compte lorsque plusieurs lignes ont le même ID de compte. Genesys ne garantit pas quelle ligne de données de compte le processus importe. Ce n’est pas nécessairement le premier ou le dernier analyse de cause première dans l’ensemble des lignes du compte. Par conséquent, toutes les lignes de données de compte doivent être identiques.
- Vous ne pouvez pas utiliser un fichier.csv pour importer des membres dans une organisation que vous avez créée manuellement.
