Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation de la fonctionnalité Profils des clients Amazon Connect
Pour aider les agents à fournir un service client plus efficace et personnalisé, Amazon Connect vous permet de combiner des informations provenant d'applications externes, telles que Salesforce, Zendesk ou d'autres produits de gestion de la relation client (CRM), avec l'historique des contacts de Amazon Connect. ServiceNow Cela crée un profil de client qui réunit en un seul endroit toutes les informations dont les agents ont besoin lors des interactions avec les clients.
Grâce à une vue unique des informations relatives aux clients, notamment leur produit, leur cas et l’historique de leurs contacts, les agents peuvent rapidement confirmer l’identité du client et déterminer le motif de l’appel ou du chat.
Actuellement, la fonctionnalité Profils des clients Amazon Connect peut être utilisée conformément au [RGPD](https://aws.amazon.com/compliance/gdpr-center) et est en attente de certifications supplémentaires détenues par Amazon Connect.
L’image suivante montre l’espace de travail des agents ; aux fins de cette documentation, une image des Profils des clients Amazon Connect est présentée. L’espace de travail des agents est conçu pour effectuer plusieurs tâches à la fois de manière efficace, comme gérer simultanément les appels, les chats et les tâches, tout en fournissant un accès rapide aux informations du profil du client dans la même fenêtre de navigateur.
![\[L’onglet de profil du client dans l’application d’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png)
1. **Cas** : statut, numéro de référence, titre, source, date de mise à jour et autres informations relatives aux cas ingérés depuis une application 3P telle que Zendesk ServiceNow, ainsi qu'aux cas créés et gérés à l'aide de cas. Amazon Connect
1. **Informations supplémentaires** : informations supplémentaires contenues dans le champ *Attributs* définis par le client [du profil](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html), ainsi que d’autres informations de profil telles que le numéro de téléphone portable et l’adresse de livraison. Ces informations sont triées par ordre alphabétique pour aider un agent à trouver rapidement les informations dont il a besoin.
1. **Historique des contacts** : date, heure et durée des contacts de ce client avec votre centre de contact par le passé.
1. **Historique des achats de produits** : toutes les ressources achetées par un client peuvent être renseignées ici. Les données sont ingérées à partir d’une application externe telle que Salesforce ou Zendesk que vous avez [intégrée](integrate-external-apps-customer-profiles.md) aux Profils des clients.
# Qu’est-ce qu’un profil de client dans Amazon Connect ?
Un *profil de client* est un enregistrement qui stocke l’historique des contacts combiné à des informations sur les clients, telles que le numéro de compte, des informations supplémentaires, la date de naissance, l’adresse e-mail, plusieurs adresses, le nom et le type de partie. Un *profil basé sur un compte* devrait avoir des sous-profils sous-jacents.
Après l’activation de Profils des clients Amazon Connect, un profil de client unique est créé pour chaque contact. Cela vous permet de créer un profil de client qui réunit gratuitement en un seul endroit toutes les informations dont les agents ont besoin lors des interactions avec les clients.
Pour accéder aux profils des clients dans vos flux, utilisez le bloc [Profils des clients](customer-profiles-block.md). [Les agents accèdent aux profils des clients](customer-profile-access.md) dans leur espace de travail.
Vous pouvez utiliser les fonctionnalités payantes des Profils des clients pour enrichir vos profils des clients en [ingérant des données provenant d’applications externes](integrate-external-apps-customer-profiles.md). Consultez [Tarification](https://aws.amazon.com/connect/pricing/) pour plus d’informations.
Vous pouvez également ajouter des champs et des objets personnalisés aux profils clients à l'aide des [profils clients Amazon Connect APIs](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## Comment sont stockées les données du profil de client ?
Amazon Connect stocke l’historique des contacts dans des profils des clients uniques. Il analyse les données ingérées par des applications externes et les stocke sous forme d’attributs de profil de client.
Amazon Connect ne remplace ni ne met à jour les données de l’application externe. Si une source de données est supprimée, les données de l’application externe ne sont plus disponibles dans le profil du client pour chaque contact vocal.
Pour plus d’informations sur la sécurisation des données de profil de client, consultez [Protection des données dans Amazon Connect](data-protection.md).
Pour plus d’informations sur l’accès aux données stockées dans un profil de client, consultez [Accès à la fonctionnalité Profils des clients dans l’espace de travail de l’agent](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html) ou [Utilisation de l’API Profils des clients](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html).
# Activez les profils clients pour votre instance Amazon Connect.
Amazon Connect propose des intégrations prédéfinies qui vous permettent de combiner rapidement les informations clients provenant de plusieurs applications externes avec l’historique des contacts d’Amazon Connect. Cela vous permet de créer un profil de client qui réunit en un seul endroit toutes les informations dont les agents ont besoin lors des interactions avec les clients.
## Avant de commencer
Vous trouverez ci-dessous un aperçu des concepts clés et des informations qui vous seront demandées au cours du processus de configuration.
### À propos du domaine des profils des clients
Lorsque vous activez Profils des clients Amazon Connect, vous créez un domaine de profils des clients : un conteneur pour toutes les données, telles que les profils des clients, les types d’objets, les clés de profil et les clés de chiffrement. Voici quelques consignes concernant la création de domaines Profils des clients :
+ Chaque instance Amazon Connect peut être associée à un seul domaine.
+ Vous pouvez créer plusieurs domaines, mais ceux-ci ne partagent pas entre eux les intégrations d’applications externes ni les données client.
+ Toutes les intégrations d’applications externes que vous créez se situent au niveau du domaine. Toutes les instances Amazon Connect associées à un domaine héritent des intégrations du domaine.
+ Vous pouvez à tout moment modifier l’association entre votre instance Amazon Connect et votre domaine actuel en choisissant un nouveau domaine. Cela n’est toutefois pas recommandé, car les profils des clients de l’ancien domaine ne sont pas déplacés vers le nouveau domaine.
### Banque de données
Le magasin de données est un magasin de données à long terme contenant les données des profils clients. Il stocke les données des profils clients mises à jour au cours des 10 dernières années. Ce sont les données utilisées pour la segmentation basée sur Spark SQL et Predictive Insights, et elles doivent être activées pour utiliser ces fonctionnalités. Il n'est pas utilisé pour calculer les attributs calculés ou pour remplir l'espace de travail de l'agent.
### Comment souhaitez-vous nommer votre domaine de profils des clients ?
Lorsque vous activez les profils clients, vous êtes invité à fournir un nom de domaine convivial qui vous tient à cœur, tel que le nom de votre organisation, par exemple, *CustomerProfiles- ExampleCorp*. Vous pouvez modifier le nom convivial à l’aide de l’API à tout moment.
### Banque de données
Le magasin de données est un magasin de données géré par des services requis pour la segmentation basée sur Spark SQL et Predictive Insights. Il doit être activé pour utiliser ces fonctionnalités. Il n'est pas utilisé pour calculer les attributs calculés ou pour remplir l'espace de travail de l'agent.
Une fois que vous avez activé le stockage des données, celui-ci enregistre automatiquement les données que vous ingérez dans les profils clients. Une fois que vous avez activé le magasin de données, vous ne pouvez pas désactiver cette fonctionnalité. Pour supprimer des données du magasin de données, vous pouvez utiliser l' DeleteProfile API ou supprimer les types d'objets ou le domaine du profil client.
### Souhaitez-vous utiliser une file d’attente de lettres mortes ?
Une file d’attente de lettres mortes sert à signaler les erreurs associées au traitement de données provenant d’applications externes.
Amazon AppFlow gère la connexion à l'application externe et le transfert des données de celle-ci vers les profils clients Amazon Connect. Amazon Connect traite ensuite le fichier.
+ Si une erreur se produit pendant la connexion ou pendant le transport des données vers Amazon Connect, Amazon fait AppFlow apparaître l'erreur mais ne l'inscrit pas dans la file d'attente des lettres mortes.
Par exemple, une erreur de traitement peut être due au fait que les données externes ne correspondent pas au schéma spécifié ou que le format des données externes n’est pas correct (actuellement, seul le format JSON est pris en charge).
+ Si Amazon Connect rencontre une erreur lors du traitement du fichier, il l’enregistre dans votre file d’attente de lettres mortes. Vous pouvez consulter la file d’attente ultérieurement et essayer de traiter à nouveau l’erreur.
+ Vous pouvez trouver des messages SQS dans la file d’attente de lettres mortes définie avec votre domaine qui inclut le message d’erreur ainsi que l’objet.
| **Message d’erreur** | **Recommandation** |
| --- | --- |
| La clé UNIQUE ou la clé PROFIL n’existe pas dans l’objet de profil | Modifiez le mappage de données ou l’objet, assurez-vous que les clés marquées comme UNIQUE et PROFIL dans le mappage de données existent dans l’objet. Consultez la [**page de mappage des données**](customer-profiles-object-type-mapping.md) pour savoir comment configurer cela. |
| Trop d’objets ingérés sur le profil par seconde | Trop d’objets assignés au même profil en peu de temps. Vous pouvez réingérer l'objet ou ajouter un délai d'attente entre deux appels à l' PutProfileObject API. |
| Les profils clients ne peuvent pas ingérer l'objet parce qu'il EncryptionKey n'existe pas dans la région, parce qu'ils EncryptionKey ne disposent pas d'une autorisation d'utilisation pour les profils clients ou parce EncryptionKey qu'ils n'en ont pas l' GenerateDataKey autorisation | Vérifiez votre autorisation KMS, assurez-vous que la fonctionnalité Profils des clients dispose de l’accès requis. Suivez la section [**Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS**](#enable-customer-profiles-step1). |
| La clé KMS n’est pas valide | Vérifiez votre autorisation KMS, assurez-vous que la fonctionnalité Profils des clients dispose de l’accès requis. Suivez la section [**Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS**](#enable-customer-profiles-step1). |
| Les profils clients ne peuvent pas ingérer l’objet en raison d’une clé KMS non valide | Vérifiez votre autorisation KMS, assurez-vous que la fonctionnalité Profils des clients dispose de l’accès requis. Suivez la section [**Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS**](#enable-customer-profiles-step1). |
| Vos données contiennent un objet de profil supérieur à \$1 octets | Supprimez tous les champs inutiles et réduisez la taille des données jusqu’à ce qu’elle tombe en dessous de la limite spécifiée dans le message d’erreur. |
| Toutes les clés de cet objet sont liées à plusieurs profils | Modifiez le mappage de données ou l’objet, assurez-vous qu’au moins 1 clé PROFIL de l’objet est liée à un profil inférieur ou égal à 1 profil existant. |
Lorsque vous activez Profils des clients, vous avez la possibilité de spécifier une file d’attente Amazon SQS comme file d’attente de lettres mortes. Si vous sélectionnez cette option, ajoutez la politique de ressources suivante à Amazon SQS afin que la fonctionnalité Profils des clients soit autorisée à envoyer des messages à cette file d’attente :
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
Pour éviter le problème de sécurité de l’adjoint confus, consultez [Prévention du problème de l’adjoint confus entre services pour la fonctionnalité Profils des clients Amazon Connect](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service) pour un exemple de politique à appliquer.
Step-by-step les instructions pour créer une file d'attente de lettres mortes sont fournies plus loin dans cette rubrique, dans. [Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS](#enable-customer-profiles-step1)
### Création d’une clé KMS à utiliser par Profils des clients pour chiffrer les données (obligatoire)
**Note**
Pour conserver l'accès aux profils clients APIs, les entités utilisant les profils clients `profile` APIs doivent disposer d'`kms:GenerateDataKey`autorisations `kms:Decrypt` et d'autorisations explicites dans leurs politiques IAM. Cela leur permet d’utiliser `kms:Decrypt` et `kms:GenerateDataKey` pour la clé KMS associée aux ressources extraites de l’API relative aux Profils des clients.
Lorsque vous activez les profils clients, vous êtes invité à créer ou à fournir une [clé AWS Key Management Service KMS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Step-by-steples instructions pour créer une clé KMS sont fournies plus loin dans cette rubrique, dans[Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS](#enable-customer-profiles-step1).
Toutes les données au repos pour la fonctionnalité Profils des clients sont chiffrées avec la clé KMS que vous avez choisie. Votre clé gérée par le client est créée, détenue et gérée par vous-même. Vous avez le contrôle total de la clé KMS (AWS KMS des frais s'appliquent).
Si vous choisissez de configurer une clé KMS dont une autre personne est l’administrateur, elle doit disposer d’une politique avec les autorisations `kms:GenerateDataKey`, `kms:CreateGrant` et `kms:Decrypt` pour le principal du service Profils des clients. Pour plus d'informations sur la façon de modifier une politique clé, consultez la section [Modification d'une politique clé](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) dans le Guide du AWS Key Management Service développeur. En outre, pour empêcher l’emprunt d’identité entre services, consultez [Prévention interservices confuse des adjoints dans AWS](cross-service-confused-deputy-prevention.md) pour des exemples de politiques que vous devez appliquer.
## Activation des Profils des clients et spécification d’une file d’attente de lettres mortes et d’une clé KMS
**Magasin de données**
Choisissez d'activer ou non le stockage des données. Il est nécessaire d'utiliser une segmentation basée sur Spark SQL et des informations prédictives. Si vous choisissez de ne pas activer le magasin de données lors de la création d'un domaine, vous pouvez l'activer une fois le domaine créé et utilisé. Vous ne pouvez pas désactiver le stockage des données une fois qu'il a été activé.
Vous pouvez activer le stockage des données en cliquant sur le bouton d'activation dans le bandeau bleu de la page Profils clients (panneau de gauche > **Profils clients**). Vous verrez cette bannière bleue une fois que vous aurez créé votre domaine.
Le magasin de données nécessite une clé gérée par le client (CMK) et vous invitera à créer une clé gérée par le client (CMK) si vous n'en avez pas encore activé une pour votre domaine.
**Important**
Lorsque vous utilisez Data Vault, Customer Profiles stocke vos données par type d'objet et les chiffre à l'aide de votre clé AWS KMS. Customer Profiles normalise les noms de vos types d'objets en :
Conversion du nom en minuscules
Conversion des traits d'union en traits de soulignement \$1
Ajouter le terme « standard » à tout type d'objet standard de Customer Profiles
Ajouter un « domaine » à n'importe quel type d'objet de domaine Customer Profiles
Ajouter « domain\$1standard » à tout type d'objet de domaine standard de Customer Profiles
Vous ne pouvez pas activer le magasin de données si Customer Profiles détecte des conflits de dénomination. Une fois que vous avez activé Data Store, vous ne pouvez pas créer de types d'objets qui entrent en conflit avec les noms de types d'objets existants dans le cadre de ces règles de normalisation.
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[Page Instances du centre de contact virtuel Amazon Connect, alias d’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/instance.png)
1. Dans le volet de navigation, choisissez **Profils des clients**.
La page **Domaine de profils client** répertorie les applications disponibles pour l’intégration. Dans l’image suivante, la page montre qu’aucun domaine de profil de client n’a été activé.
![\[La page de profil de client, le bouton Activer les profils client.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-domains-page.png)
1. Choisissez **Activer les profils client** pour commencer.
1. Sur la page **Activer les profils client**, choisissez **Créer un domaine**. Sous **Spécifier un domaine**, entrez un nom convivial qui vous tient à cœur, tel que le nom de votre organisation, par exemple, *CustomerProfiles- ExampleCorp*.
![\[La page Activer les profils client.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-domain.png)
1. Sous **Spécifier une file d’attente de lettres mortes**, indiquez si vous souhaitez envoyer les événements ayant échoué vers une file d’attente de lettres mortes. Cela est utile si vous souhaitez avoir de la visibilité sur les données qui n’ont pas pu être ingérées. Cela vous donne également la possibilité de réessayer plus tard es ingestions de données ayant échoué.
Voici les étapes pour créer une file d’attente de lettres mortes :
+ Sur la page **Activer les profils client**, choisissez **Créer ou sélectionner une file d’attente SQS existante**, puis **Créer une file d’attente de lettres mortes**.
![\[L’option Créer ou sélectionner une file d’attente SQS existante.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png)
+ Un nouvel onglet s’ouvre dans votre navigateur pour la console Amazon SQS. Choisissez **Créez une file d’attente**.
+ Sur la page **Créer une file d’attente**, choisissez **Standard**, puis attribuez un nom à votre file d’attente.
![\[La page Créer une file d’attente.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png)
+ Dans la section **Stratégie d’accès**, choisissez **Avancé**.
Le nom de la version, l’ID de politique et l’instruction apparaissent. Si nécessaire, mettez à jour cette section pour n’autoriser l’accès qu’aux rôles appropriés.
+ À la fin de la section Instruction (ligne 15 dans l’image suivante), ajoutez une virgule après \$1, puis appuyez sur `Enter`.
![\[La section Stratégie d’accès.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png)
+ Ensuite, copiez et collez le code suivant :
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
+ Pour remplacer *region**accountID*, et *YourQueueName* avec vos informations, copiez et collez les `Resource` informations de la ligne 14.
![\[La section Stratégie d’accès, les informations Ressources.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png)
+ Choisissez **Créez une file d’attente**.
+ Revenez à l’onglet de votre navigateur qui affiche la page **Activer les profils client** de la console Amazon Connect. Cliquez ou appuyez dans la case **Choisir une file d’attente SQS existante** pour sélectionner la file d’attente que vous venez de créer dans la liste déroulante.
![\[La file d’attente SQS dans la liste déroulante.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png)
1. Sous **Spécifier une clé KMS**, créez ou entrez votre AWS KMS key à des fins de chiffrement. Suivez les étapes suivantes pour créer votre AWS KMS key :
+ Sur la page **Activer les profils client**, choisissez **Créer une AWS KMS key**.
![\[La page Activer les profils client, le bouton Créer une AWS KMS key .\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-kms-key.png)
+ Un nouvel onglet s’ouvre dans votre navigateur pour la console Key Management Service (KMS). Sur la page **Configurer la clé**, choisissez **Symétrique**, puis **Suivant**.
![\[Page Configurer la clé, option Symétrique.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
+ Sur la page **Ajouter des étiquettes**, ajoutez un nom et une description pour la clé, puis choisissez **Suivant**.
![\[Page Ajouter des étiquettes.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png)
+ Sur la page **Définir des autorisations d’administration de clé**, choisissez **Suivant**.
+ Sur la page **Définir des autorisations d’utilisation de clé**, choisissez **Suivant**.
+ Sur la page **Vérifier et modifier une stratégie de clé**, choisissez **Terminer**.
Dans l’exemple suivant, le nom de la clé commence par **bcb6fdd** :
![\[Page Clés gérées par le client.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png)
+ Revenez à l’onglet de votre navigateur qui affiche la page **Activer les profils client** de la console Amazon Connect. Cliquez ou appuyez sur la case **Spécifier une clé KMS** pour faire apparaître la clé que vous avez créée dans une liste déroulante. Choisissez la clé que vous avez créée.
![\[La section Spécifier une clé KMS.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png)
1. Sous **Stockage des données**, indiquez si vous souhaitez activer le stockage des données. Il est nécessaire d'utiliser une segmentation basée sur Spark SQL et des informations prédictives. Si vous choisissez de ne pas activer le magasin de données lors de la création d'un domaine, vous pouvez l'activer une fois le domaine créé et utilisé. Vous ne pouvez pas désactiver le stockage des données une fois qu'il a été activé.
Si vous possédez déjà un domaine sans magasin de données, vous pouvez l'activer en cliquant sur le bouton d'activation dans le bandeau bleu de la page Profils clients (panneau de gauche > Profils clients)
Le magasin de données nécessite une clé gérée par le client (CMK) et vous invitera à créer une clé gérée par le client (CMK) si vous n'en avez pas encore activé une pour votre domaine.
1. Sélectionnez **Soumettre**. Une fois terminé, la page ressemble à l’image suivante. Elle indique le nom du domaine des profils des clients, la file d’attente de lettres mortes et la clé KMS.
![\[La page Domaine des profils des clients terminés.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-final.png)
Vous avez terminé \$1 La fonctionnalité Profils des clients Amazon Connect est activée. Désormais, à chaque nouveau contact, Amazon Connect crée un enregistrement de profil de client. Il suit ensuite l’historique des contacts pour ce numéro de téléphone (conversation vocale) ou cette adresse e-mail (chat).
Vos agents peuvent [créer de nouveaux profils des clients](ag-cp-create.md) et consulter les enregistrements des contacts de vos clients.
## Étapes suivantes
1. [Disponibilité des Profils des clients via l’application d’agent](customer-profile-access.md).
1. [Attribution d’autorisations aux agents pour accéder aux Profils des clients dans l’application d’agent](assign-security-profile-customer-profile.md).
1. [Intégration avec des applications externes qui profilent des données de profil de client (facultatif)](integrate-external-apps-customer-profiles.md).
1. [Activation de la Résolution d’identité pour identifier deux ou plusieurs profils similaires et les consolider](use-identity-resolution.md).
# Démarrage avec les modèles de ressources du secteur
La fonctionnalité Profils des clients Amazon Connect fournit des modèles de ressources du secteur pour configurer rapidement votre domaine avec des attributs calculés, des segments et des mises en page de l’Explorateur de profils adaptées à des secteurs d’activité spécifiques.
## Avant de commencer
Avant d’activer les modèles de ressources du secteur, assurez-vous de disposer des éléments suivants :
+ Une instance Amazon Connect avec les Profils de clients activés
+ Les autorisations appropriées pour créer des ressources dans votre domaine de Profils de clients
## À propos des modèles de ressources du secteur
Lorsque vous activez un modèle de secteur, les Profils de clients créent automatiquement les ressources suivantes dans votre domaine :
+ Définitions d’attributs calculés - Attributs prédéfinis dérivés des données de vos clients
+ Définitions des segments - Regroupements de clients basés sur des caractéristiques communes
+ Mises en page de l’Explorateur de profils - Vues de tableau de bord personnalisées pour visualiser les informations sur les clients
Ces ressources sont conçues pour vous aider à valoriser rapidement les données de vos clients sans avoir à créer manuellement chaque ressource.
## Activer les modèles de ressources du secteur
1. Sur la page d’accueil des Profils de clients, recherchez la section Modèles de secteur.
+ Si vous configurez des Profils de clients pour la première fois, une annonce apparaît en haut de la page.
![\[La bannière permettant d’activer les modèles s’affiche si c’est la première fois que vous utilisez des profils de clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-industry-resource-templates-1.png)
+ Si vous avez déjà des ressources dans votre domaine, la liste des modèles activés apparaît dans la section Modèles de secteur.
![\[Si vous avez déjà utilisé des profils de clients, la liste des modèles activés apparaît dans la section Modèles de secteur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-industry-resource-templates-2.png)
1. Pour activer un modèle, choisissez **Activer un modèle**.
1. Dans le menu déroulant **Sélectionner un modèle**, choisissez le secteur qui correspond le mieux à votre activité :
+ **Compagnie aérienne** - Pour les entreprises de transport aérien
+ **Hôtel** - Pour les entreprises du secteur de l’hôtellerie
1. Passez en revue les ressources qui seront créées dans la section **Vérifier les ressources**.
![\[Vérifiez les ressources qui seront créées.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-industry-resource-templates-3.png)
1. Choisissez **Activer le modèle**.
1. Attendez que les ressources soient créées. Assurez-vous de garder l’onglet du navigateur ouvert pendant que la création de la ressource est en cours.
1. Une fois terminé, vous verrez un message de confirmation et le modèle apparaîtra dans la section Modèles de secteur avec le nombre de ressources créées.
![\[La bannière Création réussie s’affiche.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-industry-resource-templates-4.png)
## Ressources créées par des modèles de secteur
### Modèle pour le secteur du transport aérien
#### Attributs calculés
Le modèle du transport aérien crée des attributs calculés dans plusieurs catégories :
**Attributs calculés du transport aérien**
| Nom d’attribut calculé | Nom d’affichage | Description | Type d’objet |
| --- | --- | --- | --- |
| air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | Aéroport de départ préféré | Renvoie l’aéroport de départ préféré le plus récemment configuré par le client. | \$1airPreference |
| air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | Aéroport d’arrivée préféré | Renvoie l’aéroport d’arrivée préféré le plus récemment configuré par le client. | \$1airPreference |
| air\$1airPreference\$1travel\$1type\$1last\$1occurrence | Type de voyage préféré | Renvoie le type de voyage préféré le plus récemment configuré par le client. | \$1airPreference |
| air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Préférences de consentement marketing | Renvoie le dernier paramètre de consentement marketing configuré par le client. | \$1airPreference |
| air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | Langue préférée en présentiel | Renvoie la dernière langue préférée du client pour les interactions en présentiel. | \$1airPreference |
| air\$1airPreference\$1seat\$1location\$1last\$1occurrence | Siège préféré | Renvoie le dernier siège préféré sélectionné par le client. | \$1airPreference |
| air\$1airPreference\$1home\$1airport\$1last\$1occurrence | Aéroport de résidence préféré | Renvoie le dernier aéroport de résidence indiqué par le client. | \$1airPreference |
| air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | Restriction alimentaire préférée | Renvoie la dernière restriction alimentaire indiquée par le client. | \$1airPreference |
| air\$1airBookings\$1number\$1of\$1passengers\$1average | Nombre moyen de passagers par réservation | Renvoie le nombre moyen de passagers sur l’ensemble des réservations du client. | \$1airBooking |
| air\$1airBookings\$1price\$1total\$1price\$1average | Prix moyen de réservation | Renvoie le prix moyen pour toutes les réservations du client. | \$1airBooking |
| air\$1airBookings\$1count | Nombre de réservations | Renvoie le nombre de réservations effectuées par un client. | \$1airBooking |
| air\$1airSegments\$1flight\$1delay\$1time\$1sum | Durée totale des retards de vols | Renvoie la durée totale des retards de vols subis par le client. | \$1airSegment |
| air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | Vols annulés au cours des 30 derniers jours | Renvoie le nombre de vols annulés par les clients au cours des 30 derniers jours. | \$1airSegment |
| air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | Vols retardés au cours des 30 derniers jours | Renvoie le nombre de vols retardés subis par les clients au cours des 30 derniers jours. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | Vols effectués au cours des 30 derniers jours | Renvoie le nombre de vols effectués par les clients au cours des 30 derniers jours. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | Vols effectués au cours de l’année écoulée | Renvoie le nombre de vols effectués par les clients au cours de l’année écoulée. | \$1airSegment |
| air\$1airSegment\$1departure\$1date\$1last\$1occurrence | Date de départ du dernier vol | Renvoie la date de départ du dernier vol du client. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum | Total de miles parcourus | Renvoie la somme de toutes les distances de vol en miles pour un client. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | Miles parcourus l’année dernière | Renvoie la somme des miles parcourus en vol par le client au cours de l’année écoulée. | \$1airSegment |
| air\$1airSegments\$1business\$1first\$1class\$1count | Nombre de vols en classe premium | Renvoie le nombre de vols réservés par les clients en classe affaires ou en première classe. | \$1airSegment |
| air\$1loyalties\$1points\$1redeemed\$1sum | Total des points de fidélité échangés | Renvoie la somme totale des points échangés dans le cadre de tous les programmes de fidélité. | \$1loyalty |
| air\$1loyalties\$1count | Nombre d’adhésions à des programmes de fidélité | Renvoie le nombre d’adhésions à des programmes de fidélité détenues par le client. | \$1loyalty |
| air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Points pour le niveau suivant | Renvoie le plus récent record de points requis par le client pour atteindre le niveau de fidélité suivant. | \$1loyalty |
| air\$1loyalty\$1points\$1balance\$1last\$1occurrence | Solde actuel de points de fidélité | Renvoie le solde de points de fidélité le plus récent du client. | \$1loyalty |
| air\$1loyalty\$1membership\$1id\$1last\$1occurrence | Numéro de membre du programme de fidélité actuel | Renvoie l’identifiant de membre de programme de fidélité le plus récent du client. | \$1loyalty |
| air\$1loyalty\$1program\$1name\$1last\$1occurrence | Nom actuel du programme de fidélité | Renvoie le nom du programme de fidélité le plus récent du client. | \$1loyalty |
| air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Date de la dernière inscription à un programme de fidélité | Renvoie la date d’inscription la plus récente du client à un programme de fidélité. | \$1loyalty |
| air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Niveau de fidélité actuel | Renvoie le statut le plus récent du programme de fidélité du client. | \$1loyalty |
| air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Nombre d’abonnements de niveau premium | Renvoie le nombre de programmes de fidélité de niveau Argent. | \$1loyalty |
| air\$1loyaltyPromotions\$1count | Nombre de promotions de fidélité | Renvoie le nombre total de promotions de fidélité reçues par le client. | \$1loyaltyPromotion |
#### Segments
Le modèle de compagnie aérienne crée les segments suivants :
+ [Compagnie aérienne] Abonnés marketing
+ [Compagnie aérienne] Clients dont les vols ont été annulés au cours des 30 derniers jours
+ [Compagnie aérienne] Clients dont les vols ont été retardés au cours des 30 derniers jours
+ [Compagnie aérienne] Clients ayant effectué des vols au cours des 30 derniers jours
+ [Compagnie aérienne] Membres inactifs
#### Mise en page de l’Explorateur de profils
Une mise en page de démonstration de l’Explorateur de profils est créée avec comme nom : `DEMO-Airline-Layout`, qui comprend les widgets suivants :
+ Informations sur le client et coordonnées
+ Statut du programme de fidélité et points
+ Réservations et vols récents
+ Préférences du client
+ Métriques de valeur du client
+ Indicateurs de satisfaction du client
### Modèle pour le secteur hôtelier
#### Attributs calculés
Le modèle du secteur hôtelier crée des attributs calculés dans plusieurs catégories :
**Attributs calculés du secteur hôtelier**
| Nom d’attribut calculé | Nom d’affichage | Description | Type d’objet |
| --- | --- | --- | --- |
| hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | Type de chambre préféré | Renvoie le type de chambre préféré le plus récemment configuré par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | Horaire de ménage préférée | Renvoie l’horaire de ménage préférée le plus récemment configurée par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | Vue préférée depuis la chambre | Renvoie la vue depuis la chambre préférée le plus récemment configurée par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | Méthode d’enregistrement préférée | Renvoie la méthode d’enregistrement préférée le plus récemment configurée par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | Méthode de départ de l’hôtel préférée | Renvoie la méthode de départ de l’hôtel préférée le plus récemment configurée par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | Type de la dernière demande spéciale | Renvoie le type d’hébergement spécial le plus récemment demandé par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | Intérêt le plus fréquent | Renvoie les intérêts ou les préférences en matière de commodités les plus fréquemment exprimés par le client. | \$1hotelPreference |
| hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Préférences de consentement marketing | Renvoie le dernier paramètre de consentement marketing configuré par le client. | \$1hotelPreference |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | Durée moyenne du séjour | Renvoie la durée moyenne de séjour pour toutes les réservations d’hôtel des clients. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | Nombre total de nuits au cours de l’année écoulée | Renvoie le nombre total de nuits passées au cours de l’année écoulée pour toutes les réservations des clients. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | Total de nuits | Renvoie le nombre total de nuits passées pour toutes les réservations d’hôtel des clients. | \$1hotelReservation |
| hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | Dernier type de chambre réservé | Renvoie le type de chambre le plus récemment réservé par le client. | \$1hotelReservation |
| hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | Dernier canal de réservation utilisé | Renvoie le canal le plus récemment utilisé par le client pour la réservation d’hôtel. | \$1hotelReservation |
| hotel\$1hotelReservations\$1count | Nombre de réservations | Renvoie le nombre de réservations d’hôtel effectuées par un client. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | Dépenses moyennes en réservation | Renvoie le montant moyen dépensé par réservation d’hôtel après taxes. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | Total des dépenses hôtelières | Renvoie le montant total dépensé pour toutes les réservations d’hôtel du client après taxes. | \$1hotelReservation |
| hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | Taille de groupe la plus courante | Indique le nombre de personnes le plus fréquemment réservé par le client, tous séjours confondus. | \$1hotelReservation |
| hotel\$1hotelReservations\$1business\$1travel\$1count | Nombre de voyages d’affaires | Retourne le nombre de réservations de clients marquées comme des voyages d’affaires. | \$1hotelReservation |
| hotel\$1hotelReservations\$1missed\$1checkin\$1count | Nombre d’enregistrements manqués | Renvoie le nombre de réservations pour lesquelles le client ne s’est pas enregistré. | \$1hotelReservation |
| hotel\$1hotelReservation\$1cancelled\$1count | Nombre de réservations annulées | Renvoie le nombre de réservations d’hôtel annulées par un client. | \$1hotelReservation |
| hôtel\$1 \$1amount\$1sum hotelStayRevenues | Total des recettes générées | Renvoie le total des recettes générés par tous les séjours hôteliers des clients. | \$1hotelStayRevenue |
| hotel\$1 \$1amount\$1average hotelStayRevenues | Revenu moyen par séjour | Renvoie le montant des recettes calculé sur l’ensemble des séjours des clients. | \$1hotelStayRevenue |
| hôtel\$1 \$1montant\$1maximum hotelStayRevenues | Montant de revenus le plus élevé | Renvoie le plus gros montant généré par un séjour client. | \$1hotelStayRevenue |
| hôtel\$1 \$1revenue\$1type\$1max\$1occurrence hotelStayRevenue | Source de revenus la plus courante | Renvoie le type de revenu le plus fréquemment généré lors des séjours hôteliers des clients. | \$1hotelStayRevenue |
| hotel\$1loyalties\$1points\$1redeemed\$1sum | Total des points de fidélité échangés | Renvoie la somme totale des points échangés dans le cadre de tous les programmes de fidélité. | \$1loyalty |
| hotel\$1loyalties\$1count | Nombre d’adhésions à des programmes de fidélité | Renvoie le nombre d’adhésions à des programmes de fidélité détenues par le client. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Points pour le niveau suivant | Renvoie le plus récent record de points requis par le client pour atteindre le niveau de fidélité suivant. | \$1loyalty |
| hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | Solde actuel de points de fidélité | Renvoie le solde de points de fidélité le plus récent du client. | \$1loyalty |
| hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | Numéro de membre du programme de fidélité actuel | Renvoie l’identifiant de membre de programme de fidélité le plus récent du client. | \$1loyalty |
| hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | Nom actuel du programme de fidélité | Renvoie le nom du programme de fidélité le plus récent du client. | \$1loyalty |
| hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Date de la dernière inscription à un programme de fidélité | Renvoie la date d’inscription la plus récente du client à un programme de fidélité. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Niveau de fidélité actuel | Renvoie le statut le plus récent du programme de fidélité du client. | \$1loyalty |
| hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Nombre d’abonnements de niveau premium | Renvoie le nombre de programmes de fidélité de niveau Argent. | \$1loyalty |
| hotel\$1loyaltyPromotions\$1count | Nombre de promotions de fidélité | Renvoie le nombre total de promotions de fidélité reçues par le client. | \$1loyaltyPromotion |
#### Segments
Le modèle d’hôtel crée des segments tels que :
+ [Hotel] Abonnés marketing préférentiel
+ [Hôtel] Voyageurs en solo
+ [Hôtel] Voyageurs en couple ou en binôme
+ [Hôtel] Voyageurs en famille ou en groupe
+ [Hôtel] Clients ayant une réservation à venir dans 30 jours
#### Mise en page de l’Explorateur de profils
Une mise en page personnalisée qui affiche :
+ Informations sur le client et coordonnées
+ Préférences de chambre
+ Historique des séjours
+ Informations relatives aux revenus
+ Statut de fidélité
## Désactivation des modèles de secteur
Vous pouvez désactiver un modèle de secteur pour supprimer les ressources qu’il a créées de votre domaine. Pour désactiver un modèle, procédez comme suit :
1. Sur la page d’accueil des Profils de clients, recherchez la section Modèles de secteur.
1. Recherchez le modèle que vous souhaitez désactiver et choisissez **Désactiver** l’action.
1. Consultez le message de confirmation et choisissez **Confirmer** pour désactiver le modèle.
**Important**
Lorsque vous désactivez un modèle, toutes les ressources créées par ce modèle sont supprimées de votre domaine. Si l’une de ces ressources est utilisée dans des segments de clients, des campagnes sortantes ou des flux de contacts, la désactivation du modèle peut avoir un impact sur elle.
Avant de désactiver un modèle, passez en revue les ressources utilisées pour comprendre l’impact potentiel.
## Résolution des problèmes
**Dépannage des modèles de secteur**
| Erreur | Recommendation |
| --- | --- |
| Les ressources du modèle n’ont pas pu être créées | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| Les ressources créées ne s’affichent pas dans l’Explorateur de profils | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| Impossible d’activer plusieurs modèles | Plusieurs modèles de secteur peuvent être activés pour chaque domaine. Si vous rencontrez des problèmes, vérifiez que vous n’avez pas atteint les limites de ressources pour votre domaine. |
| Besoin de supprimer des ressources de modèle | Actuellement, la fonctionnalité de démarrage ne permet pas de supprimer automatiquement toutes les ressources créées par un modèle. Vous pouvez supprimer manuellement des ressources individuelles via leurs pages de gestion respectives. |
## Étapes suivantes
Après avoir activé un modèle de secteur, vous pouvez :
+ Accéder à l’Explorateur de profils pour voir votre nouvelle mise en page en action
+ Afficher et modifier les attributs calculés pour mieux répondre à vos besoins spécifiques
+ Gestion des segments clients dans Amazon Connect
+ Modifier la mise en page de l’Explorateur de profils en fonction des besoins de votre entreprise
+ Intégrer des applications externes aux Profils des clients Amazon Connect pour commencer à remplir les profils
# Accès aux Profils des clients Amazon Connect dans l’espace de travail de l’agent
Après avoir activé les profils Amazon Connect clients, les agents peuvent commencer à interagir avec les clients et accéder aux [informations des clients](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html) pour fournir un service personnalisé. Cette rubrique explique comment accéder à l'espace de travail de l' Amazon Connect agent.
**Astuce**
Assurez-vous que vos agents disposent des autorisations **Profils des clients** dans leur profil de sécurité afin qu’ils puissent accéder à la fonctionnalité Profils des clients. Pour de plus amples informations, veuillez consulter [Autorisations du profil de sécurité pour Profils des clients Amazon Connect](assign-security-profile-customer-profile.md).
## Option 1 : Utiliser les profils des clients avec le CCP out-of-the-box
La fonctionnalité Profils des clients est déjà intégrée au Panneau de configuration des contacts (CCP). Vos agents peuvent accéder au CCP, aux profils clients et à Amazon Connect la gestion des dossiers dans la même fenêtre de navigateur en se connectant à leur Amazon Connect instance et en cliquant sur le bouton **Agent Workspace** situé dans le coin supérieur droit, comme indiqué dans l'image suivante.
![\[La page Profils des clients et le bouton surligné qui ouvre l’espace de travail de l’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png)
**Note**
Vous pouvez également accéder à l’espace de travail de l’agent à l’aide de l’URL suivante :
**https ://*instance name*.my.connect.aws/ agent-app-v 2/**
Si vous accédez à votre instance via le domaine **awsapps.com**, utilisez l’URL suivante :
**https ://*instance name*.awsapps. com/connect/agent-app-v2/**
Pour trouver le nom de votre instance, consultez [Trouvez le nom de votre instance Amazon Connect](find-instance-name.md).
Voici un exemple de ce à quoi ressemblent la fonctionnalité Profils des clients dans l’espace de travail des agents.
![\[L’onglet Profils des clients et le CCP dans l’espace de travail de l’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-agent-app.png)
## Option 2 : Intégrer la fonctionnalité Profils des clients dans un espace de travail d’agent personnalisé
Lorsque vous intégrez votre Panneau de configuration des contacts (CCP), vous avez la possibilité d’afficher ou de masquer l’interface utilisateur CCP préconçue. Par exemple, vous souhaiterez peut-être développer un espace de travail d’agent personnalisé doté d’une interface utilisateur que vous concevez, avec des boutons personnalisés pour accepter et rejeter les appels. Vous voudrez peut-être également intégrer le CCP préconçu inclus dans Amazon Connect à une autre application personnalisée.
Que vous affichiez l’interface utilisateur CCP pré-conçue ou que vous la masquiez et que vous créiez la vôtre, vous utilisez la bibliothèque [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) pour intégrer le CCP et la fonctionnalité Profils des clients dans l’espace de travail de l’agent. Amazon Connect Streams est ainsi initialisé et l’agent peut se connecter et s’authentifier auprès d’Amazon Connect et de la fonctionnalité Profils des clients.
Pour plus d’informations sur l’intégration de la fonctionnalité Profils des clients, consultez [Initialization for CCP, Customer Profiles, and Wisdom](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom).
Pour créer votre propre widget en utilisant les données brutes des profils clients, consultez la documentation [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) sur l'utilisation de la bibliothèque open source CustomerProfiles JS.
**Astuce**
Lorsque vous personnalisez l’espace de travail de l’agent, vous déterminez l’URL que les agents utiliseront pour accéder à leur espace de travail d’agent, qui peut être très différente de celle fournie par Amazon Connect. Par exemple, votre URL peut être https://example-corp.com/agent-support-app.
# Remplissage automatique des profils des clients
Par défaut, la fonctionnalité Profils des clients Amazon Connect utilise les valeurs suivantes pour rechercher et renseigner automatiquement un profil client dans son interface utilisateur :
+ Pour les contacts vocaux : numéro de téléphone
+ Pour les contacts par chat : adresse e-mail
Il renseigne automatiquement un profil client à l’aide du bloc de flux Profils des clients. Pour personnaliser ce comportement, utilisez le bloc [Définir des attributs de contact](set-contact-attributes.md) (voir ci-dessous) pour les attributs de contact suivants :
| Attribut | Description | Type | JSONPath Référence |
| --- | --- | --- | --- |
| profileSearchKey | Le nom de l’attribut que vous souhaitez utiliser pour rechercher un profil. | Défini par l’utilisateur | Non applicable |
| profileSearchValue | La valeur de la clé que vous souhaitez rechercher, telle que le nom du client ou le numéro de compte. | Défini par l’utilisateur | Non applicable |
Par exemple, pour rechercher des communications par chat par adresse e-mail, vous pouvez définir l’attribut `profileSearchKey` sur la clé de recherche `_email` et fournir la valeur de l’adresse e-mail comme `profileSearchValue`.
Si vous avez défini des clés personnalisées dans les objets de votre profil, vous pouvez également effectuer une recherche à l’aide de ces clés de recherche. Pour vous assurer que vos clés personnalisées peuvent être recherchées, consultez [Détails de la définition de clé](object-type-mapping-definition-details.md#key-definition-details).
L’image suivante montre comment vous pouvez utiliser ces attributs dans le bloc [Définir des attributs de contact](set-contact-attributes.md).
![\[La page des propriétés du bloc Définir des attributs de contact.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-attributes1.png)
## Association automatique d’un profil client à un contact
Par défaut, les agents doivent associer manuellement un profil client à un contact après avoir vérifié l’identité du client. Pour modifier ce comportement afin d’associer automatiquement les contacts à un profil en fonction du numéro de téléphone, consultez [Associez l’enregistrement de contact à un profil trouvé à l’aide de la clé \$1phone dans Profils des clients](auto-associate-profile-using-phone-profile-key.md).
Si plusieurs profils correspondent au numéro de téléphone d’un contact, les différents profils correspondants sont présentés à l’agent. L’agent doit choisir le profil à associer au contact.
# Autorisations du profil de sécurité pour Profils des clients Amazon Connect
Attribuez des autorisations aux profils de sécurité de vos agents afin qu’ils puissent effectuer des tâches telles que rechercher des profils et consulter les informations des clients, associer des enregistrements de contacts à des profils, modifier des profils et créer et enregistrer de nouveaux profils. Les rubriques de cette section vous aident à attribuer des autorisations en mettant à jour les autorisations pour les agents, les flux et les attributs calculés. Il existe également des informations pour vous aider à résoudre une erreur survenant lors de la mise à jour des autorisations.
**Topics**
+ [Mise à jour des autorisations des Profils des clients pour les agents](security-profile-customer-profile-agent.md)
+ [Mise à jour des autorisations Profils des clients pour les flux](security-profile-customer-profile-contact-flows.md)
+ [Mise à jour des autorisations pour les attributs calculés](security-profile-customer-profile-calc-attribs.md)
+ [Autorisations du profil de sécurité pour les segments clients](security-profile-customer-profile-segmentation.md)
+ [Attribution de nouvelles autorisations aux profils clients en cas d’erreur](security-profile-customer-profile-issues.md)
# Mise à jour des autorisations des Profils des clients pour les agents
Attribuez les autorisations **Profils des clients** suivantes selon les besoins au profil de sécurité de l’agent :
+ **Afficher** : permet aux agents de consulter l’application Profils des clients. Elles peuvent :
+ Afficher les profils renseignés automatiquement dans l’application de l’agent.
+ Recherche des profils.
+ Afficher les informations stockées dans les profils des clients (par exemple : nom, adresse).
+ Associer les enregistrements de contact aux profils, comme illustré dans l’image suivante.
![\[L’onglet Profils des clients dans l’espace de travail de l’agent, le bouton Associer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-associate.png)
+ **Modifier** : permet aux agents de modifier les informations du profil du client (par exemple : changer d’adresse). Ils héritent des autorisations **Afficher** par défaut.
+ **Créer** : permet aux agents de créer et d’enregistrer un nouveau profil. Ils héritent des autorisations **Afficher** par défaut, mais n’héritent pas des autorisations **Modifier**.
Pour en savoir plus sur l’ajout d’autorisations à un profil de sécurité existant, consultez [Mise à jour de profils de sécurité dans Amazon Connect](update-security-profiles.md).
Par défaut, le profil de sécurité **Administrateur** est déjà autorisé à effectuer toutes les activités Profils des clients.
# Mise à jour des autorisations Profils des clients pour les flux
1. Accédez à la page des profils de sécurité, choisissez le profil de sécurité que vous souhaitez modifier ou choisissez **Ajouter un profil de sécurité**.
![\[Page des profils de sécurité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Sélectionnez l’autorisation **Afficher** pour les profils des clients.
![\[Sélectionnez les autorisations d’affichage dans la page des profils de sécurité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png)
1. Choisissez **Enregistrer**. Vous pouvez désormais accéder à la section **Gestion des utilisateurs** et fournir ce profil de sécurité aux utilisateurs de votre choix.
# Mise à jour des autorisations pour les attributs calculés dans Profils des clients Amazon Connect
1. Accédez à la page des profils de sécurité, choisissez le profil de sécurité que vous souhaitez modifier ou choisissez **Ajouter un profil de sécurité**.
![\[Page des profils de sécurité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Sélectionnez l’autorisation **Tout** ou les autorisations **Afficher**, **Modifier**, **Créer** et **Supprimer** pour les attributs calculés.
![\[Sélectionnez les autorisations Afficher, Modifier, Créer et Supprimer dans la console des profils de sécurité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png)
1. Choisissez **Enregistrer**. Vous pouvez désormais accéder à la section **Gestion des utilisateurs** et fournir ce profil de sécurité aux utilisateurs de votre choix.
# Attribution d’autorisations de profil de sécurité pour gérer les segments clients
Attribuez les autorisations Profils des clients suivantes selon les besoins au profil de sécurité de l’utilisateur : Pour plus de détails sur les profils de sécurité, consultez [Profils de sécurité pour l’accès à Amazon Connect et au Panneau de configuration des contacts (CCP)](connect-security-profiles.md).
1. Accédez à la page des profils de sécurité, choisissez le profil de sécurité que vous souhaitez modifier ou choisissez **Ajouter un profil de sécurité**.
![\[La page des profils de sécurité, la section des profils clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png)
1. Sélectionnez **Tous** ou **Afficher**, **Créer**, **Supprimer** et **Exporter** l’autorisation des segments clients.
![\[L’autorisation des segments du client est définie sur Tous.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png)
1. Choisissez **Enregistrer**. Vous pouvez désormais accéder à la section **Gestion des utilisateurs** et fournir ce profil de sécurité aux utilisateurs de votre choix.
# Attribution de nouvelles autorisations aux profils clients en cas d’erreur
1. Pour mettre à jour les autorisations en cas d'erreur d'appel interdit 403 pour l'un des backend APIs, accédez à la section domaine de la console Amazon Connect Customer Profiles et choisissez **Afficher les détails**.
![\[La section domaine de la console Amazon Connect Customer Profiles.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png)
1. Choisissez **Mettre à jour les autorisations** dans la section d’affichage des détails du domaine.
![\[Le bouton Mettre à jour les autorisations apparaît ici si des autorisations en suspens doivent être mises à jour.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png)
1. Une fois cela fait, les autorisations seront mises à jour avec succès et le bouton **Mettre à jour les autorisations** ne sera plus visible dans la section des détails du domaine. Cela atténuera le problème d’erreur interdite 403 et vous pourrez effectuer des appels d’API.
![\[Le bouton Mettre à jour les autorisations disparaît une fois l’action terminée avec succès.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png)
# Expiration des données de Profils des clients Amazon Connect
Si un profil n’a pas été mis à jour dans un délai spécifié, il expirera. Cela entraînera le nettoyage du profil et sa suppression du domaine des profils de clients.
Le délai d’expiration des données des profils de clients dépend de deux catégories différentes :
## Profils créés via CreateProfile
Les profils créés à l'aide de l'`CreateProfile`API expireront en fonction de l'horodatage attribué par **DefaultExpirationDays**un domaine de profils clients. Si aucune date d’expiration n’a été configurée, la valeur par défaut est de 365 jours.
## Profils créés ou mis à jour via PutProfileObject
Les profils créés ou mis à jour en utilisant `PutProfileObject` respecteront toujours ceux **ExpirationDays**définis sur le type d'objet qui leur est associé. Si aucune date d’expiration n’est définie pour le type d’objet, la date d’expiration du domaine des profils de clients sera utilisée. Enfin, si aucun des deux n’est fourni, le profil ou l’objet de profil expirera au délai par défaut de 365 jours.
## Modèle mental visualisé
![\[Un organigramme montrant la logique d’expiration des profils des clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-expiration-model.png)
## Expiration d’un profil importé
Si un profil a été importé dans un domaine de profils de clients à l’aide de l’importation de segments, son expiration se fera selon deux scénarios différents.
1. **Définition explicite de l'expiration lors de l'appel CreateUploadJob**
Par défaut, les profils importés via l’importation de segments expireront dans 14 jours si aucune mise à jour n’a été effectuée. Ce nombre [peut être défini](customer-segments-imported-files.md#set-profile-expiry) à l'aide de l'API ou sur le site Web Amazon Connect d'administration lors de la création de l'importation, avec un maximum de 90 jours.
1. **Importation de profils qui existent déjà dans votre domaine de profils clients à partir d’une tâche d’importation précédente**
Si deux tâches d’importation ont été exécutées et qu’un profil dupliqué a été détecté, les profils clients respecteront toujours le délai d’expiration le plus long.
# Utilisation de la Résolution d’identité pour consolider des profils similaires dans Amazon Connect
Un *profil similaire* se produit lorsqu’il est déterminé que deux profils ou plus correspondent au même contact. Il peut y avoir plusieurs profils lorsque les enregistrements de clients sont capturés sur plusieurs canaux et applications pour le même client et qu’ils ne partagent pas un identifiant unique commun.
La Résolution d’identité trouve automatiquement les profils similaires et vous aide à les consolider. Il exécute une Tâche de résolution d’identité sur une base hebdomadaire, qui exécute les étapes suivantes :
1. [Correspondance automatique des profils](how-identity-resolution-works.md#auto-profile-matching)
1. [Fusion automatique des profils similaires](how-identity-resolution-works.md#auto-profile-merging) en fonction de vos critères de consolidation
Chaque fois qu’une Tâche de résolution d’identité s’exécute, elle affiche des métriques sur la page **Profils des clients**. Les métriques indiquent le nombre de profils examinés, le nombre de groupes correspondants trouvés et le nombre de profils consolidés.
Des frais supplémentaires peuvent être facturés pour activer la Résolution d’identité. Pour plus d’informations, consultez [Tarification d’Amazon Connect](https://aws.amazon.com/connect/pricing/).
![\[La page Profils des clients Amazon Connect, le bouton Activer la résolution d’identité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Activation de la Résolution d’identité pour votre domaine Profils des clients Amazon Connect
**Important**
Amazon Connect Cases n'est pas totalement compatible avec Amazon Connect Customer Profiles Identity Resolution lors de l'utilisation de l'espace de travail des agents. Voici ce qui arrive aux cas existants lorsque des profils sont fusionnés :
Les cas restent liés à leur identifiant de profil d’origine après une fusion.
Les cas ne sont pas automatiquement consolidés entre les profils fusionnés.
Il n’existe aucune méthode prise en charge pour réassocier un cas existant à un autre profil. Utilisez [CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html)et [CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html)comme solution de contournement si vous devez consolider les dossiers manuellement.
Lorsque vous activez la Résolution d’identité, vous spécifiez les informations suivantes :
+ Quand la Tâche de résolution d’identité doit être exécutée sur une base hebdomadaire. Par défaut, elle fonctionne le samedi à minuit (UTC).
+ Le compartiment Amazon S3 dans lequel la Tâche de résolution d’identité doit écrire les résultats du processus de correspondance automatique des profils. Si vous n’avez pas de compartiment S3, vous aurez la possibilité d’en créer un au cours du processus d’activation.
Vous pouvez interroger le compartiment Amazon S3 ou utiliser l'[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API pour filtrer les résultats [en fonction des scores de confiance](how-identity-resolution-works.md#confidence-score).
Après avoir activé la Résolution d’identité, vous verrez l’option permettant de [créer des critères de consolidation](create-consolidation-criteria.md) pour le processus de fusion automatique facultatif.
**Pour activer la Résolution d’identité**
1. Un domaine Profils des clients doit être activé pour votre instance. Pour obtenir des instructions, veuillez consulter [Activez les profils clients pour votre instance Amazon Connect.](enable-customer-profiles.md).
1. Dans le volet de navigation, choisissez **Profils des clients**.
1. Dans la section **Résolution d’identité**, choisissez **Activer la résolution d’identité**.
![\[La page Profils des clients Amazon Connect, le bouton Activer la résolution d’identité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
1. Dans la fenêtre contextuelle **Résolution d’identité**, choisissez **Activer la résolution d’identité**.
![\[La page Profils des clients Amazon Connect, le bouton Activer la résolution d’identité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png)
1. Sur la page **Activer la résolution d’identité**, spécifiez la date et l’heure auxquelles vous souhaitez que la Tâche de résolution d’identité s’exécute.
1. Si vous souhaitez consulter le profil correspondant IDs depuis un compartiment Amazon S3, sélectionnez **Écrire l'ID de profil correspondant à Amazon S3**. Sinon, vous pouvez utiliser l'[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API pour vérifier les profils correspondants.
**Note**
Si vous activez automatiquement les fusions, vous ne recevrez pas le profil correspondant. IDs
1. Spécifiez le compartiment Amazon S3 dans lequel la Tâche de résolution d’identité doit écrire les correspondances des profils.
Nous vous recommandons d’appliquer une politique afin d’éviter le problème de sécurité de l’adjoint confus. Pour plus d’informations et un exemple de politique, consultez [Prévention du problème de l’adjoint confus entre services pour la fonctionnalité Profils des clients Amazon Connect](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service).
1. Lorsque vous avez terminé, choisissez **Activer la résolution d’identité**. La correspondance paramétrable et la correspondance basée sur le machine learning sont activées une fois que vous avez activé la Résolution d’identité. Vous pouvez désactiver l’une d’entre elles ou les deux à partir de la page Résolution d’identité. Pour plus d’informations, consultez [Désactivation de la Résolution d’identité dans Profils des clients Amazon Connect](disable-identity-resolution.md).
1. Correspondance paramétrable pour la Résolution d’identité :
1. Une fois que vous avez activé la correspondance paramétrable avec un nouveau domaine, la correspondance commence immédiatement si vous avez configuré une intégration et que celle-ci est en cours d’exécution.
1. Une fois que vous avez activé la mise en correspondance paramétrable avec un domaine existant, le processus de mise en correspondance démarre dans l’heure qui suit.
1. Correspondance basée sur le machine learning pour la Résolution d’identité :
1. Une fois que vous avez activé la Résolution d’identité, la Tâche de résolution d’identité s’exécute pour la première fois dans les 24 heures.
**Note**
Avant d’exécuter une Tâche de résolution d’identité pour la première fois sur un nouveau domaine Profils des clients, nous vous recommandons de vérifier les métriques de votre profil pour vous assurer que les profils ont été créés. Dans le cas contraire, il n’y aura aucun résultat correspondant.
1. Vous souhaiterez peut-être définir des critères de consolidation pour la fusion automatique des profils correspondants. Si c’est le cas, consultez [Configuration des critères de consolidation pour la Résolution d’identité dans Amazon Connect](create-consolidation-criteria.md).
# Configuration des critères de consolidation pour la Résolution d’identité dans Amazon Connect
**Note**
Vous devez [activer la Résolution d’identité](#create-consolidation-criteria) pour accéder à l’option permettant de créer des critères de consolidation à l’aide de la console d’administration Amazon Connect.
Lorsque des profils similaires sont détectés par une Tâche de résolution d’identité, le processus peut les fusionner automatiquement dans un profil unifié en fonction des critères de consolidation que vous spécifiez.
Les attributs que vous sélectionnez sont comparés entre tous les profils similaires d’un groupe de correspondance pour obtenir une correspondance exacte. Par exemple, si vous spécifiez `email` comme attribut dans les critères, alors tous les profils similaires d’un groupe de correspondance ayant exactement la même valeur pour `email address` sont fusionnés dans un profil unifié.
**Astuce**
Si vous souhaitez configurer votre propre logique de fusion, utilisez l'[MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html)API.
## Restrictions
Vous pouvez sélectionner n’importe quel attribut dans le [profil standard](standard-profile-definition.md) pour comparer des profils similaires. Par exemple, vous pouvez choisir un numéro de téléphone, une adresse e-mail et un nom, ainsi que des attributs personnalisés.
Vous pouvez spécifier jusqu’à :
+ 10 critères de consolidation
+ 20 attributs par critère
## Conseils pour créer des critères solides
Pour améliorer le ciblage des profils uniques et éviter de consolider les profils qui ne sont pas des doublons, nous recommandons les étapes suivantes :
+ Sélectionnez des attributs qui permettent d’identifier un client de manière unique et qui ne sont pas susceptibles d’être identiques d’un client à l’autre, tels qu’un numéro de compte ou une pièce d’identité gouvernementale.
+ Évitez les critères à attribut unique. Sélectionnez plusieurs attributs pour créer une combinaison d’attributs afin d’améliorer le ciblage. Par exemple :
+ Le **Numéro de téléphone** avec le **Prénom**, le **Deuxième prénom**, le **Nom de famille** sont des critères plus solides
que
+ Le **Numéro de téléphone** seul, ou
+ La combinaison **Prénom, Deuxième prénom et Nom de famille** uniquement
+ Sélectionnez tous les attributs d’un groupe d’attributs spécifique, le cas échéant. Par exemple, si vous souhaitez utiliser le nom, sélectionnez tous les attributs de nom associés : **Prénom, Deuxième prénom, Nom de famille**. Si vous souhaitez utiliser une adresse professionnelle, sélectionnez tous les attributs associés à l’adresse professionnelle.
+ Incluez l’un des attributs suivants susceptibles d’identifier de manière unique un client en combinaison avec d’autres attributs dans les critères :
+ Numéro de compte
+ Numéro de téléphone
+ E-mail
## Configuration de critères de fusion automatique
Avant de définir vos critères de consolidation pour la fusion automatique, nous vous recommandons de consulter [Fonctionnement du processus de fusion automatique](how-identity-resolution-works.md#consolidation-criteria-how-it-works).
1. Après avoir activé la Résolution d’identité, sur la page **Résolution d’identité**, vous aurez la possibilité de configurer des critères de fusion automatique. Choisissez **Créer des critères de consolidation**.
1. Si vous recevez une boîte de dialogue **Horodatage manquant**, nous vous recommandons d’ajouter de nouveaux attributs d’horodatage à vos types d’objets personnalisés avant de continuer. Consultez [Horodatage manquant en cas de conflit de profil](#missing-timestamp-for-profile-conflicts).
1. Dans la section **Conflits de profil**, choisissez la manière dont les conflits de profil doivent être résolus lorsque deux enregistrements ou plus sont en conflit.
1. Dans la section **Critères de consolidation**, créez un ou plusieurs critères. Nous recommandons d’inclure au moins deux attributs par critère.
## Horodatage manquant en cas de conflit de profil
Le message **Horodatage manquant** s’affiche si vous avez des mappages de types d’objets personnalisés.
Utilisez l'[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API pour ajouter les nouveaux attributs suivants à votre type d'objet personnalisé :
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Si l’attribut horodatage n’est pas spécifié, vous pouvez continuer à créer des critères de consolidation. Toutefois, un horodatage par défaut indiquant le moment où les enregistrements ont été ingérés dans Profils des clients est utilisé. Nous vous recommandons d’ajouter les nouveaux attributs avant de créer vos critères de consolidation.
Si vous avez déjà défini un type d’objet personnalisé et que vous souhaitez mettre à jour votre type d’objet personnalisé, nous exécutons un remplissage planifié chaque semaine pour mettre à jour vos profils existants avec le `Fields.sourceLastUpdatedTimestamp`. Pour activer le remplissage planifié :
1. Mettez à jour votre type d'objet de profil personnalisé à l'aide de l'[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Après avoir mis à jour votre type d’objet de profil personnalisé, ouvrez un [ticket Support](https://console.aws.amazon.com/support/home) et nous planifierons le remplissage pour vous. Le remplissage prévu s’exécutera jusqu’à la fin du mois de février 2022.
Vous pouvez également supprimer puis recréer le fichier que ingestion/connector vous avez pour votre domaine qui utilise le type d'objet personnalisé. Toutes vos données seront à nouveau ingérées à l’aide de votre type d’objet mis à jour et l’`Fields.sourceLastUpdatedTimestamp` sera analysé à partir de celui-ci.
## Exemple : comment les exemples de critères sont appliqués
Dans cet exemple, il existe trois critères :
+ Le paramètre **Résoudre les conflits de profil** est défini sur **Utiliser l’horodatage le plus récent**. Cela signifie que lorsque deux champs ont des valeurs contradictoires, la Résolution d’identité utilisera le dernier horodatage mis à jour pour déterminer la valeur à utiliser.
+ Critère 1 :
+ Prénom, Nom
+ E-mail
+ Critère 2 :
+ Numéro de téléphone
Ces critères sont appliqués aux profils suivants :
+ Profil A
+ John Doe [dernière mise à jour à **05 h 00**]
+ doefamily@anyemail.com [dernière mise à jour à **05 h 00**]
+ 555-555-5555 [dernière mise à jour à **07 h 00**]
+ Profil B
+ John Doe [dernière mise à jour à **04 h 00**]
+ doefamily@anyemail.com [dernière mise à jour à **06 h 00**]
+ 555-555-555**6** [dernière mise à jour à *04 h 00*]
+ Profil C
+ **Jane** Doe [dernière mise à jour à **06 h 00**]
+ doefamily@anyemail.com [dernière mise à jour à **07 h 00**]
+ 555-555-5555 [dernière mise à jour à **06 h 00**]
Les résultats obtenus lorsque le critère 1 est appliqué sont les suivants :
+ Les profils A et B sont fusionnés = Profil AB
Cela se traduit par Profil AB, qui ressemble à ce qui suit :
+ John Doe [dernière mise à jour à **05 h 00**]
+ doefamily@anyemail.com [dernière mise à jour à **07 h 00**]
+ 555-555-555**5** [dernière mise à jour à **06 h 00**]
En raison d’un conflit entre les numéros de téléphone, la Résolution d’identité utilise le dernier horodatage pour choisir le numéro 555-555-555.
Ensuite, le critère 2 est appliqué. Voici les résultats :
+ Les profils AB et C sont fusionnés = Profil ABC
Cela se traduit par Profil ABC, qui ressemble à ce qui suit :
+ **Jane** Doe [dernière mise à jour à **06 h 00**]
+ doefamily@anyemail.com [dernière mise à jour à **07 h 00**]
+ 555-555-555**5** [dernière mise à jour à **07 h 00**]
La Résolution d’identité utilise le Prénom, le Nom de famille et l’Adresse e-mail du profil C, car ils ont les horodatages les plus récents.
# Le machine learning pour la Résolution d’identité dans Amazon Connect
La Résolution d’identité dans Amazon Connect trouve automatiquement les profils similaires et vous aide à les consolider. Les rubriques dans cette section décrivent comment configurer la correspondance par machine learning pour consolider les profils dupliqués dans le cadre du processus de fusion automatique.
**Topics**
+ [Fonctionnement du machine learning pour la Résolution d’identité](how-identity-resolution-works.md)
+ [Configuration du machine learning pour la Résolution d’identité](setup-machine-learning-matching.md)
# Fonctionnement du machine learning pour la Résolution d’identité dans Amazon Connect
Cette rubrique décrit comment la Résolution d’identité effectue la correspondance automatique des profils et, si elle est configurée, comment elle fusionne automatiquement des profils similaires.
## Correspondance automatique des profils
Pour identifier des profils similaires, la Résolution d’identité utilise le machine learning pour examiner les attributs de données d’identification personnelle (PII) suivants dans chaque profil :
+ Nom : tous les noms sont examinés pour vérifier leur similitude, y compris le prénom, le deuxième prénom et le nom de famille.
+ Adresse e-mail : toutes les adresses e-mail sont examinées pour vérifier leur similitude, y compris les adresses e-mail personnelles et professionnelles. Elles ne sont pas sensibles à la casse.
+ Numéro de téléphone : tous les numéros de téléphone et tous les formats sont examinés pour vérifier leur similitude, y compris les téléphones fixes, mobiles et professionnels.
+ Adresse : tous les types et formats d’adresses sont examinés pour vérifier leur similitude, y compris l’adresse professionnelle, l’adresse postale, l’adresse de livraison et l’adresse de facturation.
+ Date de naissance : toutes les dates et tous les formats de naissance sont examinés pour vérifier leur similitude.
Ces informations sont utilisées pour créer des groupes de correspondance de profils similaires.
### Groupes de correspondance
Un groupe de correspondance se compose de tous les profils similaires qui représentent un client. Chaque groupe de correspondance contient les informations suivantes :
+ Un ID de correspondance, qui identifie de manière unique le groupe d’au moins deux profils similaires représentant un contact
+ Le nombre de profils IDs dans le groupe de match
+ Un score de confiance associé au groupe de correspondance
### Scores de confiance
Une fois le processus de correspondance automatique exécuté, vous pouvez interroger le compartiment S3 ou utiliser l'[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API pour filtrer les résultats en fonction des scores de confiance. Par exemple, vous pouvez filtrer les correspondances à haut niveau de confiance pour un examen plus approfondi.
Un score de confiance est un nombre compris entre 0 et 1 qui représente le niveau de confiance de l’attribution de profils à un groupe de correspondance. Un score de 1 indique probablement une correspondance exacte.
## Fusion automatique de profils similaires
Une fois les profils mis en correspondance, la Tâche de résolution d’identité peut éventuellement fusionner des profils similaires en fonction de vos critères. Si vous supprimez ou mettez à jour des critères, les critères mis à jour sont appliqués à des profils similaires lors de la prochaine exécution.
**Important**
Vous ne pouvez pas annuler le processus de consolidation. Nous vous recommandons vivement d'utiliser l'[GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API pour tester le processus de fusion automatique avant d'exécuter le Identity Resolution Job.
**Note**
Lors de la fusion de deux profils, les champs de profil remplis manuellement par le biais d’un appel d’API ou de l’espace de travail de l’agent ne seront pas remplacés par des champs de profil automatiquement ingérés à partir d’une intégration ou d’un mappage de type d’objet personnalisé.
Supposons, par exemple, qu'un profil soit créé manuellement avec FirstName « John » par un agent dans l'espace de travail de l'agent. Un autre profil est créé à l'aide d'une intégration S3 avec FirstName « Peter ». Si ces profils sont automatiquement fusionnés, le FirstName « John » sera conservé.
### Fonctionnement du processus de fusion automatique
+ **Tous les attributs sélectionnés dans un critère de consolidation sont connectés à des critères `AND` permettant une comparaison des valeurs exactes avant la fusion**.
+ Par exemple, lorsque plusieurs attributs sont spécifiés dans les critères, tels que `email address` et `phone number`, tous les profils similaires d’un groupe de correspondance ayant exactement la même valeur pour `email address` et `phone number` sont fusionnés.
+ Si un ou plusieurs profils similaires d’un groupe de correspondance ont une valeur différente ou une valeur manquante pour un ou plusieurs attributs d’un critère, les profils similaires sont fusionnés.
Par exemple, un groupe de correspondance peut être composé de cinq profils similaires parmi lesquels trois profils sont consolidés, car ces trois profils répondent aux critères. Les deux autres profils ne sont pas fusionnés, car ils ne répondent pas aux critères.
+ **Plusieurs critères sont évalués par ordre de priorité, en commençant par le critère 1**.
+ La séquence dans laquelle les critères de consolidation sont appliqués. Cela commence par le critère 1 comme priorité la plus élevée jusqu’au critère 10 comme priorité la plus basse.
+ Une fois que la Tâche de résolution d’identité applique un critère, elle applique le critère suivant aux profils consolidés et aux profils similaires restants dans un groupe de correspondance.
+ Vous pouvez disposer de 10 critères de consolidation maximum.
+ **Chaque critère s’exécute indépendamment et fonctionne de la même manière qu’`OR` avec les autres critères**.
+ Lorsque vous avez plusieurs critères, chaque critère est appliqué individuellement et dans l’ordre de priorité avant que la Tâche de résolution d’identité ne passe au critère suivant.
+ Tous les critères sont appliqués dans l’ordre dans lequel vous les avez listés. Peu importe que les critères échouent ou réussissent à consolider des profils similaires dans un groupe de correspondance.
+ **Par défaut, les conflits de profils sont gérés en fonction de leur caractère récent.**
+ Lorsque deux profils similaires minimum d’un groupe de correspondance répondent à un critère de consolidation, le profil consolidé obtenu est créé en comparant chaque valeur des attributs de profil constituant des profils similaires.
+ La valeur de chaque attribut peut correspondre exactement. Dans ce cas, n’importe quelle valeur peut être sélectionnée pour cet attribut.
+ En cas de conflit entre les valeurs de deux profils similaires constitutifs ou plus, l’attribut le plus récemment mis à jour est choisi.
Par exemple, si Jane Doe a trois valeurs différentes dans l’attribut `Address` des profils similaires constitutifs, la Résolution d’identité choisit celui utilisé le plus récemment pour créer le profil unifié.
+ Par défaut, l’**Horodatage le plus à jour** est utilisé pour déterminer l’enregistrement le plus récemment mis à jour.
+ **Les conflits de profils sont gérés par type d’objet source et en fonction de leur caractère récent**.
+ Vous pouvez également modifier le comportement par défaut de résolution des conflits afin de choisir un profil constitutif similaire provenant d’une source spécifique comme source de vérité pour éclairer la résolution des conflits.
+ Si vous souhaitez spécifier une source de données à utiliser pour les conflits de profils, vous pouvez choisir l’un de vos types d’objets comme source de données si vous sélectionnez **Source avec l’horodatage le plus à jour**.
+ L’enregistrement mis à jour le plus récemment à partir du type d’objet spécifié est utilisé pour résoudre les conflits de profil.
+ **L’horodatage le plus à jour identifie l’enregistrement qui a été mis à jour le plus récemment**.
+ L’attribut horodatage associé au type d’objet de l’enregistrement source est utilisé pour identifier l’enregistrement qui a été mis à jour le plus récemment.
+ Si l’attribut horodatage n’est pas disponible pour le type d’objet, l’horodatage sur lequel l’enregistrement a été ingéré dans votre domaine Profils des clients est utilisé.
+ Si vous avez des types d’objets personnalisés, vous devez ajouter des horodatages. Pour plus d’informations, consultez [Horodatage manquant en cas de conflit de profil](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts).
+ **La consolidation est un processus à sens unique qui ne peut pas être annulé**.
+ Choisissez vos critères avec soin avant de lancer le processus de consolidation. Pour de plus amples informations, veuillez consulter [Conseils pour créer des critères solides](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria).
+ Utilisez l'[GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API pour tester les paramètres de fusion automatique de votre résolution d'identité sans fusionner vos données.
Pour un exemple illustrant la façon dont les critères sont appliqués, consultez [Exemple : comment les exemples de critères sont appliqués](create-consolidation-criteria.md#criteria-examples).
# Configuration du machine learning pour la Résolution d’identité dans Amazon Connect
## Modification du calendrier d’exécution des correspondances par machine learning
![\[Modifiez le calendrier d’exécution des correspondances par machine learning.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png)
## Modification des correspondances de fusion par machine learning
![\[Modifiez les correspondances de fusion par machine learning.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png)
## Modification de l’emplacement de la correspondance par machine learning
![\[Modifiez l’emplacement de la correspondance par machine learning.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png)
# Correspondance paramétrable pour la Résolution d’identité dans Amazon Connect
La Résolution d’identité dans AC trouve automatiquement les profils similaires et vous aide à les consolider. Les rubriques de cette section décrivent comment configurer la Résolution d’identité basée sur des règles pour consolider les profils dupliqués dans le cadre du processus de fusion automatique.
**Topics**
+ [Fonctionnement de la Résolution d’identité basée sur des règles](how-rule-based-identity-resolution-works.md)
+ [Configuration de la correspondance paramétrable pour la Résolution d’identité](setup-rule-based-matching.md)
+ [Configuration des règles de correspondance pour la Résolution d’identité basée sur des règles](setup-matching-rule-examples.md)
# Fonctionnement de la Résolution d’identité basée sur des règles dans Amazon Connect
Cette rubrique décrit comment la Résolution d’identité basée sur des règles effectue la correspondance automatique des profils et comment elle fusionne automatiquement des profils similaires.
## Correspondance automatique des profils
Pour identifier des profils similaires, la Résolution d’identité basée sur des règles utilise une liste d’[attributs de règles de correspondance](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) pour chaque profil. Jusqu'à 15 MatchingRule attributs sont pris en charge dans le [MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules).
### Règles de correspondance
Voici une liste des [ MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)attributs qui peuvent être utilisés. Vous pouvez configurer jusqu’à 15 niveaux de règles de correspondance. Pour chaque règle de correspondance, vous pouvez utiliser les attributs de données d’identification personnelle (PII) suivantes dans chaque profil :
+ **AccountNumber**
+ **Adresse.Adresse** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses, BusinessAddress, et MaillingAddress ShippingAddress
+ **Adresse.Ville** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses, BusinessAddress, et MaillingAddress ShippingAddress
+ **Adresse.Pays** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris l'adresse, BusinessAddress, et MaillingAddress ShippingAddress
+ **Adresse.County** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses, BusinessAddress, et MaillingAddress ShippingAddress
+ **Adresse. PostalCode**: Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses BusinessAddress, MaillingAddress, et ShippingAddress
+ **Address.State** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses, BusinessAddress, et MaillingAddress ShippingAddress
+ **Adresse.Province** : Toutes les adresses spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude, y compris les adresses, BusinessAddress, et MaillingAddress ShippingAddress
+ **PhoneNumber**: Les numéros de téléphone spécifiés dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinés pour vérifier leur similitude PhoneNumber, notamment HomePhoneNumber, et MobilePhoneNumber.
+ **EmailAddress**: Toutes les adresses e-mail spécifiées dans le [Sélecteur de type d’attribut](#rule-based-attribute-type-selector) sont examinées pour vérifier leur similitude EmailAddress, notamment BusinessEmailAddress, et PersonalEmailAddress
+ **BirthDate**
+ **BusinessName**
+ **FirstName**
+ **LastName**
+ **MiddleName**
+ **Gender**
+ **Tous les attributs de profil personnalisés avec le préfixe *Attributes***
Les règles de correspondance sont traitées par priorité. Par exemple, la première règle doit être la règle la plus optimisée que vous souhaitez définir et doit être utilisée pour obtenir le résultat le plus précis possible.
### Sélecteur de type d’attribut
Le sélecteur de types d’attribut contient des informations de configuration essentielles pour la résolution d’identité basée sur des règles, facilitant ainsi la correspondance des profils. Cela vous permet d’optimiser la comparaison des profils entre les types d’attributs et de sélectionner les principaux attributs à faire correspondre au sein de chaque type. Dans le cadre de cette fonctionnalité, vous avez la possibilité de configurer trois types d’attributs distincts, ce qui permet de contrôler avec précision le processus de correspondance.
+ **Type d’e-mail**
+ Vous pouvez choisir entre EmailAddress BusinessEmailAddress, et PersonalEmailAddress
+ **PhoneNumber type**
+ Vous pouvez choisir entre PhoneNumberNumber HomePhoneNumber, et MobilePhoneNumber
+ **Type Address**
+ Vous pouvez choisir entre Adresse BusinessAddress, MaillingAddress, et ShippingAddress
Vous pouvez choisir `ONE_TO_ONE` ou `MANY_TO_MANY` utiliser le AttributeMatchingModel. Lorsque vous choisissez `MANY_TO_MANY`, le système peut faire correspondre les attributs entre les sous-types d’un type d’attribut. Par exemple, si la valeur du EmailAddress champ du profil A et celle du BusinessEmailAddress champ du profil B correspondent, les deux profils sont mis en correspondance sur le EmailAddress type. Lorsque vous choisissez `ONE_TO_ONE`, le système ne peut faire une correspondance que si les sous-types correspondent exactement. Par exemple, uniquement lorsque la valeur du EmailAddress champ du profil A et celle du EmailAddress champ du profil B correspondent, les deux profils sont mis en correspondance sur le EmailAddress type.
**Niveau de règle maximal autorisé pour la correspondance**
Vous pouvez configurer le niveau de règle maximal que vous souhaitez utiliser pour faire correspondre des profils similaires. Par exemple, si le niveau de règle maximal autorisé pour la correspondance est de 5, le système ne trouvera pas de profils similaires utilisant le niveau de règle 6.
### Groupes de correspondance
Un groupe de correspondance se compose de tous les profils similaires qui représentent un client. Chaque groupe de correspondance contient les informations suivantes :
+ Un ID de correspondance, qui identifie de manière unique le groupe d’au moins deux profils similaires représentant un contact
+ Le nombre de profils IDs dans le groupe de match
### Statut de la correspondance
+ **EN SUSPENS**
Premier statut après la configuration d’une règle de correspondance paramétrable. S’il s’agit d’un domaine existant, la Résolution d’identité basée sur des règles attend 1 heure avant de créer la règle de correspondance. S’il s’agit d’un nouveau domaine, le système sautera l’étape **EN SUSPENS**.
+ **EN\$1COURS**
Le système est en train de créer la règle de correspondance paramétrable. Dans ce statut, le système évalue les données existantes et vous ne pouvez plus modifier la configuration de correspondance paramétrable.
+ **ACTIF**
La règle est prête à être utilisée. Vous pouvez modifier la règle un jour après que le statut soit passé à l’état **ACTIF**.
### Fonctionnement du processus de correspondance automatique
Une fois que vous avez créé un nouveau domaine Profils des clients Amazon Connect avec la règle de correspondance paramétrable, la Résolution d’identité basée sur des règles fera correspondre des profils similaires en fonction de la règle que vous avez spécifiée lors de l’ingestion des profils. Si vous mettez à jour la configuration de la correspondance paramétrable, la fonctionnalité Profils des clients commencera à réévaluer les profils de votre domaine en utilisant la nouvelle configuration dans une heure.
Si vous activez la correspondance paramétrable avec un domaine existant, le système passera à l’état **EN SUSPENS** et commencera à évaluer les profils existants dans votre domaine à l’aide de la nouvelle configuration dans une heure. Le temps nécessaire pour terminer l’évaluation des profils dépend du nombre de profils existants.
+ **Par défaut, la règle par défaut sera appliquée si aucune règle personnalisée n’est spécifiée.**
+ La fonctionnalité Profils des clients Amazon Connect fournit une règle de correspondance par défaut si vous ne fournissez pas de règle de correspondance personnalisée. Vous pouvez consulter la règle de correspondance personnalisée ici.
+ **Tous les enregistrements seront soumis aux règles de correspondance basées sur des règles.**
+ Le système évalue chaque niveau de règle de correspondance jusqu’à ce qu’une correspondance soit identifiée ou jusqu’à ce que le niveau de règle maximal autorisé pour la correspondance soit atteint. Le processus d’évaluation commence au niveau 1 de la règle, où l’enregistrement est analysé. Si aucun groupe correspondant n’est découvert, le système procède à l’évaluation des niveaux de règles suivants, en recherchant un groupe de correspondance jusqu’à ce qu’une correspondance soit trouvée ou que le niveau de règle maximal autorisé pour la correspondance soit atteint.
+ **Tous les attributs d’un même niveau de règle de correspondance sont connectés à l’aide d’une relation *ET*.**
+ Lorsque plusieurs attributs sont présents au sein d’un même niveau de règle, ils sont interconnectés par une relation ET. Lors de la mise en correspondance des profils, toutes les valeurs d’attribut doivent être alignées pour que les profils soient affectés au même groupe de correspondance. Par exemple, uniquement lorsque les valeurs de tous les attributs sont identiques, les profils sont considérés comme des correspondances et regroupés pour un traitement ultérieur.
+ **Tous les attributs d’un sélecteur de type d’attribut sont liés à une relation *OU***
+ Lorsque vous spécifiez des attributs dans le sélecteur de type d’attribut, les attributs du même type sont liés par une relation OU. Par exemple, considérez le PhoneNumber type dans lequel HomePhoneNumber et BusinessPhoneNumber sont utilisés. Dans ce scénario, deux profils peuvent être mis en correspondance s'ils s' BusinessPhoneNumber alignent HomePhoneNumber ou s'ils sont alignés. Par conséquent, le processus de correspondance permet des correspondances flexibles basées sur des numéros de téléphone personnels ou professionnels.
+ **Le résultat de la correspondance est finalement optimisé.**
+ En raison de la nature quasi en temps réel de la correspondance des profils dans le système, il est possible qu’un groupe correspondant à votre profil soit trouvé à un niveau de règle inférieur (moins optimisé). Néanmoins, si une correspondance est disponible à un niveau de règle supérieur (plus optimisé), le système attribuera le profil à ce groupe en particulier.
**Note**
Lorsque la Résolution d’identité effectue une correspondance paramétrable, l’ordre dans lequel les règles que vous avez configurées seront traitées dépend de la manière dont les données sont ingérées. Par exemple, si vous configurez les règles 1 et 2, la règle 2 peut être traitée avant la règle 1. L’ordre de traitement peut changer, mais le résultat final sera toujours identique.
## Fusion automatique de profils similaires
Une fois les profils mis en correspondance, l'Identity Resolution Job peut éventuellement fusionner des profils similaires en fonction de ce [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)que vous spécifiez dans la configuration de correspondance basée sur des règles.
**Important**
Vous ne pouvez pas annuler le processus de consolidation. Il est recommandé d'activer d'abord la mise en correspondance uniquement pour évaluer le résultat de la correspondance à l'aide des ListMatches touches et GetSimiliarProfiles APIs. Vous pouvez activer la fusion en configurant l'[MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)utilisation de l'[UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
**Note**
Lors de la fusion de deux profils, les champs de profil remplis manuellement par le biais d’un appel d’API ou de l’espace de travail de l’agent ne seront pas remplacés par des champs de profil automatiquement ingérés à partir d’une intégration ou d’un mappage de type d’objet personnalisé.
Supposons, par exemple, qu'un profil soit créé manuellement avec FirstName « John » par un agent dans l'espace de travail de l'agent. Un autre profil est créé à l'aide d'une intégration S3 avec FirstName « Peter ». Si ces profils sont automatiquement fusionnés, le FirstName « John » sera conservé.
# Configuration de la correspondance paramétrable pour la Résolution d’identité dans Amazon Connect
Cette rubrique décrit les étapes à suivre pour modifier les types d’attributs de correspondance paramétrable, les règles de correspondance paramétrable, les règles de fusion de correspondance paramétrable et les emplacements de correspondance paramétrable. Elle explique également comment réinitialiser les règles de correspondance paramétrable.
## Modification des types d’attributs de correspondance paramétrable
![\[Modifiez les types d’attributs de correspondance paramétrable.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/rule-based-edit-attribute-types.png)
## Modification des règles de correspondance paramétrable
![\[Modifiez les règles de correspondance paramétrable.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/rule-based-edit-matching-rules.png)
## Réinitialisation des règles de correspondance paramétrable
![\[Réinitialisez les règles de correspondance paramétrable.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/rule-based-edit-reset-rules.png)
## Modifiez les règles de fusion de correspondances basées sur des règles.
![\[Modifiez les règles de fusion de correspondances basées sur des règles.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/rule-based-edit-merge-rules.png)
## Modification de l’emplacement de la correspondance paramétrable
![\[Modifiez l’emplacement de la correspondance paramétrable.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/rule-based-match-location.png)
# Configuration des règles de correspondance pour la Résolution d’identité basée sur des règles dans Amazon Connect
## Restrictions
Vous pouvez sélectionner n’importe quel attribut dans le profil standard pour comparer des profils similaires. Par exemple, vous pouvez choisir un numéro de téléphone, une adresse e-mail et un nom, ainsi que des attributs personnalisés.
Vous pouvez créer une règle de correspondance paramétrable avec les limites suivantes :
+ 15 niveaux de règles
+ Chaque niveau de règle peut contenir jusqu’à 15 attributs de profil.
## Conseils
Pour améliorer le ciblage des profils uniques et éviter de consolider les profils qui ne sont pas des doublons, nous recommandons les conseils suivants :
+ Incluez au moins un attribut de cardinalité élevée qui permet d’identifier un client de manière unique et qui n’est pas susceptible d’être le même pour tous les clients, tel qu’un numéro de téléphone, une adresse e-mail ou un numéro de compte.
+ Évitez d’utiliser des attributs de profil qui peuvent appartenir à différentes identités sans un attribut de cardinalité élevé.
+ Le **Numéro de téléphone** avec le **Prénom** et le **Nom de famille** est une règle plus solide que la combinaison **Prénom** et **Nom de famille** uniquement.
+ Si, au niveau d’une règle, tous les attributs de profil de cette règle sont des attributs de faible cardinalité (attribut pouvant appartenir à plus de 500 profils différents), les Profils clients n’essaieront pas de faire correspondre le profil. Vous recevrez le message SQS suivant dans votre DLQ si vous en avez configuré un lors de la création du domaine :
+ Tous les attributs du niveau de règle x sont associés à plus de 500 enregistrements.
+ Activez toujours **Match uniquement** en premier, vérifiez les résultats du match et n'activez la fusion qu'en définissant le **MaxAllowedRuleLevelForMerging**si vous êtes satisfait des résultats du match.
## Résolution des conflits de profils pour la fusion de profils
Vous pouvez définir l’enregistrement à utiliser lorsque la valeur d’un attribut provenant de deux profils similaires minimum est différente, par exemple lorsque des enregistrements d’adresses sont en conflit.
**Horodatage de la dernière mise à jour**
Par défaut, les conflits de profils sont gérés en fonction de leur caractère récent. En cas de conflit entre les valeurs de deux profils similaires ou plus, l’attribut le plus récemment mis à jour est choisi.
**Source avec horodatage le plus à jour**
Vous permet de hiérarchiser les enregistrements d’un type d’objet spécifique en tant que source de données pour gérer les conflits de profils. En cas de conflit entre les valeurs de deux profils similaires ou plus, l’attribut le plus récemment mis à jour à partir du type d’objet spécifié est choisi.
Si aucun horodatage n’est spécifié dans votre type d’objet, la date à laquelle l’enregistrement a été ingéré dans Profils des clients est utilisée. La source avec l’horodatage le plus à jour n’est pas disponible si aucune intégration n’est configurée. Lorsque vous ajoutez une intégration, vos types d’objets sont disponibles en tant que source pour cette option.
## Horodatage manquant en cas de conflit de profil
Le message Horodatage manquant s’affiche si vous avez des mappages de types d’objets personnalisés.
Utilisez l'[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API pour ajouter les nouveaux attributs suivants à votre type d'objet personnalisé :
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Si l’attribut horodatage n’est pas spécifié, vous pouvez continuer à créer des critères de consolidation. Toutefois, un horodatage par défaut indiquant le moment où les enregistrements ont été ingérés dans Profils des clients est utilisé. Il est recommandé d’ajouter les nouveaux attributs avant de créer vos critères de consolidation.
Si vous avez déjà défini un type d’objet personnalisé et que vous souhaitez mettre à jour votre type d’objet personnalisé, nous exécutons un remplissage planifié chaque semaine pour mettre à jour vos profils existants avec le `Fields.sourceLastUpdatedTimestamp`. Pour activer le remplissage planifié, suivez les étapes suivantes :
1. Mettez à jour votre type d'objet de profil personnalisé à l'aide de l'[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Après avoir mis à jour votre type d’objet de profil personnalisé, ouvrez un [ticket AWS Support](https://console.aws.amazon.com/support/home).
1. AWS planifiera le remblayage en votre nom. Le remplissage prévu s’exécutera jusqu’à la fin du mois de février 2022.
Vous pouvez également supprimer puis recréer l’ingestion/le connecteur que vous avez pour votre domaine qui utilise le type d’objet personnalisé. Toutes vos données seront à nouveau ingérées à l’aide de votre type d’objet mis à jour et l’`Fields.sourceLastUpdatedTimestamp` sera analysé à partir de celui-ci.
## Exemple : fonctionnement de la correspondance
### Exemple pour ONE\$1TO\$1ONE
Vous pouvez choisir `ONE_TO_ONE` comme `AttributeMatchingModel`. Lorsque vous choisissez `ONE_TO_ONE`, le système ne peut faire une correspondance que si les sous-types correspondent exactement.
**Par exemple** :
Vous utilisez les attributs `EmailAddress` et `BusinessEmailAddress` pour représenter les types `EmailAddress`. Le `AttributeMatchingModel` est `ONE_TO_ONE`.
**Votre règle de correspondance est la suivante** :
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
Le profil A et le profil B correspondent au niveau de règle 1 puisque les types `EmailAddress`, `LastName` et `FirstName` correspondent.
### Exemple pour MANY\$1TO\$1MANY
Vous pouvez choisir `MANY_TO_MANY` comme `AttributeMatchingModel`. Lorsque vous choisissez `MANY_TO_MANY`, le système peut faire correspondre les attributs entre les sous-types d’un type d’attribut.
**Par exemple** :
Vous utilisez les attributs `EmailAddress` et `BusinessEmailAddress` pour représenter les types `EmailAddress`. Le `AttributeMatchingModel` est `MANY_TO_MANY`.
**Votre règle de correspondance est la suivante** :
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress)
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress)
LastName: Doe
FirstName: John
AccountNumber: account1234
```
Le profil A et le profil B correspondent au niveau de règle 1 puisque les types `EmailAddress`, `LastName` et `FirstName` correspondent.
# Afficher les métriques de résolution d’identité dans Profils des clients Amazon Connect
Chaque fois que la Résolution d’identité fait correspondre ou fusionne des profils, les métriques relatives au processus sont affichées sur le tableau de bord Profils des clients. Vous pouvez consulter les métriques de la semaine écoulée sur la page récapitulative de **Résolution d’identité**.
Les métriques suivantes sont générées chaque fois que la Tâche de résolution d’identité s’exécute :
+ **Groupes de correspondance trouvés** : nombre de groupes de correspondance trouvés.
+ Disponible pour la Résolution d’identité basée sur le machine learning et sur des règles.
+ **Profils fusionnés** : nombre de profils fusionnés.
+ Disponible pour la Résolution d’identité basée sur le machine learning et sur des règles.
+ **Groupe de correspondance par règle** : nombre de groupes de correspondance créés par chaque niveau de règle.
+ Disponible uniquement pour la Résolution d’identité basée sur des règles.
![\[La page Profils des clients Amazon Connect, le bouton Activer la résolution d’identité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ir-metrics-example-1.png)
![\[La page Profils des clients Amazon Connect, le bouton Activer la résolution d’identité.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Désactivation de la Résolution d’identité dans Profils des clients Amazon Connect
## Désactivation de la Résolution d’identité basée sur le machine learning
Vous pouvez désactiver la correspondance par machine learning lorsque vous ne souhaitez plus qu’elle trouve automatiquement des profils similaires. Si vous avez des critères de consolidation, tous vos critères seront supprimés et vos profils ne seront plus automatiquement consolidés. Les profils déjà consolidés resteront consolidés.
## Désactivation de la correspondance paramétrable
Vous pouvez désactiver la correspondance paramétrable lorsque vous ne souhaitez plus qu’elle trouve automatiquement des profils similaires. Si vous avez une règle de correspondance personnalisée, elle sera supprimée et vos profils ne seront plus automatiquement consolidés. Les profils déjà consolidés resteront consolidés.
# Résolution avec AWS Entity Resolution
Amazon Connect Customer Profiles propose un *connecteur géré* qui vous permet d'importer directement les résultats correspondants depuis AWS Entity Resolution. Cette intégration vous permet de tirer parti des puissantes fonctionnalités de mise en correspondance d'AWS Entity Resolution tout en gérant les profils de vos clients dans Amazon Connect.
AWS Entity Resolution vous permet de faire correspondre et de lier les enregistrements associés entre vos différentes sources de données à l'aide de techniques de correspondance flexibles, notamment des règles, du machine learning ou des fournisseurs de données tiers. En reliant les résultats de la résolution des entités aux profils des clients, vous pouvez :
+ Consolidez avec plus de précision les dossiers clients provenant de plusieurs systèmes
+ Appliquez une logique de correspondance sophistiquée en fonction des besoins spécifiques de votre entreprise
+ Améliorez les profils clients grâce à des données liées provenant de divers canaux et applications
+ Maintenez des points de vue clients cohérents dans l'ensemble de votre organisation
Pour commencer à utiliser AWS Entity Resolution avec les profils des clients, vous devez d'abord configurer vos flux de travail correspondants dans la console AWS Entity Resolution. [En savoir plus sur AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html).
Pour configurer cela, vous devez remplir les conditions préalables suivantes :
+ Instance Amazon Connect active avec profils clients activés
+ Données clients stockées dans Amazon S3
+ Autorisations IAM appropriées pour accéder à AWS Entity Resolution
**Pour configurer, procédez comme suit :**
1. Création d'un domaine Customer Profiles
+ Si ce n'est pas déjà fait, créez un domaine Customer Profiles dans votre instance Connect
+ Accédez à la section Profils clients de votre console Amazon Connect
+ Remarque : vous verrez une nouvelle section consacrée à la résolution des entités AWS après la création du domaine
1. Configuration de la résolution des entités AWS
+ Dans votre domaine Customer Profiles, recherchez la section AWS Entity Resolution
+ Cliquez sur « Configurer la résolution des entités AWS »
+ Vous serez redirigé vers la console AWS Entity Resolution.
+ Création d'un flux de travail correspondant
+ Configurez vos sources de données S3
+ Définissez les critères de correspondance
+ Vérifiez et activez votre flux de travail correspondant
1. Connecter les résultats de la résolution des entités aux profils des clients
+ Retournez à votre domaine Customer Profiles
+ Sélectionnez votre flux de travail de résolution d'entités
+ Configurer la manière dont les enregistrements correspondants doivent être consolidés
+ Activez l'intégration
# Intégration d’applications externes à la fonctionnalité Profils des clients Amazon Connect
Amazon Connect fournit un ensemble d'intégrations prédéfinies optimisées par Amazon et AppFlow Amazon. EventBridge Après avoir activé la fonctionnalité Profils des clients Amazon Connect, vous pouvez utiliser ces intégrations pour combiner des informations provenant d’applications externes telles que Salesforce ou Zendesk avec l’historique des contacts d’Amazon Connect. Cela crée un profil de client qui réunit en un seul endroit toutes les informations dont les agents ont besoin lors des interactions avec les clients.
Vous pouvez également utiliser les profils clients sur Amazon AppFlow. Amazon le AppFlow prend en charge `CustomerProfiles` en tant que destination. Vous pouvez utiliser Amazon AppFlow APIs pour envoyer des données vers des profils clients en utilisant `CustomerProfiles` comme nom de destination.
Avant de commencer, assurez-vous d’utiliser une clé gérée par le client. Pour plus d’informations sur la configuration des clés KMS, consultez [Création d’une clé KMS à utiliser par Profils des clients pour chiffrer les données (obligatoire)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey).
## Configuration des intégrations
Vous pouvez configurer une intégration à l'aide d'applications intégrées dans Amazon Connect ou d'applications externes utilisant Amazon en AppFlow choisissant la méthode la mieux adaptée à votre cas d'utilisation ci-dessous. Pour plus d'informations sur l'intégration de Slack ServiceNow et de Slack, consultez le billet de blog [Combinez des données provenant de plusieurs sources à l'aide d'Amazon AppFlow et créez un profil client Amazon Connect unifié pour les agents des centres d'appels](https://aws.amazon.com/blogs/contact-center/unified-customer-data/).
**Topics**
+ [Configuration des intégrations](#setup-integrations-title-menu)
+ [Configuration de l’intégration pour les applications intégrées dans Amazon Connect](integrate-customer-profiles-appflow.md)
+ [Configurer l'intégration pour les applications externes à l'aide d'Amazon AppFlow](integrate-external-applications-appflow.md)
+ [Suppression des Profils des clients ou arrêt des intégrations](delete-customer-profile-connection.md)
# Configuration de l’intégration pour les applications intégrées dans Amazon Connect
Ces intégrations utilisent les applications intégrées dans Amazon Connect pour fournir des mises à jour régulières à la fonctionnalité Profils des clients Amazon Connect.
## Avant de commencer
### Ingestion en bloc de données
Lorsque vous configurez votre intégration, il vous est demandé de saisir la date à laquelle vous souhaitez remonter pour ingérer les données. Si vous choisissez une date remontant à plus de deux mois, la fonctionnalité Profils des clients active automatiquement l’ingestion en bloc en créant plusieurs flux. Cela vous évite d’avoir à calculer le nombre de flux dont vous avez besoin pour ingérer des données.
Lorsque l’ingestion automatique en bloc est activée, la fonctionnalité Profils des clients effectue les opérations suivantes :
+ Définit la taille du lot sur deux mois.
+ Réessaie jusqu’à trois fois en cas d’échec temporaire avant d’échouer.
Vous pouvez utiliser l'[CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API pour appeler votre propre taille de lot.
### Pourquoi me demande-t-on de sélectionner ou de créer un rôle IAM ?
Pour Salesforce, Marketo et Customer Profiles ServiceNow, vous pouvez améliorer l'assimilation historique de ces sources en utilisant votre rôle IAM pour créer plusieurs flux de travail afin d'ingérer vos données rapidement et efficacement.
Pour ces sources, si vous sélectionnez un sélecteur de date **Date d’importation des enregistrements** il y a plus de 60 jours, vous serez invité à créer un nouveau rôle IAM ou à en sélectionner un existant. Ce rôle permet à la fonctionnalité Profils des clients de gérer votre intégration. Il fournit à la fonctionnalité Profils des clients les autorisations nécessaires pour mettre à jour et créer un flux de travail pour ingérer vos données. Une fois le flux de travail terminé, la fonctionnalité Profils des clients crée une intégration continue standard qui ingère vos nouvelles données au fur et à mesure de leur mise à jour dans votre source.
Le rôle créé dans la console n’est utilisable que par le domaine sur lequel il a été créé. Cela est dû au fait qu’Amazon Connect limite l’accès du rôle à la seule clé KMS utilisée par le domaine.
Pour plus d’informations, consultez [Autorisation de l’accès de moindre privilège à votre rôle d’exécution Profils des clients](#grant-least-privilege-cp).
## Autorisation de l’accès de moindre privilège à votre rôle d’exécution Profils des clients
Si vous souhaitez créer votre propre rôle IAM, nous vous recommandons d’utiliser les autorisations indiquées dans le code suivant afin de limiter le rôle au minimum d’autorisations nécessaires. Utilisez l’extrait ci-dessous pour créer votre rôle manuellement. Utilisez votre propre clé KMS et spécifiez votre région si nécessaire.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## Surveillance de vos intégrations Profils des clients
Une fois votre connexion établie, si elle cesse de fonctionner, supprimez l’intégration, puis rétablissez-la.
## Que faire si des objets ne sont pas envoyés
Si un objet ne parvient pas à être envoyé, choisissez **Détails du flux** pour en savoir plus sur le problème.
Vous devrez peut-être supprimer la configuration et vous reconnecter à l’application externe.
# Configuration de l’intégration pour les cas Amazon Connect
Pour mettre à jour Amazon Connect les données de vos dossiers dans les profils clients Amazon Connect et utiliser des fonctionnalités telles que les attributs calculés, vous pouvez effectuer une intégration à l'aide d'Amazon AppIntegrations. Commencez par configurer un flux d'événements Cases pour envoyer les champs du système à un EventBridge bus, puis utilisez Amazon AppIntegrations pour transférer ces événements vers les profils des clients.
## Diffusez les données des Cas Amazon Connect vers Event Bridge
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[L’alias de l’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. Dans le volet de navigation, choisissez **Cas** et notez votre ID de domaine de cas dans la section **Détails du domaine**.
![\[Page Cas, section Détails de domaine, flèche pointant vers l’ID du domaine.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. À l'aide de AWS CLI, créez une configuration d'événement Case pour envoyer Amazon Connect Cases Events vers le bus Event Bridge par défaut Compte AWS de votre choix.
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. Ouvrez la console Event Bridge de votre AWS région. Par exemple, à [https://us-west-2.console.aws.amazon.com/events/la maison ? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Choisissez **Create event bus (Créer un bus d’événement)**.
![\[La page Event bus de la EventBridge console Amazon, le bouton Create event bus.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Créez un bus d’événements avec comme nom `connect-cases-to-customer-profiles`.
![\[La page Créer un bus d’événements, la case Nom.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Revenez à votre **bus d’événements par défaut** et créez une règle avec comme nom `connect-cases-to-customer-profiles-rule`.
![\[Le bus d’événements par défaut, le bouton Créer une règle.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[L’étape Créer un modèle d’événement.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Extrait de modèle d’événement :
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[La section Méthode de création, l’option Modèle personnalisé (éditeur JSON), le code du modèle d’événement.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Choisissez **Passer à la révision et à la création**, puis **Créer une règle**.
![\[Le bouton Passer à la révision et à la création.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Ingérez les données de dossier d'Event Bridge dans les profils clients en utilisant AppIntegrations
1. À l'aide de AWS CLI, créez une intégration d'événements avec la sortie ARN AppIntegrations et enregistrez cette dernière. Cela représente une source de données qu’une instance Amazon Connect peut utiliser.
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. À l'aide de AWS CLI, créez une intégration avec Customer Profiles à l'aide de l'API put-integration. Cela lancera le flux de données vers Profils des clients, en remplaçant les valeurs d’espace réservé par votre ARN d’intégration d’événements et le nom de domaine Profils des clients.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Vérification de votre intégration aux cas
1. Créez un cas dans les Cas Amazon Connect.
1. La livraison de l’événement doit être presque instantanée, mais attendez une minute pour qu’elle soit livrée et pour l’associer avec le profil client.
1. À l'aide du AWS CLI, recherchez l'objet Connect-case sous le profil, en remplaçant les espaces réservés par les valeurs correctes.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Si vous ne trouvez aucun élément dans la réponse à l’appel d’API ci-dessus, cela signifie que votre intégration présente un problème. Pour résoudre un problème :
1. Accédez à la EventBridge console Amazon.
1. Vérifiez si le EventSource est actif et si la correspondance EventBus existe et est en cours d'exécution.
1. Vérifiez si la configuration de votre événement de cas est correctement configurée.
1. Si cela fonctionne, contactez Support pour obtenir de l'aide pour étudier le problème.
# Configurer l'intégration d'Amazon Connect avec Salesforce ServiceNow, Marketo ou Zendesk
Pour fournir des mises à jour périodiques aux profils clients Amazon Connect, vous pouvez intégrer Salesforce ServiceNow, Marketo ou Zendesk à l'aide d'Amazon. AppFlow Vous configurez d’abord la connexion dans Amazon Connect et l’application de votre choix, puis vérifiez l’intégration.
## Configurez la connexion dans Amazon Connect et Salesforce ServiceNow, Marketo ou Zendesk
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[Page Instances du centre de contact virtuel Amazon Connect, alias d’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/instance.png)
1. Dans le volet de navigation, choisissez **Profils des clients**.
1. Sur la page **Configuration des profils des clients**, choisissez **Ajouter une intégration**, comme illustré dans l’image suivante.
![\[La page Configuration des profils des clients, le bouton Ajouter une intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Sur la page **Sélectionner une source de données**, choisissez l’application externe à partir de laquelle vous souhaitez obtenir les données des profils des clients. Vous pouvez consulter les [exigences d’intégration](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) pour mieux comprendre les exigences de connexion requises pour votre application.
![\[La page Sélectionner une source de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. Sur la page **Établir une connexion**, choisissez l’une des options suivantes :
+ **Utiliser une connexion existante** : cela vous permet de réutiliser les AppFlow ressources Amazon existantes que vous avez peut-être créées dans votre compte AWS.
+ **Créer une connexion** : entrez les informations requises par l’application externe.
![\[La page Établir une connexion.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. Sur la page **Options d’intégration**, choisissez les objets source que vous souhaitez ingérer et sélectionnez leur type d’objet.
Les types d’objets stockent les données que vous avez ingérées. Ils définissent également la manière dont les objets de vos intégrations sont mappés aux profils lorsqu’ils sont ingérés. La fonctionnalité Profils des clients fournit des modèles de type d’objet par défaut que vous pouvez utiliser pour définir la façon dont les attributs de vos objets source sont mappés aux objets standard dans Profils des clients. Vous pouvez également utiliser les mappages d'objets que vous avez créés à partir du [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html). Lorsque vous ajoutez ou créez l’intégration de Salesforce pour le mappage de données créé par l’utilisateur, vous devez spécifier le mappage de données spécifique, sinon il choisira le mappage de données par défaut de Salesforce pour le type d’objet. Vous pouvez créer votre mappage de données et l’utiliser lors de la configuration d’un connecteur de données intégré.
![\[La page Options d’intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Pour la **Date de début de l’ingestion**, la fonctionnalité Profils des clients commence à ingérer les enregistrements créés après cette date. Par défaut, la date d’importation des enregistrements est fixée à 30 jours avant.
1. Sur la page **Vérifier et intégrer**, vérifiez que le **Statut de la connexion** indique **Connecté(e)**, puis choisissez **Créer une intégration**.
![\[La page Vérifier et intégrer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Une fois l’intégration configurée, revenez sur la page **Configuration des profils des clients**, choisissez **Afficher les objets** pour voir quelles données sont regroupées par lots et envoyées. Actuellement, ce processus ingère les enregistrements créés ou modifiés au cours des 30 derniers jours.
![\[La page Configuration des profils des clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Configuration de l’intégration pour Segment afin de fournir des mises à jour régulières à Profils des clients Amazon Connect
Pour fournir des mises à jour périodiques aux profils clients Amazon Connect, vous pouvez intégrer Segment à l'aide d'Amazon AppFlow. Vous configurez d’abord la connexion dans Amazon Connect et Segment, puis vérifiez l’intégration à Segment.
## Configuration de la connexion dans Amazon Connect et Segment
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[Page Instances du centre de contact virtuel Amazon Connect, alias d’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/instance.png)
1. Dans le volet de navigation, choisissez **Profils des clients**.
1. Sur la page **Configuration des profils des clients**, choisissez **Ajouter une intégration**.
![\[La page Configuration des profils des clients, le bouton Ajouter une intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Sur la page **Sélectionner une source de données**, choisissez **Segment**. Passez en revue les exigences de l’application répertoriées sur la page **Sélectionner une application**.
![\[La page Sélectionner une source de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. Sur la page **Établir une connexion**, choisissez l’une des options suivantes :
+ **Utiliser une connexion existante** : cela vous permet de réutiliser les EventBridge ressources Amazon existantes que vous avez peut-être créées dans votre Compte AWS.
+ **Créer une connexion** : entrez les informations requises par l’application externe.
![\[La page Établir une connexion.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nom de la connexion** : fournissez un nom à votre connexion. Le nom de la connexion est référencé par les intégrations qui utilisent cette connexion.
+ **URL de connexion** : entrez l’URL de connexion à votre application. Cette URL est utilisée pour créer des liens profonds vers les objets créés dans votre application externe. L’URL de connexion est l’URL de l’espace de travail de Segment disponible sur le site web de l’application.
Pour trouver l’URL de votre espace de travail :
1. Connectez-vous à votre compte segment.com.
1. Accédez à **Paramètres**, puis **Paramètres généraux**.
1. Copiez l’URL depuis votre navigateur.
1. Customer Profiles utilise Amazon EventBridge pour les intégrations avec Segment. Sur la page de **configuration de la source**, copiez votre Compte AWS identifiant dans votre presse-papiers, puis choisissez **Log in to Segment** pour configurer Amazon EventBridge.
1. Utilisez les instructions suivantes pour configurer Segment :
1. Connectez-vous à Segment.
1. Dans votre application, sélectionnez une source pour configurer la destination vers Amazon EventBridge.
1. Collez votre Compte AWS identifiant et sélectionnez votre AWS région.
1. Appuyez sur **ON** pour activer la source d’événements de votre partenaire.
1. Accédez à **Testeur d’événement** et envoyez un événement de test pour terminer l’activation de la source d’événements de votre partenaire.
1. **ID client** : il s’agit d’une chaîne qui distingue de manière unique le client dans votre application externe. Cet ID client est le nom de source disponible sur le site web de l’application. Vous utilisez l’ID que vous spécifiez pour identifier le client auprès duquel vous souhaitez que la fonctionnalité Profils des clients ingère vos objets.
Pour rechercher votre ID source :
1. Accédez à **Sources**, puis choisissez une source.
1. Accédez à **Paramètres**, puis **Clés API**.
1. Copiez votre **ID de source**.
Après avoir configuré la destination de la source de l’événement, retournez dans la console Profils des clients et collez l’ID client.
1. Vous verrez une alerte indiquant qu’Amazon Connect s’est connecté à Segment.
1. Sur la page **Options d’intégration**, choisissez les objets source que vous souhaitez ingérer et sélectionnez leur type d’objet.
Les types d’objets stockent les données que vous avez ingérées. Ils définissent également la manière dont les objets de vos intégrations sont mappés aux profils lorsqu’ils sont ingérés. La fonctionnalité Profils des clients fournit des modèles de type d’objet par défaut que vous pouvez utiliser pour définir la façon dont les attributs de vos objets source sont mappés aux objets standard dans Profils des clients. Vous pouvez également utiliser les mappages d'objets que vous avez créés à partir du [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html).
![\[La page Options d’intégration, la section Type d’objet.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Pour la **Date de début de l’ingestion**, la fonctionnalité Profils des clients commence à ingérer les enregistrements créés après l’ajout de l’intégration.
**Note**
Si vous avez besoin d’enregistrements historiques, vous pouvez [utiliser Amazon S3 comme source d’intégration pour les importer](customer-profiles-object-type-mappings.md).
1. Sur la page **Vérifier et intégrer**, vérifiez que le **Statut de la connexion** indique **Connecté(e)**, puis choisissez **Ajouter une intégration**.
1. Une fois l’intégration configurée, de retour sur la page de **Configuration des profils des clients**, la page **Intégrations** affiche les intégrations actuellement configurées. Les paramètres **Dernière exécution** et **État de l’intégration** ne sont actuellement pas disponibles pour ce type d’intégration.
![\[La page Configuration des profils des clients, la section Intégrations.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Pour voir quelles données sont envoyées, choisissez l’intégration, puis **Afficher les objets**.
## Vérification de votre intégration à Segment
Pour effectuer cette étape, vous devez disposer des conditions préalables suivantes :
+ Accès à votre espace de travail Segment.
+ [Accès au Panneau de configuration des contacts Amazon Connect](amazon-connect-contact-control-panel.md).
**Pour vérifier votre intégration à Segment**
1. Accédez au tableau de bord de votre espace de travail Segment et choisissez **Destinations**.
![\[La page de présentation de Segment.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Vous verrez une liste des destinations vers lesquelles Segment envoie des données. Choisissez la EventBridge destination pour les profils clients.
![\[La page Liste des destinations.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Choisissez l’onglet **Testeur d’événement**. À partir de cette page, vous allez envoyer un événement de test à Profils des clients. L’événement est ingéré et transformé en profil de client que vous pouvez consulter dans l’application d’agent Amazon Connect.
![\[L’onglet Testeur d’événement.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Sélectionnez **Identifier** comme type d’événement, puis sélectionnez **Créateur d’événement** comme méthode de saisie.
1. Vous pouvez spécifier un **ID utilisateur** et certaines caractéristiques. Les agents peuvent rechercher ces caractéristiques dans l’application d’agent.
1. Choisissez **Envoyer un événement**.
1. La livraison de l’événement doit être presque instantanée, mais attendez une minute pour qu’elle soit livrée et créez un profil client.
1. Ouvrez l’application d’agent Amazon Connect. Recherchez l’ID utilisateur que vous avez entré dans **Créateur d’événement**. Vous devriez pouvoir voir le profil du client avec l’ID utilisateur et les caractéristiques que vous avez entrées.
1. Si vous ne pouvez pas voir le profil du client, cela signifie que votre intégration présente un problème. Pour résoudre un problème :
1. Accédez à la EventBridge console Amazon.
1. Vérifiez si le EventSource est actif et si la correspondance EventBus existe et est en cours d'exécution.
Si cela fonctionne, contactez Support pour obtenir de l'aide pour étudier le problème.
## Surveillance de vos intégrations Profils des clients
Une fois votre connexion établie, si elle cesse de fonctionner, supprimez l’intégration, puis rétablissez-la.
## Que faire si des objets ne sont pas envoyés
Si un objet ne parvient pas à être envoyé, choisissez **Détails du flux** pour en savoir plus sur le problème.
Vous devrez peut-être supprimer la configuration et vous reconnecter à l’application externe.
# Configuration de l’intégration pour Shopify afin de fournir des mises à jour régulières à Profils des clients Amazon Connect
Pour fournir des mises à jour périodiques aux profils clients Amazon Connect, vous pouvez intégrer Shopify à l'aide d'Amazon AppIntegrations. Vous configurez d’abord la connexion dans Amazon Connect et Shopify, puis vérifiez l’intégration à Shopify.
## Configuration de la connexion dans Amazon Connect et Shopify
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[Page Instances du centre de contact virtuel Amazon Connect, alias d’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/instance.png)
1. Dans le volet de navigation, choisissez **Profils des clients**.
1. Sur la page **Configuration des profils des clients**, choisissez **Ajouter une intégration**.
![\[La page Configuration des profils des clients, le bouton Ajouter une intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Sur la page **Sélectionner la source**, choisissez **Shopify**. Passez en revue les exigences de l’application répertoriées sur la page **Sélectionner une application**.
![\[La page Sélectionner la source.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. Sur la page **Établir une connexion**, choisissez l’une des options suivantes :
+ **Utiliser une connexion existante** : cela vous permet de réutiliser les EventBridge ressources Amazon existantes que vous avez peut-être créées dans votre Compte AWS.
+ **Créer une connexion** : entrez les informations requises par l’application externe.
![\[La page Établir une connexion.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nom de la connexion** : fournissez un nom à votre connexion. Le nom de la connexion est référencé par les intégrations qui utilisent cette connexion.
+ **URL de connexion** : entrez l’URL de connexion à votre application. Cette URL est utilisée pour créer des liens profonds vers les objets créés dans votre application externe. L’URL de connexion est l’URL de l’application partenaire Shopify disponible sur le site web de l’application.
Pour trouver l’URL de votre application partenaire Shopify :
+ Connectez-vous à votre compte partners.shopify.com.
+ Accédez à votre application.
+ Copiez l’URL depuis votre navigateur.
+ **ID client** : entrez l’ID client de votre application. Il s’agit d’une chaîne qui distingue de manière unique le client dans votre application externe. Cet ID client est le nom de source disponible sur le site web de l’application. Vous utilisez l’ID que vous spécifiez ici pour identifier le client à partir duquel vous souhaitez que la fonctionnalité Profils des clients ingère vos objets. Votre ID client peut être disponible après avoir suivi les étapes dans Configuration de la source.
Pour trouver le nom de votre source :
+ Connectez-vous à votre compte partners.shopify.com.
+ Accédez à votre application.
+ Copiez le nom de la source depuis votre source EventBridge d'événements Amazon.
1. Sur la page de **configuration de la source**, copiez votre Compte AWS identifiant dans votre presse-papiers, puis choisissez **Se connecter à Shopify**.
1. Utilisez les instructions suivantes pour configurer Shopify :
1. Connectez-vous à partners.shopify.com.
1. Sous Amazon EventBridge, choisissez **Create source**.
1. Collez votre Compte AWS identifiant et sélectionnez votre AWS région.
1. Après avoir configuré la destination de la source de l’événement, retournez dans Profils des clients. Vous verrez une alerte indiquant qu’Amazon Connect s’est connecté à Shopify.
1. Sur la page **Options d’intégration**, choisissez les objets source que vous souhaitez ingérer et sélectionnez leur type d’objet.
Les types d’objets stockent les données que vous avez ingérées. Ils définissent également la manière dont les objets de vos intégrations sont mappés aux profils lorsqu’ils sont ingérés. La fonctionnalité Profils des clients fournit des modèles de type d’objet par défaut que vous pouvez utiliser pour définir la façon dont les attributs de vos objets source sont mappés aux objets standard dans Profils des clients. Vous pouvez également utiliser les mappages d'objets que vous avez créés à partir du [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html).
![\[La page Options d’intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Pour la **Date de début de l’ingestion**, la fonctionnalité Profils des clients commence à ingérer les enregistrements créés après l’ajout de l’intégration.
**Note**
Si vous avez besoin d’enregistrements historiques, vous pouvez [utiliser Amazon S3 comme source d’intégration pour les importer](customer-profiles-object-type-mappings.md).
1. Sur la page **Vérifier et intégrer**, vérifiez que le **Statut de la connexion** indique **Connecté(e)**, puis choisissez **Ajouter une intégration**.
**Note**
Après avoir ajouté cette intégration, vous devez [configurer des abonnements webhook](#shopify-webhook-subscriptions) pour permettre aux événements de commencer à entrer dans cette intégration.
![\[La page Vérifier et intégrer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Une fois l’intégration configurée, de retour sur la page de **Configuration des profils des clients**, la section **Intégrations** affiche les intégrations actuellement configurées. Les paramètres **Dernière exécution** et **État de l’intégration** ne sont actuellement pas disponibles pour ce type d’intégration.
![\[La section Intégrations.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Pour voir quelles données sont envoyées, choisissez l’intégration, puis **Afficher les objets**.
1. Passez à l’étape suivante pour utiliser l’API afin de configurer les **abonnements webhook** afin que les événements puissent commencer à entrer dans cette intégration.
## Configuration d’abonnements webhook
1. Utilisez l’URL suivante pour vous assurer que votre application dispose des autorisations requises :
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Où :
+ `shop` est le nom de votre boutique Shopify.
+ `api_key` est la clé API de votre application Shopify. Vous pouvez la trouver sur la page de détails de l’**application** Shopify.
+ `scopes` doit avoir la valeur `read_customers,read_orders,read_draft_orders`.
+ `redirect_uri` est l’URI de redirection que vous avez spécifiée pour votre application lorsque vous l’avez créée. Pour nos besoins, il peut s’agir de n’importe quelle URL valide.
+ `nonce` peut être n’importe quelle valeur unique permettant d’identifier une demande d’autorisation donnée provenant d’autres personnes. Nous vous recommandons d’utiliser un horodatage.
Après avoir créé l’URL, collez-la dans votre navigateur. Une installation/authorization page similaire à l'image suivante s'affiche, demandant au propriétaire de la boutique de donner des autorisations pour l'étendue définie.
![\[Exemple de page Shopify pour installer et autoriser l’application.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Choisissez **Installer une application non répertoriée** pour installer et autoriser l’application pour le compte de votre boutique.
Vous serez redirigé vers l’URI de redirection que vous avez entré avec un code d’autorisation ajouté à l’URI de redirection en tant que paramètre de requête. Par exemple :
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. Copiez le `authorization_code` depuis cet URI. Vous allez l’utiliser pour obtenir un jeton d’accès permanent dans les prochaines étapes.
1. Accédez à l’outil que vous utilisez pour effectuer des appels d’API. Par exemple, [CURL](https://curl.se/) ou [POSTMAN](https://www.postman.com/).
1. Pour obtenir un jeton d’accès permanent, envoyez une requête POST à l’API `Admin` Shopify sur ce point de terminaison :
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
avec le corps de demande suivant :
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Cette requête renvoie la réponse suivante :
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Notez le `access_token`. Il s’agit d’un jeton permanent dont la portée est identique à celle fournie lors d’une étape précédente. Vous êtes maintenant prêt à créer des abonnements webhook.
1. Pour les appels d’API suivants, assurez-vous de définir la clé de l’en-tête HTTP `X-Shopify-Access-Token` sur le `access_token` que vous avez reçu lors de la réponse de l’appel précédent.
1. Pour configurer des abonnements webhook, effectuez la requête POST suivante pour chacune des valeurs `topic` répertoriées à l’étape suivante :
Point de terminaison : `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Corps de la demande :
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. Pour chaque abonnement, remplacez la valeur `topic` par les valeurs suivantes :
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
Vous êtes maintenant prêt à recevoir des événements de votre boutique Shopify. Ensuite, vérifiez votre intégration à Shopify.
## Vérification de votre intégration à Shopify
1. Connectez-vous en tant qu’administrateur à votre boutique Shopify.
1. Dans le menu de navigation de gauche, choisissez **Clients**.
1. Sélectionnez **Ajouter un client**.
1. Entrez vos informations client. Assurez-vous d’entrer un numéro de téléphone et une adresse e-mail. Il n’est pas nécessaire qu’ils appartiennent à un vrai client. Vous supprimerez cette entrée client après avoir vérifié l’intégration.
1. Enregistrez l’objet client.
1. La livraison de l’événement doit être presque instantanée, mais attendez une minute pour qu’elle soit livrée et pour créer un profil client.
1. Ouvrez l’expérience d’agent Amazon Connect et recherchez l’utilisateur à l’aide de l’adresse e-mail ou du numéro de téléphone que vous avez entrés dans la boutique Shopify. Vous devriez pouvoir voir le profil du client avec la même adresse e-mail ou le même numéro de téléphone.
1. Si vous ne pouvez pas voir le profil du client, cela signifie que votre intégration présente un problème. Pour résoudre un problème :
1. Accédez à la EventBridge console Amazon.
1. Vérifiez si le EventSource est actif et si la correspondance EventBus existe et est en cours d'exécution.
Si cela fonctionne, contactez Support pour obtenir de l'aide pour étudier le problème.
## Surveillance de vos intégrations Profils des clients
Une fois votre connexion établie, si elle cesse de fonctionner, supprimez l’intégration, puis rétablissez-la.
## Que faire si des objets ne sont pas envoyés
Si un objet ne parvient pas à être envoyé, choisissez **Détails du flux** pour en savoir plus sur le problème.
Vous devrez peut-être supprimer la configuration et vous reconnecter à l’application externe.
# Configurer l'intégration pour les applications externes à l'aide d'Amazon AppFlow
Ces intégrations utilisent Amazon AppFlow pour fournir des mises à jour périodiques des profils clients Amazon Connect. Les étapes ci-dessous fournissent des conseils sur la configuration du connecteur de votre choix à l'aide d'Amazon AppFlow, la configuration des mappages de données et la configuration des intégrations pour ingérer les données de vos clients.
Pour plus d'informations sur les AppFlow tarifs Amazon, consultez les AppFlow [tarifs](https://aws.amazon.com/appflow/pricing/) Amazon.
Pour plus d'informations sur les connecteurs AppFlow pris en charge par Amazon, consultez [Applications source et destination prises](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html) en charge.
## Avant de commencer
Lorsque vous activez Profils des clients Amazon Connect, vous créez un domaine Profils des clients, qui est un conteneur pour toutes les données, telles que les profils des clients, les types d’objets, les clés de profil et les clés de chiffrement. Voici quelques consignes concernant la création de domaines Profils des clients :
+ Chaque instance Amazon Connect peut être associée à un seul domaine.
+ Vous pouvez créer plusieurs domaines, mais ceux-ci ne partagent pas entre eux les intégrations d’applications externes ni les données client.
+ Toutes les intégrations d’applications externes que vous créez se situent au niveau du domaine. Toutes les instances Amazon Connect associées à un domaine héritent des intégrations du domaine.
**Conditions préalables : activer Profils des clients dans votre instance Amazon Connect**
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
1. Dans le volet de navigation, choisissez **Profils des clients**.
1. Choisissez Activer Profils des clients.
Dans le formulaire, vous devrez remplir tous les champs obligatoires pour créer un domaine Profils des clients en suivant les étapes ci-dessous :
1. **Configuration du domaine**. Vous pouvez créer un nouveau domaine et fournir un nom.
1. **Chiffrement**. Sous Spécifier une clé KMS, vous pouvez activer le chiffrement en sélectionnant une clé AWS KMS existante, en créant une nouvelle clé AWS KMS ou en choisissant **Sélectionner un domaine existant**.
1. **Signalement d’erreurs**. Vous pouvez créer une file d’attente de lettres mortes, qui est une file d’attente SQS pour gérer les erreurs de profil de client
1. Choisissez **Soumettre** et les Profils des clients seront créés à l’aide des informations de l’historique des contacts de votre instance.
### Configuration d'une application externe à l'aide d'Amazon AppFlow
Vous pouvez ajouter une intégration d'application externe à un domaine Amazon Connect Customer Profiles en utilisant Amazon AppFlow en suivant les étapes ci-dessous. Vous devez créer un flux pour votre source de données dans la AppFlow console Amazon et définir Amazon Connect Customer Profiles comme destination avant de continuer dans la console Customer Profiles. Si vous avez créé un flux il y a plus de 14 jours, il a expiré et vous devez créer un nouveau flux pour votre intégration.
Vous pouvez éventuellement effectuer des transformations de données telles que `Arithmetic``Filter`,`Map`,`Map_all`,,`Mask`,`Merge`,`Truncate`, et `Validate` lorsque vous utilisez la CloudFormation `AWS::AppFlow::Flow Task` ressource avant l'ingestion.
1. Connectez-vous à votre console AWS de gestion, sélectionnez Amazon AppFlow, puis choisissez **Create flow**.
![\[La AppFlow page Amazon.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. Entrez un nom de flux et une description de flux (facultative).
![\[La page Détails du flux.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. Vous pouvez laisser la section **Chiffrement des données** telle quelle, car votre domaine Amazon Connect Customer Profiles possède déjà une AWS KMS clé existante qui sera utilisée pour ce flux. Vous pouvez éventuellement créer des balises, puis choisir **Suivant**.
![\[La section Chiffrement des données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. Sélectionnez une application externe de votre choix dans le menu déroulant **Nom de la source**, puis sélectionnez le champ pertinent suivant. Par exemple, si vous souhaitez configurer Slack, sélectionnez Slack dans le menu déroulant **Nom de la source**. Vous pouvez ensuite utiliser un flux Slack existant ou créer une nouvelle connexion.
![\[La page Configurer le flux.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. Si vous avez choisi de créer une nouvelle connexion, vous pouvez ensuite entrer les informations de l’application externe, telles que le nom d’utilisateur, le mot de passe et le sous-domaine. Vous pouvez également sélectionner la AWS KMS clé de chiffrement des données et saisir le nom de la connexion pour identifier cette connexion.
![\[La page Se connecter à Slack.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. Si vous choisissez d’utiliser une connexion existante, vous pouvez sélectionner l’objet d’application externe spécifique dans le menu déroulant. Par exemple, si vous choisissez une connexion Slack existante, vous pouvez sélectionner **Conversations** comme objet, puis choisir le canal Slack spécifique qui sera utilisé.
![\[La page Détails de la source.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. Dans la section **Détails de la destination**, sélectionnez Amazon Connect comme nom de destination dans le menu déroulant et sélectionnez le domaine du profil de client créé à l’étape prérequise précédente.
![\[La section Détails de la destination.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. Sélectionnez un déclencheur de flux en choisissant **Exécuter à la demande** ou **Exécuter le flux selon le calendrier**. Choisissez **Suivant**.
+ **Exécuter à la demande** exécute le flux uniquement lorsque vous le déclenchez.
+ **Exécuter le flux selon le calendrier** exécute le flux à un moment précis à l’aide d’un calendrier. La fréquence du calendrier est limitée à 5 minutes, 15 minutes ou 1 heure.
![\[La section Déclencheur de flux.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. Choisissez **Mapper manuellement les champs** sous **Méthode de mappage**. Choisissez les champs source provenant d’une application externe, puis **Mapper directement les champs**.
![\[La section Méthode de mappage.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. Vérifiez vos sélections et choisissez **Créer un flux**.
Pour plus d'informations sur la création de flux dans la AppFlow console Amazon, consultez [Création de flux dans Amazon AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html).
Pour plus d'informations sur la configuration des applications externes et de nombreuses autres applications prises en charge par Amazon AppFlow, consultez la section [Applications AppFlow source et destination prises en charge par Amazon](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
### Configuration de mappages de données pour définir la manière dont les données d’application externes sont mappées à un Profil de client
Une fois AppFlow l'intégration Amazon configurée, vous devez configurer des mappages de données dans les profils clients afin de définir comment les données de l'application externe seront mappées au profil client. Cela vous permettra de personnaliser les données que vous souhaitez utiliser pour créer votre profil de client unifié. Choisissez votre mappage avec soin, car vous ne pourrez pas choisir un autre mappage après avoir créé l’intégration.
Pour des informations plus détaillées sur les mappages de données, consultez [Mappage des types d’objets](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html).
1. Connectez-vous à votre console AWS de gestion, sélectionnez **Amazon Connect** et choisissez Customer Profiles sous l'alias de votre instance Connect.
![\[La page Profils des clients Amazon Connect.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. Choisissez **Mappages de données**, puis **Créer un mappage de données**. Fournissez un nom et une description au mappage de données.
![\[L’onglet Mappage de données, le bouton Créer un mappage de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[La page Définir un mappage de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. Sous **Options de mappage**, vous pouvez choisir votre **Source de données** comme l’application externe, le **Nom du flux** que vous avez créé dans la section précédente et la **Méthode de définition de données** comme *Destination de mappage*. Sous **Destination de mappage**, vous pouvez choisir les types de données client que vous souhaitez définir pour vos profils des clients unifiés. Choisissez **Suivant**.
![\[La section Options de mappage.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. Ajoutez les attributs du client, du produit, du cas et de la commande avec la source, la destination et le type de contenu, puis choisissez **Suivant**.
![\[La page Mapper les attributs de la commande.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. Sous **Spécifier les identifiants**, vous pouvez sélectionner différents attributs dans votre objet de source de données qui permettent de distinguer vos données des autres objets de source de données. Vous pouvez sélectionner des attributs parmi les identifiants uniques, de client, de produit, de cas et de commande. Pour plus d’informations sur les identifiants, consultez [Identifiants standard pour définir les attributs de la clé dans les profils clients](standard-identifiers.md).
![\[La page Identifiants standard.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. Vérifiez et choisissez **Créer un mappage de données**. Le statut du Mappage de données s’affichera comme étant *Actif*.
![\[Identifiants sur la page Étape 6 : spécifier les identifiants.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### Configuration des intégrations pour ingérer vos données client depuis une application externe
Une fois le mappage de données configuré pour une application externe, vous configurerez l’intégration de la source de données pour ingérer vos données client.
1. Connectez-vous à votre Console de gestion AWS, sélectionnez **Amazon Connect** et choisissez Profils des clients sous l’alias de votre instance Connect.
1. Dans la section **Intégrations de sources de données**, choisissez **Ajouter une intégration de source de données**.
![\[L’onglet Intégrations de sources de données, le bouton Ajouter une intégration de source de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. Dans le menu déroulant **Source de données**, sélectionnez l’application externe et choisissez **Suivant**. Vous avez également la possibilité de choisir **Create new flow**, ce qui ouvrira la AppFlow console Amazon dans un nouvel onglet.
![\[Section Source de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. Dans le menu déroulant **Nom du flux**, sélectionnez le flux que vous souhaitez utiliser à partir de votre source de données et choisissez **Suivant**.
![\[Sélection d’un nom de flux pour établir une connexion.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. Dans le menu déroulant **Mappage de données**, sélectionnez le mappage des données de l’application externe pour l’objet afin de définir la manière dont votre source de données est mappée aux profils. Choisissez **Suivant**.
![\[Sélectionnez la page Mappage des données, le menu déroulant Mappage.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. Vérifiez et choisissez **Ajouter une intégration de source de données**. L’intégration de la source de données de l’application externe sera initialement affichée comme étant en attente avant de passer à un état actif.
![\[Page Vérifier et intégrer, bouton Ajouter une intégration de source de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### Affichage du profil client unifié dans Profils des clients Amazon Connect sur le CCP de l’agent
Vos agents pourront désormais afficher les données client importées depuis une application externe en se connectant au CCP d’agent Amazon Connect. Pour plus d’informations sur la connexion au CCP d’agent Amazon Connect, consultez [Application d’agent : tout en un seul endroit](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application).
Votre agent devra disposer des autorisations de profil de sécurité appropriées pour afficher les Profils des clients et pourra effectuer des recherches à l’aide d’un nom et d’une valeur de clé dans la barre de recherche des profils.
Pour plus d’informations sur les autorisations du profil de sécurité, consultez [Profils de sécurité](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html).
Les utilisateurs avancés qui souhaitent créer leur propre application d’agent personnalisée et leurs profils de clients intégrés peuvent utiliser [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles), qui offrira une plus grande personnalisation par rapport à l’application d’agent.
# Suppression des Profils des clients ou arrêt des intégrations
**Note**
La suppression de mappages supprimera uniquement les objets et les données associés à ce mappage spécifique. Si plusieurs objets sont associés à un profil, la suppression d’un mappage spécifique risque de ne pas effacer les données du profil. Si vous souhaitez supprimer des données spécifiques, vous devez supprimer le mappage, mais vos profils peuvent toujours exister s’ils contiennent des données provenant d’autres mappages. Cela pourrait entraîner des frais supplémentaires pour les profils existants. Vous pouvez supprimer un domaine et toutes les données des profils clients, y compris tous les profils, à l'aide de la [Amazon Connect console](delete-customer-profiles-domain.md) ou de l'[DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API.
**Méthode avec la console**
+ Si, à tout moment, vous souhaitez arrêter l'ingestion des données du profil client, sélectionnez le, integration/mapping puis choisissez **Supprimer**.
+ Pour supprimer les intégrations, les profils clients et toutes les données de profil client, vous pouvez supprimer le domaine de vos profils clients dans la Amazon Connect console. Pour de plus amples informations, veuillez consulter [Suppression d’un domaine de Profils des clients Amazon Connect](delete-customer-profiles-domain.md).
**Méthode avec l’API**
+ Pour supprimer les données des profils des clients pour une intégration spécifique, utilisez l’API `DeleteProfileObjectType`.
+ Pour supprimer les intégrations, les profils des clients et toutes les données de profil de client, utilisez l’API `DeleteDomain`.
Pour réactiver l’ingestion des données du profil de client, suivez à nouveau les étapes de configuration.
# Mappage de type d’objet dans Profils des clients Amazon Connect
Le mappage de type d’objet indique à la fonctionnalité Profils des clients comment ingérer un type de données spécifique. Il fournit des informations essentielles, telles que :
+ Comment les données doivent être renseignées à partir de l’objet et ingérées dans l’objet de profil standard.
+ Quels champs doivent être indexés dans l’objet et comment ces champs doivent ensuite être utilisés pour attribuer des objets de ce type à un profil spécifique.
Les rubriques de cette section fournissent des informations et des étapes pour vous aider à configurer le mappage de type d’objet, notamment comment créer un mappage de type d’objet, les détails de la définition du mappage, ainsi que les concepts clés et la terminologie.
**Topics**
+ [Concepts et terminologie pour les mappages de type d’objet client](customer-profiles-terminology.md)
+ [Création d’un mappage de type d’objet](create-object-type-mapping.md)
+ [Détails de la définition du mappage de type d’objet dans Profils des clients Amazon Connect](object-type-mapping-definition-details.md)
+ [Propriétés supplémentaires des types d’objets dans les Profils de clients](additional-properties-object-types.md)
+ [Profils inférés](inferred-profiles.md)
+ [Modèles d’enregistrement de contacts](ctr-contact-record-template.md)
+ [Associez l’enregistrement de contact à un profil trouvé à l’aide de la clé \$1phone dans Profils des clients](auto-associate-profile-using-phone-profile-key.md)
+ [Exemples de mappages de types d’objets dans Profils des clients Amazon Connect](examples-object-type-mappings.md)
+ [Types d’objets de profil implicites dans Profils des clients Amazon Connect](implicit-profile-object-types.md)
+ [Mappage des données optimisé par l’IA générative](genai-powered-data-mapping.md)
+ [Limites de données des Profils des clients](customer-profiles-data-limits.md)
# Concepts et terminologie pour les mappages de type d’objet client
La terminologie et les concepts suivants sont indispensables à la compréhension des mappages de types d’objets personnalisés.
**Objet de profil standard**
Un *objet de profil standard* est un objet prédéfini que contiennent tous les profils.
Un objet de profil standard contient des champs standard, tels que les numéros de téléphone, les adresses e-mail, le nom et d’autres données standard. Ces données peuvent être récupérées dans un format standard quelle que soit la source (par exemple ServiceNow, Salesforce ou Marketo).
**Objet de profil**
Un *objet de profil* est une unité d’information unique connue sur un profil. Par exemple, les informations concernant un appel téléphonique, un ticket, un cas ou même un enregistrement de clics provenant d’un site web.
Un seul objet de profil peut avoir une taille maximale de 250 Ko et peut être n’importe quel document JSON structuré.
+ Chaque objet de profil possède un type. Par exemple, l'objet de profil peut être un enregistrement de contact Amazon Connect, des ServiceNow utilisateurs ou des prospects Marketo.
+ Le type fait référence au mappage de type d’objet.
+ Le mappage de type d’objet définit la manière dont cet objet spécifique doit être ingéré dans Profils des clients.
**Profil**
Un *profil* contient toutes les informations connues sur un client ou un contact spécifique. Il inclut un seul objet de profil standard et un certain nombre d’objets de profil supplémentaires.
**Mappage de type d’objet**
Le *mappage de type d’objet* indique à la fonctionnalité Profils des clients comment ingérer un type de données spécifique. Il fournit les informations suivantes à la fonctionnalité Profils des clients :
+ Comment les données doivent être renseignées à partir de l’objet et ingérées dans l’objet de profil standard.
+ Quels champs doivent être indexés dans l’objet et comment ces champs doivent ensuite être utilisés pour attribuer des objets de ce type à un profil spécifique.
**Modèle de mappage**
Un *modèle de mappage* est un mappage de type d’objet prédéfini inclus dans le service Profils des clients.
Les profils clients incluent des modèles de mappage pour les enregistrements de contacts Amazon Connect, les comptes Salesforce, ServiceNow les utilisateurs et les prospects Marketo. Pour obtenir la liste complète des modèles de mappage disponibles, utilisez l'[ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API.
Les modèles de mappage vous permettent d’ingérer rapidement des données provenant de sources connues sans avoir à spécifier d’informations supplémentaires.
# Création d’un mappage de type d’objet dans Profils des clients Amazon Connect
Un mappage de type d’objet indique à la fonctionnalité Profils des clients comment intégrer un type spécifique de données provenant d’une application source, telle que Salesforce, Zendesk ou S3, dans un objet de profil standard unifié. Vous pouvez ensuite afficher les données contenues dans cet objet (par exemple : l’adresse postale et l’adresse e-mail du client) à vos agents à l’aide de l’[application d’agent Amazon Connect](customer-profile-access.md).
Le mappage de type d’objet fournit les informations suivantes à la fonctionnalité Profils des clients :
+ Comment les données doivent être renseignées à partir de l’objet et ingérées dans l’objet de profil standard.
+ Quels champs doivent être indexés dans l’objet et comment ces champs doivent ensuite être utilisés pour attribuer des objets de ce type à un profil spécifique.
Il existe deux façons de créer un mappage de type d’objet :
+ Utilisez la console Amazon Connect. L’interface utilisateur rend les fonctionnalités de mappage des données facilement accessibles. Par exemple, vous pouvez ajouter des attributs personnalisés et définir des identifiants de recherche et uniques pour les modèles de contact. Aucun codage requis \$1
+ Utilisez l’API Profils des clients. Pour plus d’informations, consultez la [Référence des API Profils des clients Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
Cette rubrique explique comment créer un mappage à l’aide de la console Amazon Connect.
## Création d’un mappage de données à l’aide de la console Amazon Connect
Amazon Connect fournit une expérience sans code pour cartographier les données clients à partir d'applications locales et tierces avec Amazon S3, Salesforce ServiceNow, Zendesk et Marketo.
Pour créer un mappage de données, vous définissez un mappage de type d’objet qui décrit à quoi ressemble l’objet de profil personnalisé. Ce mappage définit comment les champs de vos données peuvent être utilisés pour renseigner les champs du profil standard ou comment ils peuvent être utilisés pour attribuer les données à un profil spécifique.
### Étape 1 : configurer le mappage de données
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L’image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l’alias d’instance.
![\[Page Instances du centre de contact virtuel Amazon Connect, alias d’instance.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/instance.png)
1. Dans le volet de navigation, choisissez **Profils des clients**, puis **Mappages de données**.
1. Choisissez **Créer un mappage de données** pour commencer.
1. Sur la page **Configurer le mappage de données**, dans la section **Description**, ajoutez un nom qui vous aidera à identifier la source ou le but de ce mappage. Ce sont les métadonnées du type d’objet.
1. Dans la section **Source de données** :
1. Choisissez d’où proviennent les données, par exemple Salesforce ou Zendesk. Sur la base de votre sélection, Amazon Connect sélectionne automatiquement les destinations disponibles en fonction du modèle prédéfini.
1. Choisissez l’objet source. Cela vous permet de créer votre profil unifié.
1. Dans la section **Destination du mappage**, choisissez les données que vous souhaitez utiliser pour créer votre profil de client unifié. Ces informations peuvent être communiquées à vos flux et à vos agents afin de personnaliser les interactions avec les contacts.
Pour plus d’informations sur les destinations de mappage prises en charge, consultez [À propos des destinations de mappage dans Amazon Connect](about-mapping-destinations.md).
1. Dans la section **Options supplémentaires**, vous pouvez choisir à quel moment désactiver la création de nouveaux profils et pendant combien de temps vous souhaitez les conserver. Ces options vous aident à gérer vos coûts.
**Note**
Par défaut, la période de rétention du domaine est de 366 jours. Pour modifier la période de rétention définie pour votre domaine, utilisez l'[UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
1. Si vous avez choisi une source autre que S3, dans la *application* section **Établir une connexion avec**, choisissez une EventBridge connexion Amazon AppFlow ou Amazon existante pour connecter vos données, ou créez une nouvelle connexion. Vous pouvez créer une nouvelle connexion en saisissant les informations relatives à votre compte pour cette source de données.
Une fois la connexion établie, vous choisirez les objets que vous souhaitez ingérer à partir de votre source de données.
1. Choisissez **Suivant**.
### Étape 2 : mapper des attributs
Sur la page **Mapper des attributs *type***, vous verrez le tableau des mappages de champs rempli avec le modèle prédéfini, en fonction de la destination du mappage. Par exemple, il contient les attributs du client, du produit, du cas ou de la commande. Vous pouvez modifier le modèle prédéfini en choisissant un attribut (tel que AccountNumber), puis en sélectionnant une autre destination, ou en saisissant l'un de vos propres attributs personnalisés.
L’image suivante présente un exemple de la page remplie d’attributs client provenant du modèle.
![\[Menu de navigation Amazon Connect, page Attribution du client.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
Vous pouvez supprimer les informations que vous ne souhaitez pas renseigner dans le profil de client, modifier la source et ajouter des attributs personnalisés.
Ce mappage utilise votre source de données pour renseigner les coordonnées du client, telles qu’un numéro de téléphone dans le profil de client. Il utilise les attributs du modèle de profil standard.
**Astuce**
Si vous choisissez d’ajouter des attributs personnalisés, le préfixe `Attributes.` sera toujours ajouté à la destination. Cela permet à Amazon Connect de reconnaître qu’il s’agit d’un attribut personnalisé.
![\[Interface de mappage des attributs clients affichant les champs source mappés aux champs de destination.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/custom-attribute-cp.png)
Les agents peuvent désormais afficher les attributs personnalisés dans l’application d’agent Connect sous l’onglet **Informations supplémentaires**, triés par ordre alphabétique. Vous pouvez créer le nom de votre choix pour chaque attribut qui sera affiché aux agents en utilisant le format suivant : `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
Tous les attributs personnalisés ingérés seront affichés dans l’application d’agent Connect. Si vous ne souhaitez pas montrer certaines informations à vos agents, n’ingérez pas d’attributs personnalisés pour le moment.
### Étape 3 : spécifier les identifiants
Sur la page **Spécifier les identifiants**, complétez les sections suivantes. Selon les données que vous mappez, il est possible qu’elles n’apparaissent pas toutes sur votre page.
**Note**
Les noms `_profileId`, `_orderId`, `_caseId` et `_assetId` sont réservés à un usage interne. Si vous décidez d’utiliser ces noms comme vos noms d’identifiant, ils doivent être déclarés comme `LOOKUP_ONLY`, ce qui signifie que notre système ne les enregistrera pas pour les faire correspondre à des profils, à des ressources standard, à des commandes standard, à des cas standard, ou ne les enregistrera pas pour effectuer des recherches dans votre profil, votre actif, votre cas ou votre commande. Si vous souhaitez que ces clés soient utilisables pour la recherche et la correspondance, vous devez renommer votre clé. Pour plus d’informations sur l’identifiant standard `LOOKUP_ONLY`, consultez [Identifiants standard pour définir les attributs de la clé dans les profils clients](standard-identifiers.md).
+ **Identifiant unique** : vous devez avoir un identifiant unique pour vos données afin d’éviter toute erreur lors de leur ingestion. Cet identifiant est également appelé clé unique. La fonctionnalité Profils des clients l’utilise pour distinguer ces données des autres objets de source de données et pour indexer les données de recherche et de mise à jour.
Il ne peut y avoir qu’un seul identifiant unique.
+ **Identifiant de client** : vous devez avoir au moins un identifiant de client pour vos données afin d’éviter toute erreur lors de leur ingestion. L’identifiant est également appelé clé de profil.
La fonctionnalité Profils des clients l’utilise pour déterminer si le cas de données doit être associé à un profil existant ou utilisé pour créer un nouveau profil en recherchant cet identifiant dans d’autres profils.
Vous pouvez avoir plusieurs identifiants de client.
**Astuce**
Les agents peuvent utiliser n’importe lequel de ces identifiants de client dans l’espace de travail des agents pour trouver le profil qui appartient au client lors de l’interaction.
+ **Identifiant de produit** : vous devez avoir au moins un identifiant de produit pour vos données afin d’éviter toute erreur lors de leur ingestion. L’identifiant est également appelé clé de ressource.
La fonctionnalité Profils des clients l’utilise pour distinguer ces données des autres données d’achat de produits des clients. Il est également utilisé pour déterminer si les données doivent être associées à un profil existant ou utilisées pour créer un nouveau profil en recherchant cet identifiant dans d’autres profils.
Vous pouvez avoir plusieurs identifiants de produit.
+ **Identifiant de cas** : vous devez avoir au moins un identifiant de cas pour vos données afin d’éviter toute erreur lors de leur ingestion. L’identifiant est également appelé clé de cas.
La fonctionnalité Profils des clients l’utilise pour distinguer ces données des autres données de cas des clients. Il est également utilisé pour déterminer si les données doivent être associées à un profil existant ou utilisées pour créer un nouveau profil en recherchant cet identifiant dans d’autres profils.
Vous pouvez avoir plusieurs identifiants de cas.
+ **Identifiant de commande** : vous devez avoir au moins un identifiant de commande pour vos données afin d’éviter toute erreur lors de leur ingestion. L’identifiant est également appelé clé de commande.
La fonctionnalité Profils des clients l’utilise pour distinguer ces données des autres données de commande des clients. Il est également utilisé pour déterminer si les données doivent être associées à un profil existant ou utilisées pour créer un nouveau profil en recherchant cet identifiant dans d’autres profils.
Vous pouvez avoir plusieurs identifiants de commande.
+ **Attributs de recherche supplémentaires : facultatif** : vous pouvez choisir les attributs de votre objet de source de données que vous souhaitez indexer pour être consultables. Par défaut, tous vos identifiants sont indexés.
**Astuce**
Si les attributs de recherche dans les objets de votre source de données contiennent essentiellement la même valeur, cela peut ralentir l’ingestion de données. Nous vous recommandons de créer des attributs de recherche uniques dans vos objets de source de données.
+ **Horodatage de l’objet de données** : l’horodatage de l’objet de données est utilisé pour résoudre les conflits de profil lorsque la Résolution d’identité est activée pour consolider des profils similaires. Lorsque deux profils similaires ou plus ont des enregistrements en conflit, les enregistrements du profil dont l’horodatage a été mis à jour le plus récemment seront utilisés.
Vous pouvez choisir un attribut de votre objet à référencer à la date de dernière mise à jour de votre objet.
### Étape 4 : vérifier et créer
Une fois le mappage de données créé, vous pouvez choisir **Ajouter une intégration de source de données** pour utiliser ce type d’objet.
![\[Interface Profils des clients Amazon Connect présentant des exemples de détails de mappage de données et le statut de l’intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# À propos des destinations de mappage dans Amazon Connect
Une destination de mappage est votre mappage depuis une source vers une définition standard déjà définie dans Amazon Connect.
Le tableau suivant répertorie les destinations de mappage prises en charge.
| Objet source | Destination : client, produit, commande, cas |
| --- | --- |
| S3 | N’importe lequel |
| Salesforce-Account | Client |
| Salesforce-Contact | Client |
| Salesforce-Asset | Produit (langue française non garantie) |
| Zendesk-users | Client |
| Marketo-leads | Client |
| Servicenow-sys\$1user | Client |
| Segment-Identify | Client |
| Segment-Customer | Client |
| Shopify-Customer | Client |
| Shopify- DraftOrder | Ordre |
| Zendesk-tickets | Cas |
| Servicenow-task | Cas |
| Servicenow-incident | Cas |
# Exigences relatives au mappage de type d’objet dans Profils clients
Les informations suivantes doivent figurer dans votre mappage de type d’objet pour que la fonctionnalité Profils des clients puisse traiter les données entrantes :
+ Une définition de tous les champs de l’objet ingéré qui doivent être mappés au profil standard ou utilisés pour attribuer les données à un profil. Cela indique à la fonctionnalité Profils des clients quels champs de l’objet **source** ingéré doivent être mappés aux champs donnés de l’objet de profil standard.
+ Quels champs de l’objet source provenant de vos données personnalisées doivent être indexés et comment.
Lorsque les données sources sont ingérées par Profils des clients, les champs indexés déterminent :
+ À quel profil appartient un objet spécifique.
+ Quels objets sont liés les uns aux autres et doivent être placés dans le même profil. Par exemple, un numéro de compte ou un ID de contact dans un enregistrement de contact.
+ Quelles valeurs peuvent être utilisées pour trouver un profil. Par exemple, le nom du contact peut être indexé. Cela permettrait aux agents de trouver tous les profils appartenant à des clients portant un nom spécifique.
## Exigences relatives aux clés
Vous devez définir au moins une clé. La fonctionnalité Profils des clients utilise cette clé pour mapper votre objet de profil personnalisé à un profil.
Le mappage d’objets de profil personnalisé nécessite également au moins une clé identifiant l’objet de manière unique afin qu’il puisse être mis à jour en spécifiant la même valeur de ce champ (ces exigences peuvent être satisfaites avec une seule clé).
Chaque clé peut être composée d’un ou de plusieurs champs.
## Exigences relatives au champ
Une définition de champ indique comment lire une valeur pour le nom de ce champ à partir d’un objet source. La définition du champ indique également le type de données stocké dans le champ.
Les noms des types d’objets peuvent être n’importe quelle chaîne alphanumérique ou les caractères « - » et « \$1 ». Ils ne peuvent pas non plus commencer par le caractère « \$1 », qui est utilisé pour les types d’objets standard réservés.
# Détails de la définition du mappage de type d’objet dans Profils des clients Amazon Connect
La définition du mappage de type d’objet comporte deux parties : la définition du champ et la définition de la clé.
**Astuce**
Pour savoir comment créer un mappeur de type d’objet, consultez ce billet de blog : [Unification et organisation des informations client avec les profils clients Amazon Connect grâce au connecteur Amazon S3 préconçu](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/). Vous pouvez également regarder cette vidéo sur YouTube : [Comment intégrer les données de profil client dans les expériences de votre centre de contact](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s).
## Détails de la définition des champs
La définition des champs définit la source, la destination (cible) et le type de champ. Par exemple :
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source` : il peut s’agir d’un accesseur JSON pour le champ ou d’une macro Handlebars pour générer la valeur du champ.
L’objet source en cours d’analyse est nommé ` _source`, de sorte que tous les champs des champs source doivent être précédés par cette chaîne. Seul l’objet `_source` est pris en charge.
Utilisez la solution de macro Handlebars pour générer des constantes et combiner plusieurs champs d’objet source en un seul champ. Ceci est utile pour l’indexation.
+ `Target` : spécifie où, dans un type d’objet standard, les données de ce champ doivent être mappées.
Le remplissage du profil standard vous permet d’utiliser les données ingérées à partir de n’importe quelle source de données avec des applications basées sur la fonctionnalité Profils des clients sans aucune connaissance spécifique du format des données ingérées.
Ce champ est facultatif. Vous pouvez souhaiter définir des champs uniquement dans le but de les inclure dans une clé.
Le format de ce champ est toujours un accesseur JSON. Le seul objet cible pris en charge est `_profile`.
+ `ContentType` : les valeurs suivantes sont prises en charge : STRING, NUMBER, PHONE\$1NUMBER, EMAIL\$1ADDRESS, NAME. Si aucun `ContentType` n’est spécifié, la valeur STRING est supposée.
Le `ContentType` est utilisé pour déterminer comment indexer la valeur afin que les agents puissent la rechercher. Par exemple, si `ContentType` est défini sur PHONE\$1NUMBER, un numéro de téléphone est traité afin que les agents puissent le rechercher dans n’importe quel format : la chaîne « \$115551234567 » correspond à « (555)-123-4567 ».
## Détails de la définition de clé
Une clé contient un ou plusieurs champs qui définissent ensemble une clé qui peut être utilisée pour rechercher des objets (ou les profils auxquels ils appartiennent) à l'aide de l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API. La clé peut également être définie pour identifier de manière unique un profil ou pour identifier de manière unique l’objet lui-même.
```
"Keys": {
"{keyName}": [{
"StandardIdentifiers": [...],
"FieldNames": [ "{fieldname}", ...]
}], ...
}, ...
```
Les noms de clé sont globaux pour un domaine. Si vous avez deux clés portant le même nom dans deux mappages de types d’objets différents :
+ Ces clés doivent occuper le même espace de noms
+ Elles peuvent être utilisées pour éventuellement lier des profils entre différents objets. Si elles correspondent entre les objets, la fonctionnalité Profils des clients place les deux objets dans le même profil.
Pour le dire autrement : les clés doivent avoir le même nom de clé dans un domaine si, et seulement si, la même valeur signifie qu’elles sont liées. Par exemple, un numéro de téléphone spécifié dans un type d’objet serait lié au même numéro de téléphone spécifié dans un autre type d’objet. Un identifiant interne spécifié pour un objet importé depuis Salesforce peut ne pas être lié à un autre objet importé depuis Marketo, même s’il a exactement la même valeur.
Les définitions de clés sont utilisées de deux façons :
+ Dans la fonctionnalité Profils des clients lors de l’ingestion, ils sont utilisés pour déterminer le profil auquel l’objet doit être attribué.
+ Ils vous permettent d'utiliser l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher la valeur clé et trouver le profil.
## Clés de recherche par défaut
Les clés de recherche par défaut, telles que `_phone` et `_email`, sont prédéfinies par le modèle d’objet [Profil standard](standard-profile-definition.md), [Ressource standard](standard-asset-definition.md), [Commande standard](standard-order-definition.md) et [Cas standard](standard-case-definition.md). Vous pouvez utiliser les clés de recherche par défaut comme nom de clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour trouver un profil.
# Identifiants standard pour définir les attributs de la clé dans les profils clients
Les identifiants standard vous permettent de définir des attributs sur la clé. Décidez quels identifiants utiliser en fonction de la manière dont vous souhaitez que les données soient ingérées dans les profils. Par exemple, vous marquez un numéro de téléphone avec l’identifiant PROFILE. Cela signifie que le numéro de téléphone doit être traité comme un identifiant unique. Si la fonctionnalité Profils des clients reçoit deux contacts portant le même numéro de téléphone, les contacts seront fusionnés en un seul profil.
| Nom de l’identifiant | Description |
| --- | --- |
| AIR\$1PREFERENCE | Cet identifiant signifie que cette clé identifie de manière unique une préférence aérienne. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute préférence aérienne à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | Cet identifiant signifie que cette clé identifie une préférence aérienne de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute réservation aérienne à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | Cet identifiant signifie que cette clé identifie un segment aérien de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche tout segment aérien à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | Cet identifiant signifie que cette clé identifie une préférence d’hôtel de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute préférence d’hôtel à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1STAY\$1REVENUE | Cet identifiant signifie que cette clé identifie un revenu lié aux séjours en hôtel. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche tout revenu lié aux séjours en hôtel à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | Cet identifiant signifie que cette clé identifie une réservation d’hôtel de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute réservation d’hôtel auquel cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | Cet identifiant signifie que cette clé identifie une fidélité de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute fidélité à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | Cet identifiant signifie que cette clé identifie une transaction de fidélité de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute transaction de fidélité à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | Cet identifiant signifie que cette clé identifie un programme de fidélité de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche tout programme de fidélité auquel cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | Cet identifiant doit être spécifié par un index exactement pour chaque type d’objet. Cette clé est utilisée pour identifier de manière unique les objets du type d’objet afin de les récupérer ou, si nécessaire, de mettre à jour un objet soumis à une date ultérieure. Tous les champs qui constituent les clés UNIQUE doivent être spécifiés lors de la soumission d’un nouvel objet, faute de quoi celui-ci est rejeté. |
| PROFILE | Cet identifiant signifie que cette clé identifie un profil de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche tout profil auquel cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| LOOKUP\$1ONLY | Cet identifiant indique que la clé n’est pas stockée après l’ingestion de l’objet. La clé ne doit être utilisée que pour déterminer le profil lors de l’ingestion. La valeur clé n’est pas associée au profil lors de l’ingestion, ce qui signifie qu’elle ne peut pas être utilisée pour permettre de la rechercher ou faire correspondre des objets ultérieurement ingérés à la même clé. Vous ne pouvez pas spécifier une clé à la fois comme identifiant `UNIQUE` et comme identifiant `LOOKUP_ONLY`. Vous ne pouvez utiliser `PROFILE` avec `LOOKUP_ONLY` que s’il existe au moins une autre clé qui possède l’identifiant `PROFILE` sans les identifiants `NEW_ONLY` ou `LOOKUP_ONLY`. La seule exception est la clé `_profileId`, qui peut avoir elle-même la combinaison d’identifiant `PROFILE` et `LOOKUP_ONLY`. |
| NEW\$1ONLY | Si le profil n’existe pas avant l’ingestion de l’objet, la clé est associée au profil. Sinon, la clé est uniquement utilisée pour faire correspondre les objets aux profils. Vous ne pouvez pas spécifier une clé à la fois comme identifiant `UNIQUE` et comme identifiant `NEW_ONLY`. Vous ne pouvez utiliser `PROFILE` avec `NEW_ONLY` que s’il existe au moins une autre clé qui possède l’identifiant `PROFILE` sans les identifiants `NEW_ONLY` ou `LOOKUP_ONLY`. |
| SECONDARY | Lors de la mise en correspondance d’un objet avec un profil, la fonctionnalité Profils des clients recherche d’abord toutes les clés PROFILE qui ne possèdent pas l’identifiant SECONDARY. Elles sont prises en compte en premier. Les clés SECONDARY ne sont prises en compte que si aucun profil correspondant n’est trouvé à l’aide de ces clés. |
| RESSOURCE | Cet identifiant signifie que cette clé identifie une ressource de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute ressource à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | Cet identifiant signifie que cette clé identifie une commande de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche toute commande à laquelle cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
| CASE | Cet identifiant signifie que cette clé identifie un cas de manière unique. Lorsque cet identifiant est spécifié, cela signifie que lors de l’ingestion, la fonctionnalité Profils des clients recherche tout cas auquel cette clé est associée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/standard-identifiers.html) |
## Identifiants compatibles
![\[Matrice montrant les identifiants autorisés et restreints et les noms de clé pour différents types de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Comment les Profils clients traitent les définitions clés
Lorsque la fonctionnalité Profils des clients ingère les mappages d’objets personnalisés, elle traite les définitions de clés. Le schéma suivant montre comment elle traite les identifiants standard dans les définitions de clés afin de déterminer le profil auquel attribuer l’objet.
![\[Organigramme illustrant le processus de vérification des clés de profil pour l’attribution ou la mise en file d’attente d’objets.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-template1.png)
# Comment les Profils clients ajoutent des clés à l’index pour les recherches
Le schéma suivant montre comment a fonctionnalité Profils des clients traite les identifiants standard pour déterminer s’il convient de conserver la clé.
![\[Un organigramme qui montre le processus de décision concernant la persistance des clés dans les profils clients en fonction de critères de recherche et de nouveaux objets.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-template2.png)
L’organigramme montre les étapes suivantes :
1. La clé a-t-elle la valeur `LOOKUP_ONLY` de spécifiée ?
+ Si oui, n’en faites pas une clé persistante.
1. Si non, la clé a-t-elle la valeur `NEW_ONLY` de spécifiée ?
+ Si non, enregistrez la clé dans l’index pour permettre son utilisation pour les recherches.
1. Si oui, l’ingestion de l’objet a-t-elle entraîné la création d’un nouveau profil ?
+ Si oui, enregistrez la clé dans l’index pour permettre son utilisation pour les recherches.
+ Si non, n’en faites pas une clé persistante dans l’index pour les recherches futures.
# Mappage de type d’objet au profil standard dans Profils des clients Amazon Connect
Les rubriques de cette section fournissent la définition du profil standard et le mappage de type d’objet entre les applications externes et le profil standard.
**Topics**
+ [Conditions d' AppFlowaccès à Amazon](appflow-access-requirements-profile.md)
+ [Conditions d' AppIntegrations accès à Amazon](standard-profile-appintegrations-requirements.md)
+ [Conditions EventBridge d'accès à Amazon dans les profils clients](standard-profile-eventbridge-requirements.md)
+ [Définition de profil standard](standard-profile-definition.md)
+ [Mappage des objets Salesforce](mapping-salesforce-objects.md)
+ [Mappage des objets Zendesk](mapping-zendesk-objects.md)
+ [Mappage des objets Marketo](mapping-marketo-objects.md)
+ [ServiceNowObjets de mappage](mapping-servicenow-objects.md)
+ [Mappage des objets Segment](mapping-segment-objects.md)
+ [Mappage des objets Shopify](mapping-shopify-objects.md)
# Conditions AppFlow d'accès à Amazon dans les profils clients
Respectez les exigences AppFlow d'accès Amazon suivantes pour créer et supprimer les profils clients Zendesk, Marketo, Salesforce et ServiceNow les intégrations avec Amazon Connect :
+ flux d'applications : CreateFlow
+ flux d'applications : DeleteFlow
# Conditions AppIntegrations d'accès à Amazon dans les profils clients
Respectez les exigences AppIntegrations d'accès Amazon suivantes pour créer et supprimer des intégrations Segment et Shopify avec les profils clients Amazon Connect :
+ intégrations d'applications : GetEventIntegration
+ intégrations d'applications : ListEventIntegrationAssociations
+ intégrations d'applications : CreateEventIntegrationAssociation
+ intégrations d'applications : DeleteEventIntegrationAssociation
# Conditions EventBridge d'accès à Amazon dans les profils clients
Respectez les exigences EventBridge d'accès Amazon suivantes pour créer et supprimer des intégrations Segment et Shopify avec les profils clients Amazon Connect :
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Définition de profil standard dans Profils des clients Amazon Connect
Le tableau suivant répertorie tous les champs de l’objet de profil standard Profils des clients.
| Champ de profil standard | Type de données | Description |
| --- | --- | --- |
| ProfileId | String | L’identifiant unique d’un profil de client. |
| AccountNumber | String | Le numéro de compte unique que vous avez communiqué au client. |
| AdditionalInformation | String | Toute information supplémentaire relative au profil de client. |
| PartyType | String | Le type de profil utilisé pour décrire le client. Valeurs valides : INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | String | Le nom de l’entreprise du client. |
| FirstName | String | Le prénom du client. |
| MiddleName | String | Le deuxième prénom du client. |
| LastName | String | Le nom de famille du client. |
| BirthDate | String | La date de naissance du client. |
| Gender | String | Le genre auquel le client s’identifie. |
| PhoneNumber | String | Le numéro de téléphone du client, qui n’a pas été spécifié en tant que numéro de téléphone portable, domestique ou professionnel. |
| MobilePhoneNumber | String | Le numéro de téléphone portable du client. |
| HomePhoneNumber | String | Le numéro de téléphone fixe du client. |
| BusinessPhoneNumber | String | Le numéro de téléphone professionnel du client. |
| EmailAddress | String | L’adresse e-mail du client, qui n’a pas été spécifiée comme adresse personnelle ou professionnelle. |
| PersonalEmailAddress | String | L’adresse e-mail personnelle du client. |
| BusinessEmailAddress | String | L’adresse e-mail professionnelle du client. |
| Adresse | Adresse | Une adresse générique associée au client qui n’est pas destinée à l’envoi, à l’expédition ou à la facturation. |
| ShippingAddress | Adresse | L’adresse de livraison du client. |
| MailingAddress | Adresse | L’adresse postale du client. |
| BillingAddress | Adresse | L’adresse de facturation du client. |
| Attributes | String-to-string carte | Paire d’attributs clé-valeur d’un profil client. |
| ProfileType | String | Le type du profil. Valeurs valides : PROFILE \$1 ACCOUNT\$1PROFILE |
| EngagementPreferences | EngagementPreferences | Les préférences d’engagement du client ou du compte. |
Les objets de profil standard sont indexés par les clés du tableau suivant.
| Nom d’index standard | Champ de profil standard |
| --- | --- |
| \$1phone | PhoneNumber, MobilePhoneNumber HomePhoneNumber, ou BusinessPhoneNumber |
| \$1e-mail | EmailAddress PersonalEmailAddress, ou BusinessEmailAddress |
| \$1account | AccountNumber |
| \$1profileId | ProfileId |
| \$1fullName | "FirstName MiddleName LastName" |
Par exemple, vous pouvez l'utiliser `_phone` comme nom de clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour trouver un profil dont BusinessPhoneNumber l'attribut PhoneNumber MobilePhoneNumber HomePhoneNumber,, ou correspond à la valeur de recherche.
## Type de données d’adresse
| Champ de profil standard | Type de données | Description |
| --- | --- | --- |
| Address1 | String | La première ligne de l’adresse d’un client. |
| Address2 | String | La deuxième ligne de l’adresse d’un client. |
| Address3 | String | La troisième ligne de l’adresse d’un client. |
| Address4 | String | La quatrième ligne de l’adresse d’un client. |
| City | String | La ville dans laquelle habite le client. |
| Country | String | Le pays dans lequel habite le client. |
| County | String | Le comté dans lequel habite le client. |
| PostalCode | String | La code postal de l’adresse du client. |
| Province | String | La province dans laquelle habite le client. |
| State | String | L’état dans lequel habite le client. |
## EngagementPreferences type de données
| Champ de profil standard | Type de données | Description |
| --- | --- | --- |
| E-mail | Tableau d' ContactPreference objets | Liste des préférences de contact liées aux e-mails. |
| Téléphone | Tableau d' ContactPreference objets | Liste des préférences de contact liées au téléphone. |
## ContactPreference type de données
| Champ de profil standard | Type de données | Description |
| --- | --- | --- |
| KeyName | String | Un identifiant unique et recherchable d’un profil de client. |
| KeyValue | String | La valeur clé utilisée pour rechercher le profil en fonction de la valeur keyName. |
| ProfileId | String | L’identifiant unique d’un profil de client. |
| ContactType | String | Type de contact utilisé pour l’engagement. Valeurs valides : PhoneNumber \$1 MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# Mappage des objets Salesforce au profil standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Salesforce se mappent aux champs de l’objet de profil standard dans Profils des clients.
## Objet Salesforce-Account
Voici une liste de tous les champs dans un objet Salesforce-Account. Les champs de votre objet Salesforce-Account peuvent varier en fonction de la configuration de votre instance Salesforce.
+ Id
+ IsDeleted
+ MasterRecordId
+ Nom
+ Type
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.Ville
+ BillingAddress.Pays
+ BillingAddress. Précision du géocode
+ BillingAddress.latitude
+ BillingAddress.longitude
+ BillingAddress. Code postal
+ BillingAddress.état
+ BillingAddress.rue
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.ville
+ ShippingAddress.pays
+ ShippingAddress.latitude
+ ShippingAddress.longitude
+ ShippingAddress. Code postal
+ ShippingAddress.état
+ ShippingAddress.rue
+ Téléphone
+ Fax
+ AccountNumber
+ Site Web
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ Description
+ Rating
+ Site
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Jigsaw
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer
## Mappage d’un objet Salesforce-Account à un profil standard
Un sous-ensemble des champs dans l’objet Salesforce-Account se mappe à l’objet de profil standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Salesforce-Account et le profil standard. (Le tableau inclut le mappage d’une instance Salesforce configurée pour inclure des champs de type Personne.)
| Champ source Salesforce-Account | Champ cible du profil standard |
| --- | --- |
| Id | Attributs. sfdcAccountId |
| Nom | BusinessName |
| Téléphone | PhoneNumber |
| BillingStreet | BillingAddress. Adresse 1 |
| BillingCity | BillingAddress.Ville |
| BillingState | BillingAddress.État |
| BillingCountry | BillingAddress.Pays |
| BillingPostalCode | BillingAddress.PostalCode |
| ShippingStreet | ShippingAddress. Adresse 1 |
| ShippingCity | ShippingAddress.Ville |
| ShippingState | ShippingAddress.État |
| ShippingCountry | ShippingAddress.Pays |
| ShippingPostalCode | ShippingAddress.PostalCode |
| IsPersonAccount | PartyType |
| PersonMobilePhone | MobilePhoneNumber |
| PersonHomePhone | HomePhoneNumber |
| PersonEmail | PersonalEmailAddress |
| PersonMailingAddress.Rue | MailingAddress. Adresse 1 |
| PersonMailingAddress.Ville | MailingAddress.Ville |
| PersonMailingAddress.État | MailingAddress.État |
| PersonMailingAddress.Pays | MailingAddress.Pays |
| PersonMailingAddress.PostalCode | MailingAddress.PostalCode |
| PersonBirthDate | BirthDate |
| PersonOtherStreet | Address.Address1 |
| PersonOtherCity | Address.City |
| PersonOtherState | Address.State |
| PersonOtherCountry | Address.Country |
| PersonOtherPostalCode | Adresse. PostalCode |
| FirstName | FirstName |
| LastName | LastName |
| MiddleName | MiddleName |
| AccountNumber | AccountNumber |
Les données client Salesforce-Account issues de l’objet Salesforce sont associées à un Profil des clients Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Salesforce-Account |
| --- | --- |
| \$1salesforceAccountId | Id |
Par exemple, vous pouvez l'utiliser `_salesforceAccountId` comme nom de clé avec l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil. Vous pouvez trouver les objets Salesforce-Account associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Salesforce-Account`
## Objet Salesforce-Contact
Voici une liste de tous les champs dans un objet Salesforce-Contact.
+ Id
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ Nom
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.ville
+ OtherAddress.pays
+ OtherAddress. Précision du géocode
+ OtherAddress.latitude
+ OtherAddress. Code postal
+ OtherAddress.état
+ OtherAddress.rue
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.ville
+ MailingAddress.pays
+ MailingAddress. Précision du géocode
+ MailingAddress.latitude
+ MailingAddress.longitude
+ MailingAddress. Code postal
+ MailingAddress.état
+ MailingAddress.rue
+ Téléphone
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ E-mail
+ Titre
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ Description
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ Dernière CURequest date
+ Dernière CUUpdate date
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## Mappage d’un objet Salesforce-Contact à un profil standard
Un sous-ensemble des champs dans l’objet Salesforce-Contact se mappe à l’objet de profil standard dans Profils des clients. Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Salesforce-Contact et l’objet de profil standard.
| Champ source Salesforce-Contact | Champ cible du profil standard |
| --- | --- |
| Id | Attributs. sfdcContactId |
| AccountId | Attributs. sfdcAccountId |
| LastName | LastName |
| FirstName | FirstName |
| MiddleName | MiddleName |
| OtherStreet | Address.Address1 |
| OtherCity | Address.City |
| OtherState | Address.State |
| OtherCountry | Address.Country |
| OtherPostalCode | Adresse. PostalCode |
| MailingStreet | MailingAddress. Adresse 1 |
| MailingCity | MailingAddress.Ville |
| MailingState | MailingAddress.État |
| MailingCountry | MailingAddress.Pays |
| MailingPostalCode | MailingAddress.PostalCode |
| Téléphone | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| E-mail | EmailAddress |
| Birthdate | BirthDate |
Les données client Salesforce-Contact issues d’un objet Salesforce sont associées à un Profil des clients Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Salesforce-Contact |
| --- | --- |
| \$1salesforceContactId | Id |
| \$1salesforceAccountId | AccountId |
Par exemple, vous pouvez utiliser `_salesforceAccountId` et `_salesforceContactId` comme nom de clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil. Vous pouvez trouver les objets Salesforce-Contact associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Salesforce-Contact`
# Mappage des objets Zendesk au profil standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Zendesk se mappent aux champs dans le profil standard dans Profils des clients.
## Objet Zendesk-users
Voici une liste de tous les champs d’un objet Zendesk-users.
+ id
+ url
+ external\$1id
+ e-mail
+ actif
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ détails
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ rôle
+ shared
+ tags
+ Signature
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## Mappage des utilisateurs de Zendesk à un profil standard
Un sous-ensemble des champs dans l’objet Zendesk-users se mappe au profil standard dans Profils des clients. Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Zendesk-users et le profil standard.
| Champ source Zendesk-users | Champ cible du profil standard |
| --- | --- |
| id | Attributs. ZendeskUserId |
| external\$1id | Attributs. ZendeskExternalId |
| e-mail | EmailAddress |
| phone | PhoneNumber |
Les données client Zendesk-users issues de l’objet Zendesk sont associées à un Profil des clients Amazon Connect à l’aide des index suivants.
| Nom d’index standard | Champ source Zendesk-user |
| --- | --- |
| \$1zendeskUserId | Id |
| \$1zendeskExternalId | external\$1id |
Par exemple, vous pouvez utiliser `_zendeskUserId` et `_zendeskExternalId` comme nom clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil client Amazon Connect. Vous pouvez trouver les objets Zendesk Users associés à un profil client spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et défini sur. `ObjectTypeName` `Zendesk-users`
# Mappage des objets Marketo au profil standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Marketo se mappent aux champs de l’objet de profil standard dans Profils des clients.
## Objet Marketo-leads
Voici une liste de tous les champs d’un objet Marketo-leads.
+ id
+ firstName
+ lastName
+ middleName
+ e-mail
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ adresse
+ city
+ state
+ country
+ postalcode
+ gender
+ dateOfBirth
## Mappage des Marketo-leads à un profil standard
Un sous-ensemble de champs de l’objet Marketo-leads se mappe au profil standard.
| Champ source Marketo-leads | Champ cible du profil standard |
| --- | --- |
| id | Attributs. MarketoLeadId |
| sfdcAccountId | Attributs. sfdcAccountId |
| sfdcContactId | Attributs. sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| e-mail | EmailAddress |
| phone | PhoneNumber |
| mobilePhone | MobilePhoneNumber |
| mobilePhone | MobilePhoneNumber |
| billingStreet | BillingAddress. Adresse 1 |
| billingCity | BillingAddress.Ville |
| billingState | BillingAddress.État |
| billingCountry | BillingAddress.Pays |
| billingPostalCode | BillingAddress.PostalCode |
| adresse | Address.Address1 |
| city | Address.City |
| state | Address.State |
| country | Address.Country |
| postalcode | Adresse. PostalCode |
| gender | Gender |
| dataOfBirth | BirthDate |
Les données client Marketo-leads issues de Marketo sont associées à un Profil des clients Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Marketo-leads |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
Par exemple, vous pouvez utiliser `_marketoLeadId``_salesforceAccountId`, et `_salesforceContactId` comme nom clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil client Amazon Connect. Vous pouvez trouver les objets Marketo-leads associés à un profil client spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Marketo-leads`
# Associer ServiceNow des objets à l'objet de profil standard dans Amazon Connect Customer Profiles
Cette rubrique répertorie les champs ServiceNow des objets qui correspondent aux champs de l'objet de profil standard dans Amazon Connect Customer Profiles.
## Objet Servicenow-sys\$1user
Voici une liste de tous les champs d’un objet Servicenow-sys\$1user.
+ sys\$1id
+ actif
+ building
+ calendar\$1integration
+ city
+ company
+ cost\$1center
+ country
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ e-mail
+ employee\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ location
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ name
+ notification
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ roles
+ schedule
+ source
+ state
+ street
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ sys\$1domain.link
+ sys\$1domain.value
+ sys\$1domain\$1path
+ sys\$1id
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1udpated\$1on
+ time\$1format
+ time\$1zone
+ title
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip
## Mappage de Servicenow-sys\$1users à un objet de profil standard
Un sous-ensemble des champs dans l’objet Servicenow-sys\$1users se mappe à l’objet de profil standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Servicenow-sys\$1users et le profil standard.
| Champ source Servicenow-sys\$1users | Champ cible des profils des clients |
| --- | --- |
| sys\$1id | Attributs. ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | Gender |
| e-mail | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| city | Address.City |
| state | Address.State |
| country | Address.Country |
| zip | Adresse. PostalCode |
Les données client Servicenow-sys\$1user issues de l’objet Servicenow sont associées à un Profil des clients Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Servicenow-sys\$1user |
| --- | --- |
| \$1 serviceNowSystem Identifiant | sys\$1id |
Par exemple, vous pouvez utiliser `_serviceNowSystemId` et `_serviceNowIncidentId` comme nom clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil client Amazon Connect. Vous pouvez trouver les objets ServiceNow-SYS\$1User associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le et défini sur. `ProfileId` `ObjectTypeName` `Servicenow-sys_user`
# Mappage des objets Segment vers l’objet de profil standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Segment se mappent aux champs de l’objet de profil standard dans Profils des clients Amazon Connect.
## Objet Segment-Identify
Voici une liste de tous les champs d’un objet Segment-Identify.
+ userId
+ common fields : consultez [Spec: Common Fields](https://segment.com/docs/connections/spec/common/) dans la documentation Segment
+ Segment reserved traits : consultez [Traits](https://segment.com/docs/connections/spec/identify/#traits) dans la documentation Segment
+ traits.address.street
+ traits.address.city
+ traits.address.state
+ traits.address.postalCode
+ traits.address.country
+ traits.age
+ traits.avatar
+ traits.birthday
+ traits.company.name
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website
## Mappage de Segment-Identify à un objet de profil standard
Un sous-ensemble des champs dans l’objet Segment-Identify se mappe à l’objet de profil standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Segment-Identify et le profil standard.
| Champ source Segment-Identify | Champ cible du profil standard |
| --- | --- |
| | Champ cible du profil standard |
| userId | Attributs. SegmentUserId |
| traits.company.name | BusinessName |
| traits.firstName | FirstName |
| traits.lastName | LastName |
| traits.birthday | BirthDate |
| traits.gender | Gender |
| traits.phone | PhoneNumber |
| traits.email | EmailAddress |
| traits.address.street | Address.Address1 |
| traits.address.city | Address.City |
| traits.address.state | Address.State |
| traits.address.country | Address.Country |
| traits.address.postalCode | Adresse. PostalCode |
### Exemple
L’exemple suivant montre comment mapper un champ source à un champ cible.
```
"segmentUserId": {
"Source": "_source.detail.event.detail.userId",
"Target": "_profile.Attributes.SegmentUserId"
}
```
Les données client Segment-Identify issues de l’objet Segment sont associées à un Profil des clients Amazon Connect à l’aide de l’index suivant.
| Nom d’index standard | Champ source Segment-Identify |
| --- | --- |
| \$1segmentUserId | userId |
Par exemple, vous pouvez l'utiliser `_segmentUserId` comme nom clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil client Amazon Connect. Vous pouvez trouver les objets Segment-Identify associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Segment-Identify`
# Mappage des objets Shopify vers l’objet de profil standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Shopify se mappent aux champs de l’objet de profil standard dans Profils des clients Amazon Connect.
## Objet Shopify-Customer
Voici une liste de tous les champs d’un objet Shopify-Customer.
+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ adresses
+ currency
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ e-mail
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ phone
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ state
+ tags
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## Mappage d’un objet Shopify-Customer à un profil standard
Un sous-ensemble des champs dans l’objet Shopify-Customer se mappe à l’objet de profil standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Shopify-Customer et le profil standard.
| Champ source Shopify-Customer | Champ cible du profil standard |
| --- | --- |
| id | Attributs. ShopifyCustomerId |
| email | EmailAddress |
| first\$1name | FirstName |
| last\$1name | LastName |
| note | AdditionalInformation |
| phone | PhoneNumber |
| default\$1address.address1 | Address.Address1 |
| default\$1address.address2 | Address.Address2 |
| default\$1address.city | Address.City |
| default\$1address.province | Address.Province |
| default\$1address.country | Address.Country |
| default\$1address.zip | Adresse. PostalCode |
### Exemple
L’exemple suivant montre comment mapper un champ source à un champ cible.
```
"shopifyCustomerId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_profile.Attributes.ShopifyCustomerId"
}
```
Les données client Shopify-Customer issues de l’objet Shopify sont associées à un Profil des clients Amazon Connect à l’aide de l’index suivant.
| Nom d’index standard | Champ source Shopify-Customer |
| --- | --- |
| \$1shopifyCustomerId | id |
Par exemple, vous pouvez l'utiliser `_shopifyCustomerId` comme nom clé dans l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API pour rechercher un profil client Amazon Connect. Vous pouvez trouver les objets Shopify-Customer associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Shopify-Customer`
# Mappage de type d’objet à la commande standard dans Profils des clients Amazon Connect
Les rubriques de cette section fournissent la définition de la commande standard et le mappage de type d’objet entre les applications externes et la commande standard.
**Topics**
+ [Conditions d' AppIntegrations accès à Amazon](standard-order-appintegrations-requirements.md)
+ [Conditions d' EventBridge accès à Amazon](standard-order-eventbridge-requirements.md)
+ [Définition d’une commande standard](standard-order-definition.md)
+ [Mappage des objets Shopify](mapping-shopify-objects-standard-order.html.md)
# Conditions d' AppIntegrations accès à Amazon
Respectez les exigences AppIntegrations d'accès Amazon suivantes pour créer et supprimer des intégrations Shopify avec les profils clients Amazon Connect :
+ intégrations d'applications : GetEventIntegration
+ intégrations d'applications : ListEventIntegrationAssociations
+ intégrations d'applications : CreateEventIntegrationAssociation
+ intégrations d'applications : DeleteEventIntegrationAssociation
# Conditions d' EventBridge accès à Amazon
Respectez les exigences EventBridge d'accès Amazon suivantes pour créer et supprimer des intégrations Shopify avec les profils clients Amazon Connect :
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Champs d’objet de commande standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de commande standard Profils des clients.
| Champ de commande standard | Type de données | Description |
| --- | --- | --- |
| OrderId | String | L’identifiant unique d’une commande standard. |
| CustomerEmail | String | L’adresse e-mail du client. |
| CustomerPhone | String | Numéro de téléphone du client. |
| CreatedDate | String | La date de création de la commande. |
| UpdatedDate | String | La date de mise à jour de la commande. |
| ProcessedDate | String | La date de traitement de la commande. |
| ClosedDate | String | La date de clôture de la commande. |
| CancelledDate | String | La date d’annulation de la commande. |
| CancelReason | String | Le motif d’annulation de la commande. |
| Name | String | Le nom de la commande. |
| AdditionalInformation | String | Toute information supplémentaire relative à la commande. |
| Passerelle | String | La passerelle de paiement de la commande. |
| Statut | String | L’état de la commande. |
| StatusCode | String | Le code de statut de la commande. Valeurs valides : DRAFT \$1 ACTIVATED |
| StatusUrl | String | L’URL du statut de la commande. |
| CreditCardNumber | String | Les quatre derniers chiffres de la carte de crédit du client. |
| CreditCardCompany | String | La société émettrice de la carte de crédit du client. |
| FulfillmentStatus | String | L’état d’exécution de la commande. |
| TotalPrice | String | Le prix total de la commande. |
| TotalTax | String | La taxe totale de la commande. |
| TotalDiscounts | String | Les remises totales de la commande. |
| TotalItemsPrice | String | Le prix total des articles de la commande. |
| TotalShippingPrice | String | Le prix d’expédition total de la commande. |
| TotalTipReceived | String | Le montant total du pourboire reçu pour la commande. |
| Currency | String | La devise de la commande. |
| TotalWeight | String | Le poids total de la commande. |
| BillingAddress | OrderAddress | L’adresse de facturation du client. |
| ShippingAddress | OrderAddress | L’adresse de livraison du client. |
| OrderItems | OrderItem liste | Les articles de la commande. |
| Attributes | String-to-string carte | Paire d’attributs clé-valeur d’une commande standard. |
Les objets de commande standard sont indexés par les clés du tableau suivant.
| Nom d’index standard | Champ de commande standard |
| --- | --- |
| \$1orderId | OrderId |
Par exemple, vous pouvez l'utiliser `_orderId` comme nom de clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour rechercher un profil dont l'ordre OrderId correspond à la valeur de recherche. Vous pouvez trouver les objets de commande standard associés à un profil spécifique en utilisant l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) avec le `ProfileId` et `ObjectTypeName` défini sur`_order`.
## OrderAddress type de données
| Champ de commande standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Le nom associé à une adresse de commande. |
| Address1 | String | La première ligne de l’adresse de commande. |
| Address2 | String | La deuxième ligne de l’adresse de commande. |
| Address3 | String | La troisième ligne de l’adresse de commande. |
| Address4 | String | La quatrième ligne de l’adresse de commande. |
| City | String | La ville de l’adresse de commande. |
| County | String | Le comté de l’adresse de commande. |
| State | String | L’état de l’adresse de commande. |
| Province | String | La province de l’adresse de commande. |
| Country | String | Le pays de l’adresse de commande. |
| PostalCode | String | La code postal de l’adresse de commande. |
## OrderItem type de données
| Champ de commande standard | Type de données | Description |
| --- | --- | --- |
| Titre | String | Le titre d’un article de commande. |
| Price | String | Le prix d’un article de commande. |
| Quantity | String | La quantité d’un article de commande. |
# Mappage des objets Shopify vers la commande standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Shopify se mappent aux champs de l’objet de commande standard dans Profils des clients.
## Objet Shopify DraftOrder
Pour une liste de tous les champs d'un DraftOrder objet Shopify, voir [L' DraftOrder objet](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) dans la documentation Shopify.
## Associer un DraftOrder objet Shopify à une commande standard
Un sous-ensemble des champs de l'objet Shopify correspond à DraftOrder l'objet de commande standard dans les profils clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l'DraftOrder objet Shopify et la commande standard.
Le `StatusCode` est `ACTIVATED` si l’`order_status_url` existe dans la source. Sinon, le `StatusCode` est `DRAFT`.
| Shopify- champ DraftOrder source | Champ cible de commande standard |
| --- | --- |
| id | Attributs. ShopifyOrderId |
| customer.id | Attributs. ShopifyCustomerId |
| note | AdditionalInformation |
| e-mail | CustomerEmail |
| currency | Currency |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| name | Name |
| status | Status |
| order\$1status\$1url | StatusCode |
| billing\$1address.address1 | BillingAddress. Adresse 1 |
| billing\$1address.address2 | BillingAddress. Adresse 2 |
| billing\$1address.city | BillingAddress.Ville |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Province |
| billing\$1address.country | BillingAddress.Pays |
| billing\$1address.name | BillingAddress.Nom |
| shipping\$1address.address1 | ShippingAddress. Adresse 1 |
| shipping\$1address.address2 | ShippingAddress. Adresse 2 |
| shipping\$1address.city | ShippingAddress.Ville |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Province |
| shipping\$1address.country | ShippingAddress.Pays |
| shipping\$1address.name | ShippingAddress.Nom |
| invoice\$1url | StatusUrl |
| total\$1price | TotalPrice |
| total\$1tax | TotalTax |
| line\$1items[].title | OrderItems[] .Titre |
| line\$1items[].price | OrderItems[] .Prix |
| line\$1items[].quantity | OrderItems[] .Quantité |
### Exemple
L’exemple suivant montre comment mapper un champ source à un champ cible.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Les données DraftOrder client Shopify issues de l'objet Shopify sont associées à une commande standard Amazon Connect à l'aide de l'index suivant.
| Nom d’index standard | Shopify- champ DraftOrder source |
| --- | --- |
| \$1shopifyOrderId | id |
Par exemple, vous pouvez l'utiliser `_shopifyOrderId` comme un `ObjectFilter.KeyName` avec l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour trouver une commande standard. Vous pouvez trouver les DraftOrder objets Shopify associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Shopify-DraftOrder`
## Objet Shopify-Order
Pour une liste de tous les champs d’un objet Shopify-Order, consultez [The Order object](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object) dans la documentation Shopify.
## Mappage d’un objet Shopify-Order à une commande standard
Un sous-ensemble des champs dans l’objet Shopify-Order se mappe à l’objet de commande standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Shopify-Order et la commande standard.
Le `StatusCode` est `ACTIVATED` si l’`order_status_url` existe dans la source. Sinon, le `StatusCode` est `DRAFT`.
| Champ source Shopify-Order | Champ cible de commande standard |
| --- | --- |
| id | Attributs. ShopifyOrderId |
| customer.id | Attributs. ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| currency | Currency |
| e-mail | CustomerEmail |
| financial\$1status | Status |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| passerelle | Passerelle |
| name | Nom |
| note | AdditionalInformation |
| order\$1status\$1url | StatusUrl |
| phone | CustomerPhone |
| processed\$1at | ProcessedDate |
| total\$1discounts | TotalDiscounts |
| total\$1line\$1items\$1price | TotalItemsPrice |
| total\$1price | TotalPrice |
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice |
| total\$1tax | TotalTax |
| total\$1tip\$1received | TotalTipReceived |
| total\$1weight | TotalWeight |
| updated\$1at | UpdatedDate |
| billing\$1address.address1 | BillingAddress. Adresse 1 |
| billing\$1address.address2 | BillingAddress. Adresse 2 |
| billing\$1address.city | BillingAddress.Ville |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Province |
| billing\$1address.country | BillingAddress.Pays |
| billing\$1address.name | BillingAddress.Nom |
| payment\$1details.credit\$1card\$1number | CreditCardNumber |
| payment\$1details.credit\$1card\$1company | CreditCardCompany |
| shipping\$1address.address1 | ShippingAddress. Adresse 1 |
| shipping\$1address.address2 | ShippingAddress. Adresse 2 |
| shipping\$1address.city | ShippingAddress.Ville |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Province |
| shipping\$1address.country | ShippingAddress.Pays |
| shipping\$1address.name | ShippingAddress.Nom |
| line\$1items[].title | OrderItems[] .Titre |
| line\$1items[].price | OrderItems[] .Prix |
| line\$1items[].quantity | OrderItems[] .Quantité |
### Exemple
L’exemple suivant montre comment mapper un champ source à un champ cible.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Les données client Shopify-Order issues de l’objet Shopify sont associées à une commande standard Amazon Connect à l’aide de l’index suivant.
| Nom d’index standard | Champ source Shopify-Order |
| --- | --- |
| \$1shopifyOrderId | id |
Par exemple, vous pouvez l'utiliser `_shopifyOrderId` comme un `ObjectFilter.KeyName` avec l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour trouver une commande standard. Vous pouvez trouver les objets Shopify-Order associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Shopify-Order`
# Mappage de type d’objet à l’enregistrement de communication standard
Les rubriques de cette section fournissent la définition de l’enregistrement de communication standard et le mappage de type d’objet entre les événements de campagne et l’enregistrement de communication standard.
**Topics**
+ [Profils des clients, champs d’objet d’enregistrement de communication standard](customer-profiles-standard-communication-record-object-fields.md)
+ [Mappage d’objets de campagne à l’enregistrement de communication standard dans Profils des clients Amazon Connect](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)
# Profils des clients, champs d’objet d’enregistrement de communication standard
Le tableau suivant répertorie tous les champs de l’objet d’enregistrement de communication standard Profils des clients.
| Champ communicationRecord standard | Type de données | Description |
| --- | --- | --- |
| CommunicationRecordId | String | Identifiant unique d’un enregistrement de communication standard. |
| Channel | String | Méthode utilisée pour entrer en relation avec le centre de contact. Par exemple : VOIX, CHAT, E-MAIL |
| ConnectInstanceArn | String | L'ARN de l'instance AWS Connect. |
| CreatedDate | String | Horodatage indiquant quand l’enregistrement de communication a été créé. |
| UpdatedDate | String | Horodatage indiquant quand l’enregistrement de communication a été mis à jour pour la dernière fois. |
| LastEventType | String | Type d’événement du dernier événement ingéré pour cette communication. |
| Campaign | Campaign | Détails de la campagne associée à cette communication. |
| Endpoint | Endpoint | Informations sur le point de terminaison utilisé pour cette communication. |
| Événements | Map | Une carte des événements où la clé est le type d’événement, tel que le courrier électronique envoyé, ouvert ou cliqué. Cela permet de suivre le dernier événement de chaque type d’événement unique qui s’est produit au cours de cette communication. |
| Attributes | Map | Paire d’attributs clé-valeur d’un enregistrement de communication standard. |
Les objets d’enregistrement de communication standard sont indexés par les clés du tableau suivant.
| Nom d’index standard | Champ d’enregistrement de communication standard |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
Par exemple, vous pouvez l'utiliser `_communicationRecordId` comme nom de clé avec l'[SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API pour rechercher un profil dont l'enregistrement de communication `CommunicationRecordId` correspond à la valeur de recherche. Vous pouvez trouver les `communicationRecord` objets standard associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur`_communicationRecord`.
## Type de données de campagne
| Champ | Type de données | Description |
| --- | --- | --- |
| CampaignId | String | L’identifiant unique de la campagne sortante. |
| CampaignName | String | Nom de la campagne sortante. |
| CampaignRunId | String | L’identifiant unique pour un cycle spécifique de la campagne. |
| CampaignActivityId | String | ID unique de l’activité au sein de la campagne. |
| SegmentArn | String | ARN d’un segment d’utilisateurs. |
## Type de données de point de terminaison
| Champ | Type de données | Description |
| --- | --- | --- |
| EndpointAddress | String | L’adresse du point de terminaison (par exemple : adresse e-mail, numéro de téléphone). |
| EndpointType | String | Type de point de terminaison, par exemple e-mail par défaut ou e-mail professionnel. |
## Type de données d’événement
| Champ | Type de données | Description |
| --- | --- | --- |
| UpdatedDate | String | Horodatage indiquant le moment où l’événement de communication s’est produit. |
| EventId | String | Identifiant unique de chaque événement de communication. |
| EventType | String | Type d’événement de communication spécifique. |
| Attributes | Map | Paire d’attributs clé-valeur spécifique au type d’événement. |
# Mappage d’objets de campagne à l’enregistrement de communication standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets de campagne se mappent aux champs de l’objet d’enregistrement de communication standard dans Profils des clients.
## Objet Campagne-e-mail
Pour obtenir la liste de tous les champs d’un objet Campagne-e-mail, consultez l’[objet e-mail](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html) dans la documentation Amazon SES.
**Mappage d’un objet Campagne-e-mail à un enregistrement de communication standard**
Un sous-ensemble des champs de l’objet Campagne-Email correspond à l’objet d’enregistrement de communication standard dans Profils des clients.
Le tableau suivant répertorie les champs pouvant être mappés à partir de l’objet Campagne-Email vers l’enregistrement de communication standard.
| Champ source Campagne-Email | Champ cible d’enregistrement de communication standard |
| --- | --- |
| campaign\$1event\$1id | Attributs. LastCampaignEventId |
| outbound\$1request\$1id | Attributs. OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributs. CampaignMessageId |
| channel.name | Channel |
| channel.subtype | Attributs. ChannelSubType |
| endpoint\$1address | Point final. EndpointAddress |
| endpoint\$1type | Point final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campagne. CampaignName |
| campaign\$1id | Campagne. CampaignId |
| campaign\$1run\$1id | Campagne. CampaignRunId |
| campaign\$1activity\$1id | Campagne. CampaignActivityId |
| segment\$1arn | Campagne. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| email.bounce.bounceType | Evénements.Bounce.Attributs. BounceType |
| email.bounce. bounceSubType | Evénements.Bounce.Attributs. BounceSubType |
| email.click.link | Events.Click.Attributes.Link |
| email.click.ipAddress | Événements. Cliquez sur Attributs. IpAddress |
| email.open.ipAddress | Evénements.Open.Attributs. IpAddress |
| email.reject.reason | Events.Reject.Attributes.Reason |
| email.renderingFailure.templateName | Évènements. RenderingFailure.Attributs. TemplateName |
| email.renderingFailure.errorMessage | Évènements. RenderingFailure.Attributs. ErrorMessage |
| email.deliveryDelay.delayType | Évènements. DeliveryDelay.Attributs. DelayType |
| courriel.plainte. complaintFeedbackType | Événements. Plainte. Attributs. ComplaintFeedbackType |
| courriel.plainte. complaintSubType | Événements. Plainte. Attributs. ComplaintSubType |
| email.mail.commonHeaders.subject | Attributes.Subject |
## Objet Campagne-SMS
Pour obtenir la liste de tous les champs d’un objet Campagne-SMS, consultez la section [Objet SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) dans la documentation relative à la messagerie SMS pour utilisateurs finaux AWS .
**Mappage d’un objet Campagne-SMS à un enregistrement de communication standard**
Un sous-ensemble des champs de l’objet Campagne-SMS correspond à l’objet d’enregistrement de communication standard dans Profils des clients.
Le tableau suivant répertorie les champs pouvant être mappés à partir de l’objet Campagne-SMS vers l’enregistrement de communication standard.
| Champ source Campagne-SMS | Champ cible d’enregistrement de communication standard |
| --- | --- |
| campaign\$1event\$1id | Attributs. LastCampaignEventId |
| outbound\$1request\$1id | Attributs. OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributs. CampaignMessageId |
| channel.name | Channel |
| channel.subtype | Attributs. ChannelSubType |
| endpoint\$1address | Point final. EndpointAddress |
| endpoint\$1type | Point final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campagne. CampaignName |
| campaign.campaign\$1id | Campagne. CampaignId |
| campaign.campaign\$1run\$1id | Campagne. CampaignRunId |
| campaign\$1activity\$1id | Campagne. CampaignActivityId |
| segment\$1arn | Campagne. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| sms.messageType | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. MessageType |
| sms.messageStatus | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. MessageStatus |
| sms. messageStatusDescription | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. MessageStatusDescription |
| sms. totalMessagePrice | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. TotalMessagePrice |
| sms. totalCarrierFee | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. TotalCarrierFee |
| sms. isoCountryCode | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. IsoCountryCode |
## Objet de Campagne-téléphonie
Pour obtenir la liste de tous les champs d'un objet Campaign-Telephony, consultez l'[objet Voice](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) dans la documentation de messagerie SMS destinée aux utilisateurs AWS finaux.
**Mappage d’un objet Campaign-téléphonie à un enregistrement de communication standard**
Un sous-ensemble des champs de l’objet Campagne-téléphonie correspond à l’objet d’enregistrement de communication standard dans Profils des clients.
Le tableau suivant répertorie les champs pouvant être mappés à partir de l’objet Campagne-téléphonie vers l’enregistrement de communication standard.
| Champ source Campagne-téléphonie | Champ cible d’enregistrement de communication standard |
| --- | --- |
| campaign\$1event\$1id | Attributs. LastCampaignEventId |
| outbound\$1request\$1id | Attributs. OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributs. CampaignMessageId |
| channel.name | Channel |
| channel.subtype | Attributs. ChannelSubType |
| endpoint.endpoint\$1address | Point final. EndpointAddress |
| endpoint.endpoint\$1type | Point final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campagne. CampaignName |
| campaign.campaign\$1id | Campagne. CampaignId |
| campaign.campaign\$1run\$1id | Campagne. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campagne. CampaignActivityId |
| campaign.segment\$1arn | Campagne. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| Informations sur l'agent Voice.Agent. connectedToAgentHorodatage | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. ConnectedToAgentTimestamp |
| voix. customerVoiceActivity. greetingEndTimestamp | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. GreetingEndTimestamp |
| voix. answeringMachineDetectionÉtat | Évènements. \$1\$1campaign\$1event\$1type\$1\$1 .Attributs. AnsweringMachineDetectionStatus |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Objet Campagne-orchestration
**Mappage d’un objet Campagne-orchestration à un enregistrement de communication standard**
Un sous-ensemble des champs de l’objet Campagne-orchestration correspond à l’objet d’enregistrement de communication standard dans Profils des clients.
Le tableau suivant répertorie les champs pouvant être mappés à partir de l’objet Campagne-orchestration vers l’enregistrement de communication standard.
| Champ source Campaign-orchestration | Champ cible d’enregistrement de communication standard |
| --- | --- |
| campaign\$1event\$1id | Attributs. LastCampaignEventId |
| channel.name | Channel |
| channel.subtype | Attributs. ChannelSubType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campagne. CampaignName |
| campaign.campaign\$1id | Campagne. CampaignId |
| campaign.campaign\$1run\$1id | Campagne. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campagne. CampaignActivityId |
| campaign.segment\$1arn | Campagne. SegmentArn |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Évènements. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Exemple
L’exemple suivant montre comment mapper un champ source à un champ cible :
```
"channel": {
"source": "_source.engagement.channel.name",
"target": "_communicationRecord.Channel"
}
```
# Mappage des types d’objets pour la ressource standard dans Profils des clients
Les rubriques de cette section fournissent la définition de la ressource standard et le mappage de type d’objet entre les applications externes et la ressource standard.
**Topics**
+ [Conditions d' AppFlow accès à Amazon](appflow-access-requirements-asset.md)
+ [Définition d’une ressource standard](standard-asset-definition.md)
+ [Mappage des objets Salesforce à une ressource standard](mapping-salesforce-objects-to-asset.md)
# Conditions AppFlow d'accès à Amazon dans les profils clients
Respectez les exigences AppFlow d'accès Amazon suivantes pour créer et supprimer des intégrations Salesforce avec les profils clients Amazon Connect :
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Définition d’une ressource standard dans Profils des clients Amazon Connect
Le tableau suivant répertorie tous les champs de l’objet de ressource standard Profils des clients.
| Champ de ressource standard | Type de données | Description |
| --- | --- | --- |
| AssetId | String | L’identifiant unique d’une ressource standard. |
| AssetName | String | Nom de la ressource. |
| SerialNumber | String | Numéro de série de la ressource. |
| ModelNumber | String | Numéro de modèle de la ressource. |
| ModelName | String | Nom du modèle de la ressource. |
| ProductSKU | String | Référence unique (SKU) de la ressource. |
| PurchaseDate | String | Date d’achat de la ressource. |
| UsageEndDate | String | Date de fin d’utilisation de la ressource. |
| Statut | String | Statut de la ressource. |
| Price | String | Prix de la ressource. |
| Quantity | String | Quantité de la ressource. |
| Description | String | Description de la ressource. |
| AdditionalInformation | String | Toute information supplémentaire relative à la ressource. |
| DataSource | String | Source de données d’une ressource. |
| Attributes | String-to-string carte | Paire d’attributs clé-valeur d’une ressource standard. |
Les objets de ressource standard sont indexés par les clés du tableau suivant.
| Nom d’index standard | Champ de ressource standard |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
Par exemple, vous pouvez l'utiliser `_assetName` comme nom de clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour rechercher un profil dont la ressource AssetName correspond à la valeur de recherche. Vous pouvez trouver les objets d'actifs standard associés à un profil spécifique en utilisant l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) avec le `ProfileId` et `ObjectTypeName` défini sur`_asset`.
# Mappage des objets Salesforce à une ressource standard dans les Profils de clients
Cette rubrique répertorie quels champs des objets Salesforce se mappent aux champs de l’objet de ressource standard dans Profils des clients.
## Objet Salesforce-Asset
Voici une liste de tous les champs dans un objet Salesforce-Asset.
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Nom
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Statut
+ Price
+ Quantity
+ Description
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## Mappage d’un objet Salesforce-Asset à une ressource standard
Un sous-ensemble des champs dans l’objet Salesforce-Asset se mappe à l’objet de ressource standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Salesforce-Asset et la ressource standard.
| Champ source Saleforce-Asset | Champ cible de ressource standard |
| --- | --- |
| Id | Attributs. sfdcAssetId |
| ContactId | Attributs. sfdcContactId |
| AccountId | Attributs. sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| Statut | Statut |
| Price | Price |
| Quantity | Quantity |
| Description | Description |
Les données client Salesforce-Asset issues de l’objet Salesforce sont associées à une ressource standard Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Saleforce-Asset |
| --- | --- |
| \$1salesforceAssetId | Id |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
Par exemple, vous pouvez utiliser `_salesforceAssetId` et `_salesforceAccountId` en tant que `ObjectFilter.KeyName` composant de l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour rechercher un actif standard. Vous pouvez trouver les objets Salesforce-Asset associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et `ObjectTypeName` défini sur. `Salesforce-Asset`
# Mappage de type d’objet au cas standard dans les Profils de clients
Les rubriques de cette section fournissent la définition du cas standard et le mappage de type d’objet entre les applications externes et le cas standard.
**Topics**
+ [Conditions d' AppFlow accès à Amazon](appflow-access-requirements-case.md)
+ [Définition d’un cas standard](standard-case-definition.md)
+ [Mappage des objets Zendesk](mapping-zendesk-objects-case.md)
+ [ServiceNow Objets de mappage](mapping-servicenow-objects-standard-case.md)
# Conditions AppFlow d'accès à Amazon dans les profils clients
Respectez les exigences AppFlow d'accès Amazon suivantes pour créer et supprimer Zendesk et ServiceNow les intégrations avec les profils clients Amazon Connect :
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Champs de l’objet de cas standard Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de cas standard Profils des clients.
| Champ de cas standard | Type de données | Description |
| --- | --- | --- |
| CaseId | String | L’identifiant unique d’un cas standard. |
| Titre | String | Le titre du cas |
| Résumé | String | Le résumé du cas. |
| Statut | String | Le statut du cas. |
| Raison | String | La raison du cas. |
| CreatedBy | String | Le créateur du cas. |
| CreatedDate | String | La date de création du cas. |
| UpdatedDate | String | La date de mise à jour du cas. |
| ClosedDate | String | La date de clôture du cas. |
| AdditionalInformation | String | Toute information supplémentaire relative au cas. |
| DataSource | String | La source de données du cas. |
| Attributes | String-to-string carte | Paire d’attributs clé-valeur d’un cas standard. |
Les objets de cas standard sont indexés par les clés du tableau suivant.
| Nom d’index standard | Champ de cas standard |
| --- | --- |
| \$1caseId | CaseId |
Par exemple, vous pouvez l'utiliser `_caseId` comme nom de clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour rechercher un profil dont le cas CaseId correspond à la valeur de recherche. Vous pouvez trouver les objets de dossier standard associés à un profil spécifique en utilisant l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) avec le `ProfileId` et `ObjectTypeName` défini sur`_case`.
# Mappage des objets Zendesk au cas standard dans Profils des clients Amazon Connect
Cette rubrique répertorie quels champs des objets Zendesk se mappent aux champs dans le cas standard dans Profils des clients.
## Objet Zendesk-tickets
Voici une liste de tous les champs d’un objet Zendesk-tickets.
+ id
+ url
+ type
+ subject
+ raw\$1subject
+ description
+ priority
+ status
+ destinataire
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organization\$1id
+ group\$1id
+ collaborator\$1ids
+ email\$1cc\$1ids
+ follower\$1ids
+ forum\$1topic\$1id
+ problem\$1id
+ has\$1incidents
+ due\$1at
+ tags
+ via.channel
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1ids
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachments
+ is\$1public
+ created\$1at
+ updated\$1at
## Mappage d’un objet Zendesk-tickets à un cas standard
Un sous-ensemble des champs dans l’objet Zendesk-tickets se mappe au cas standard dans Profils des clients. Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Zendesk-tickets et le cas standard.
| Champ source Zendesk-tickets | Champ cible du cas standard |
| --- | --- |
| requester\$1id | Attributs. ZendeskUserId |
| id | Attributs. ZendeskTicketId |
| subject | Titre |
| description | Résumé |
| status | Statut |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
Les données client Zendesk-tickets issues de l’objet Zendesk sont associées à un cas standard Amazon Connect à l’aide des index suivants.
| Nom d’index standard | Champ source Zendesk-tickets |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
Par exemple, vous pouvez utiliser `_zendeskUserId` et `_zendeskTicketId` `ObjectFilter.KeyName` avec l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour trouver un cas standard. Vous pouvez trouver les objets Zendesk tickets associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et défini sur. `ObjectTypeName` `Zendesk-tickets`
# Mappage ServiceNow des objets selon le cas standard dans les profils clients Amazon Connect
Cette rubrique répertorie les champs des ServiceNow objets qui correspondent aux champs du cas standard des profils clients Amazon Connect.
## Objet Servicenow-task
Voici une liste de tous les champs d’un objet Servicenow-task.
+ sys\$1id
+ actif
+ activity\$1due
+ additional\$1assignee\$1list
+ approval
+ approval\$1history
+ approval\$1set
+ assigned\$1to
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ calendar\$1duration
+ closed\$1at
+ closed\$1by
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ comments
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contrat
+ correlation\$1display
+ actif
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ description
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impact
+ knowledge
+ location
+ made\$1sla
+ number
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ state
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ actif
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1worked
+ upon\$1approval
+ upon\$1reject
+ urgency
+ user\$1input
+ watch\$1list
+ work\$1end
+ work\$1notes
+ work\$1notes\$1list
+ work\$1start
## Mappage de Servicenow-task à un cas standard
Un sous-ensemble des champs dans l’objet Servicenow-task se mappe au cas standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Servicenow-task et le cas standard.
| Champ source Servicenow-task | Champ cible du cas standard |
| --- | --- |
| sys\$1id | Attributs. ServiceNowTaskId |
| opened\$1by.link | Attributs. ServiceNowSystemUserId |
| short\$1description | Titre |
| description | Résumé |
| status | Statut |
| sys\$1created\$1by | CreatedBy |
| sys\$1created\$1on | CreatedDate |
| sys\$1updated\$1on | UpdatedDate |
Les données client Servicenow-task issues de Servicenow sont associées à un cas standard Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Servicenow-task |
| --- | --- |
| \$1 serviceNowTask Identifiant | sys\$1id |
| \$1 serviceNowSystem Identifiant | open\$1by.link |
Par exemple, vous pouvez utiliser `_serviceNowTaskId` et `_serviceNowSystemId` `ObjectFilter.KeyName` avec l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour trouver un cas standard. Vous pouvez trouver les objets ServiceNow-Task associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et défini sur. `ObjectTypeName` `Servicenow-task`
## Objet Servicenow-incident
Voici une liste de tous les champs d’un objet Servicenow-incident.
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ category
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severity
+ subcategory
## Mappage de Servicenow-incident à un cas standard
Un sous-ensemble des champs dans l’objet Servicenow-incident se mappe au cas standard dans Profils des clients.
Le tableau suivant répertorie les champs qui peuvent être mappés entre l’objet Servicenow-incident et le cas standard.
| Champ source Servicenow-incident | Champ cible du cas standard |
| --- | --- |
| sys\$1id | Attributs\$1 ServiceNowIncidentId |
| caller\$1id.link | Attributs\$1 ServiceNowSystemUserId |
| incident\$1status | Statut |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| category | Raison |
Les données client Servicenow-incident issues de l’objet Servicenow sont associées à un cas standard Amazon Connect à l’aide des index du tableau suivant.
| Nom d’index standard | Champ source Servicenow |
| --- | --- |
| \$1 serviceNowIncident Identifiant | sys\$1id |
| \$1 serviceNowSystem Identifiant | caller\$1id.link |
Par exemple, vous pouvez utiliser `_serviceNowIncidentId` et `_serviceNowSystemId` en tant que ObjectFilter. KeyName avec l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API pour trouver un cas standard. Vous pouvez trouver les objets d'incident ServiceNow associés à un profil spécifique en utilisant l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API avec le `ProfileId` et défini sur. `ObjectTypeName` `Servicenow-incident`
# Mappage de type d’objet à la préférence aérienne standard
Les rubriques de cette section fournissent la définition des préférences aériennes standard.
**Topics**
+ [Champs d’objet de préférence aérienne standard de Profils des clients](standard-air-preference-object-fields.md)
# Champs d’objet de préférence aérienne standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de préférence aérienne standard Profils des clients.
**Préférence aérienne**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| PreferenceId | String | L’identifiant unique d’une préférence aérienne standard |
| Name | String | Le nom de la préférence |
| CreatedDate | String | Date de création de la préférence |
| CreatedBy | String | L’identifiant du créateur |
| UpdatedDate | String | La date de la dernière mise à jour. |
| UpdatedBy | String | L’identifiant de la personne qui a effectué la dernière mise à jour |
| StartDate | String | La date de début préférée |
| EndDate | String | La date de fin préférée |
| Statut | String | Le statut actuel de la préférence. |
| ReferenceId | String | L’identifiant de l’objet référencé |
| ReferenceType | String | Le type d’objet référencé |
| TravelType | String | Le type de voyage (par exemple : vols directs) |
| Transférer | String | Le type de transfert préféré |
| ArrivalAirport | String | L’aéroport d’arrivée préféré |
| ArrivalTerminal | String | Le terminal d’aéroport d’arrivée préféré |
| DepartureAirport | String | L’aéroport de départ préféré |
| DepartureTerminal | String | Le terminal d’aéroport de départ préféré |
| HomeAirport | String | L’aéroport de résidence |
| CheckInChannel | String | Le mode d’enregistrement |
| CheckInChannelDevice | String | L’appareil utilisé pour l’enregistrement |
| Language | Language | Détails sur les langues préférées pour la communication |
| Seat | Seat | Détails sur le choix des sièges |
| Journey | Journey | Préférences de voyage |
| Accessibility | Accessibility | Détails sur les demandes d’accessibilité |
| Insurance | Insurance | Informations relatives aux assurances |
| Interest | Interest | Détails sur les intérêts |
| Loyalty | Loyalty | Informations relatives à la fidélité |
| Dining | Dining | Préférences en matière de restauration |
| MediaEntertainment | MediaEntertainment | Préférences en matière de médias et de divertissement |
| PaymentForm | PaymentForm | Préférences de mode de paiement |
| PetInfo | PetInfo | Détails sur les animaux |
| SpecialRequest | SpecialRequest | Détails sur les demandes spéciales |
| TicketDistribution | TicketDistribution | Préférences de distribution de tickets |
| Marketing | Marketing | Préférences de marketing |
| Medical | Medical | Préférences médicales |
| Baggage | Baggage | Préférences en matière de bagages |
| ContactDetail | ContactDetail | Informations sur le contact préféré |
| ContactDetailAddress | ContactDetailAddress | Adresse pour les coordonnées |
| ContactDetailCommunication | ContactDetailCommunication | Préférences de communication |
| Attributes | Map | Paire d’attributs clé-valeur d’une préférence aérienne |
Les objets de préférence aérienne standard sont indexés par les clés du tableau suivant.
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
Par exemple, vous pouvez l'utiliser `_airPreferenceId` comme nom clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour rechercher un profil dont la préférence aérienne PreferenceId correspond à la valeur de recherche. Vous pouvez trouver les objets AirPreference standard associés à un profil spécifique en utilisant l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) avec le `ProfileId` et `ObjectTypeName` défini sur. `_airPreference`
**ContactDetail type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Le type de contact (par exemple : personnel, urgence) |
| PreferenceLevel | String | Niveau de priorité de ce contact |
| PhoneNumber | String | Numéro de téléphone |
| Relation | String | La relation avec le profil |
| EmailAddress | String | Adresse e-mail |
| EmailLanguage | String | Langue préférée pour la communication par e-mail concernant les coordonnées |
| PhoneLanguage | String | Langue préférée pour la communication par téléphone concernant les coordonnées |
**ContactDetailAddress type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Le type d’adresse du contact |
| Address1 | String | La première ligne de l’adresse d’un contact. |
| Address2 | String | La deuxième ligne de l’adresse d’un contact. |
| Address3 | String | La troisième ligne de l’adresse d’un contact. |
| Address4 | String | La quatrième ligne de l’adresse d’un contact. |
| City | String | La ville de l’adresse d’un contact. |
| Country | String | Le pays de l’adresse d’un contact. |
| County | String | Le comté de l’adresse d’un contact. |
| PostalCode | String | Le code postal de l’adresse d’un contact. |
| Province | String | La province de l’adresse d’un contact. |
| State | String | L’état de l’adresse d’un contact. |
**ContactDetailCommunication type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Method | String | Méthode de communication (par exemple : SMS, e-mail) |
| PreferenceLevel | String | Niveau de préférence pour la méthode de communication |
**Type de données de langue**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| PhoneLanguage | String | Langue préférée pour les communications téléphoniques |
| EmailLanguage | String | Langue préférée pour les communications par e-mail |
| InPersonLanguage | String | Langue préférée pour la communication en personne |
| PreferenceLevel | String | Niveau de préférence de langue |
**Type de données de siège**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| PreferenceLevel | String | Priorité des préférences de siège |
| Direction | String | La direction préférée du siège (par exemple : avant, arrière) |
| Location | String | L’emplacement de siège préféré (par exemple : fenêtre, allée) |
| Position | String | La position du siège (par exemple : gauche, droite) |
| Row | String | La rangée de sièges souhaitée |
| ClassOfService | String | La classe de voyage (par exemple : Economy, Business) |
| NeighborFree | String | Préférence pour un siège sans voisins |
| Infant | String | Préférence pour un siège enfant |
| ExtraSeat | String | Préférence pour un siège supplémentaire |
**Type de données de trajet**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| MaxConnections | String | Le nombre maximum de connexions autorisées |
| PreferredAirline | String | Compagnie aérienne préférée |
| UpgradeAuction | String | Accepter les enchères de mise à niveau |
| FlightTime | String | Heure de vol préférée |
| FlightMaxDuration | String | Durée de voyage maximale préférée |
**Type de données d’accessibilité**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Wheelchair | String | Informations sur l’accessibilité en fauteuil roulant |
| Bathroom | String | Informations sur l’accessibilité des toilettes |
| Assistance | String | Informations sur l’assistance |
| DisabilityType | String | Informations sur le handicap |
| SupportAnimal | String | Informations sur les animaux d’assistance |
| ProximityToFacilities | String | Besoin de proximité avec les commodités |
**Types de données sur l’assurance**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Nom du fournisseur d’assurance ou du plan |
| PreferenceLevel | String | Degré de préférence pour l’assurance |
**Type de données d’intérêt**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Domaine d’intérêt spécifique |
| PreferenceLevel | String | Priorité de cet intérêt |
**Type de données de fidélité**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Nom du programme de fidélité |
| MembershipId | String | Identifiant de membre dans le programme de fidélité |
| PreferenceLevel | String | Niveau de préférence du programme de fidélité |
**Type de données de restauration**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| MealType | String | Type de repas préféré |
| FavoriteCuisine | String | Types de cuisine préférés |
| Beverage | String | Boissons préférées |
| DietaryRestriction | String | Restrictions alimentaires |
| AllergyInfo | String | Informations relatives aux allergies |
| PreferenceLevel | String | Niveau de préférence en matière de restauration |
**Type de données relatives aux médias et au divertissement**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Nom du divertissement préféré |
| PreferenceLevel | String | Niveau de préférence pour les médias et le divertissement |
**PaymentForm type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Name | String | Nom du moyen de paiement |
| Type | String | Type de paiement (par exemple, carte de crédit PayPal) |
| PreferenceLevel | String | Niveau de préférence du mode de paiement |
| UsageContext | String | Lieu où le mode de paiement est utilisé |
**PetInfo type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Type d’animal |
| PreferenceLevel | String | Niveau de préférence concernant les animaux de compagnie |
**SpecialRequest type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Type de demande spéciale |
| Name | String | Nom ou description de la demande |
| PreferenceLevel | String | Niveau de priorité de la demande |
**TicketDistribution type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| PreferenceLevel | String | Niveau de préférence pour la distribution des tickets |
| Method | String | Mode de livraison des billets (par exemple : e-mail, physique) |
| TicketTime | String | Heure préférée pour la livraison des tickets |
**Type de données marketing**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| ChannelType | String | Type de canal marketing (par exemple : SMS, e-mail) |
| OptIn | String | Statut d’inscription pour le marketing |
| Frequency (Fréquence) | String | Fréquence des communications marketing |
| StartDate | String | Date de début de la préférence marketing |
| EndDate | String | Date de fin de la préférence marketing |
**Type de données médicales**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Oxygen | String | (Fourni par la compagnie aérienne, propriété des passagers, concentrateur, etc.) |
| MedicalEquipment | String | Détails sur l’équipement médical (par exemple : appareil CPAP, concentrateur d’oxygène). |
| Assistance | String | Spécifie si le voyageur a besoin d’une assistance médicale générale pendant le voyage (par exemple : assistance en vol, aide pour prendre des médicaments). |
| Stretcher | String | Si le voyageur a besoin d’une civière pendant le vol, elle est généralement utilisée pour les valises de transport médical. |
| WheelChair | String | Informations sur le fauteuil roulant (non renversable, cellule humide, immobile, assistance pour les escaliers RampNeeded, compagnie aérienne fournie, etc.) |
**Type de données de bagages**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Animal | String | Indique si le voyageur voyage avec un animal d’assistance ou un animal de compagnie, et inclut les spécifications ou restrictions pertinentes. (inHold, Cabin) |
| BaggageType | String | Spécifie le type de manipulation des bagages préféré (par exemple : bagages de cabine uniquement, bagages enregistrés, bagages surdimensionnés). |
| Assistance | String | Indique si le voyageur a besoin d’aide pour transporter ou gérer ses bagages, par exemple des services de portier à l’aéroport ou une assistance pour les bagages sur le trottoir. |
| PreferenceLevel | String | Niveau de préférence pour les champs relatifs aux bagages |
# Mappage de type d’objet à la préférence d’hôtel standard
Les rubriques de cette section fournissent la définition des préférences d’hôtel standard.
**Topics**
+ [Champs d’objet de préférence d’hôtel standard de Profils des clients](standard-hotel-preference-object-fields.md)
# Champs d’objet de préférence d’hôtel standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de préférence d’hôtel standard Profils des clients.
**Préférences d’hôtel**
| Champ hotelPreference standard | Type de données | Description |
| --- | --- | --- |
| PreferenceId | String | Identifiant unique d’une préférence d’hôtel standard |
| Name | String | Le nom de la préférence |
| CreatedDate | String | Date de création de la préférence |
| CreatedBy | String | L’identifiant du créateur |
| UpdatedDate | String | La date de la dernière mise à jour. |
| UpdatedBy | String | L’identifiant de la personne qui a effectué la dernière mise à jour |
| StartDate | String | La date de début préférée |
| EndDate | String | La date de fin préférée |
| Statut | String | Le statut actuel de la préférence. |
| Smoking | String | Préférences en matière de tabac |
| CleaningTime | String | Heure du nettoyage |
| CheckInType | String | Type d’enregistrement |
| CheckOutType | String | Type de check-out |
| ReferenceId | String | L’identifiant de l’objet référencé |
| ReferenceType | String | Le type d’objet référencé |
| Location | Location | Préférences concernant l’emplacement des chambres d’hôtel |
| Bedding | Bedding | Préférences en matière de couchage |
| Tour | Tour | Préférences de visite |
| ContactDetail | ContactDetail | Informations sur le contact préféré |
| ContactDetailAddress | ContactDetailAddress | Adresse pour les coordonnées |
| ContactDetailCommunication | ContactDetailCommunication | Préférences de communication |
| Language | Language | Préférences de langue |
| CarRental | CarRental | Préférences de location de voiture |
| Accessibility | Accessibility | Préférences d’accessibilité |
| Interest | Interest | Détails des intérêts |
| Loyalty | Loyalty | Préférences de fidélité |
| Dining | Dining | Préférences en matière de restauration |
| MediaEntertainment | MediaEntertainment | Préférences en matière de médias et de divertissement |
| PaymentForm | PaymentForm | Préférences en matière de mode de paiement |
| PetInfo | PetInfo | Préférences d’informations sur les animaux |
| SpecialRequest | SpecialRequest | Détails sur les demandes spéciales |
| Marketing | Marketing | Préférences de marketing |
| Medical | Medical | Préférences médicales |
| Baggage | Baggage | Préférences de bagages |
| Attributes | Map | Paire d’attributs clé-valeur d’une préférence d’hôtel |
Les objets de préférence d’hôtel standard sont indexés par les clés du tableau suivant.
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
Par exemple, vous pouvez l'utiliser `_hotelPreferenceId` comme nom clé avec l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) pour rechercher un profil dont la préférence d'hôtel PreferenceId correspond à la valeur de recherche. Vous pouvez trouver les objets HotelPreference standard associés à un profil spécifique en utilisant l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) avec le `ProfileId` et `ObjectTypeName` défini sur. `_hotelPreference`
**ContactDetail type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Le type de contact (par exemple : personnel, urgence) |
| PreferenceLevel | String | Niveau de priorité de ce contact |
| PhoneNumber | String | Numéro de téléphone |
| Relation | String | La relation avec le profil |
| EmailAddress | String | Adresse e-mail |
| EmailLanguage | String | Langue préférée pour la communication par e-mail concernant les coordonnées |
| PhoneLanguage | String | Langue préférée pour la communication par téléphone concernant les coordonnées |
**ContactDetailAddress type de données**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Type | String | Le type d’adresse du contact |
| Address1 | String | La première ligne de l’adresse d’un contact. |
| Address2 | String | La deuxième ligne de l’adresse d’un contact. |
| Address3 | String | La troisième ligne de l’adresse d’un contact. |
| Address4 | String | La quatrième ligne de l’adresse d’un contact. |
| City | String | La ville de l’adresse d’un contact. |
| Country | String | Le pays de l’adresse d’un contact. |
| County | String | Le comté de l’adresse d’un contact. |
| PostalCode | String | Le code postal de l’adresse d’un contact. |
| Province | String | La province de l’adresse d’un contact. |
| State | String | L’état de l’adresse d’un contact. |
**ContactDetailCommunication type de données**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Method | String | Méthode de communication |
| PreferenceLevel | String | Niveau de préférence pour la méthode de communication |
| Frequency (Fréquence) | String | Fréquence de communication |
**Type de données de langue**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| PhoneLanguage | String | Langue préférée au téléphone |
| EmailLanguage | String | Langue préférée pour les e-mails |
**CarRental type de données**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Vendor | String | Fournisseur de location de voitures préféré |
| VehicleType | String | Type de véhicule préféré |
| PreferenceLevel | String | Niveau de préférence pour la location de voiture |
**Type de données d’emplacement**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| PreferredFloor | String | Préférence en termes d’étage pour la chambre |
| ElevatorProximity | String | Préférence en termes de proximité des ascenseurs |
| QuietZone | String | Préférence pour les zones calmes |
| LobbyProximity | String | Préférence en termes de proximité avec le lobby |
| Afficher | String | Vue souhaitée depuis la chambre |
| RoomType | String | Type de chambre préféré |
| PreferenceLevel | String | Niveau de préférence en matière d’emplacement |
**Type de données de couchage**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| BedType | String | Type de lit préféré |
| MattressType | String | Type de matelas préféré |
| PillowType | String | Type d’oreiller préféré |
| NumberOfPillows | String | Préférence en termes de nombre d’oreillers |
| BeddingMaterial | String | Matériau du couchage |
| Allergy | String | Préférences en matière de couchage liées aux allergies |
**Type de données de visite**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| City | String | Villes préférées pour les visites |
| Cultural | String | Intérêts liés aux visites culturelles |
| Adventure | String | Intérêts des voyages d’aventure |
| Nightlife | String | Intérêts pour les visites nocturnes |
| GuideLanguage | String | Langue préférée du guide touristique |
| StartTime | String | Heure de départ préférée pour les visites |
| GroupSize | String | Taille de groupe préférée pour les visites |
| PreferenceLevel | String | Importance des préférences de visite |
**Types de données d’accessibilité**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Wheelchair | String | Informations sur l’accessibilité en fauteuil roulant |
| Bathroom | String | Informations sur l’accessibilité des toilettes |
| Assistance | String | Informations sur l’assistance |
| DisabilityType | String | Informations sur le handicap |
| SupportAnimal | String | Informations sur les animaux d’assistance |
| ProximityToFacilities | String | Besoin de proximité avec les commodités |
**Type de données d’intérêt**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| NameOfInterest | String | Nom de l’intérêt |
| PreferenceLevel | String | Niveau de préférence pour l’intérêt |
**Type de données de fidélité**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| LoyaltyName | String | Nom du programme de fidélité |
| MembershipId | String | ID de membre de fidélité |
| PreferenceLevel | String | Niveau de préférence de fidélité |
| PriorityServices | String | Préférences en termes de services prioritaires |
**Type de données de restauration**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| MealType | String | Types de repas préférés |
| FavoriteCuisine | String | Préférences de cuisine préférées |
| Beverage | String | Préférences de boisson |
| DietaryRestriction | String | Restrictions alimentaires |
| AllergyInfo | String | Informations sur les allergies |
| PreferenceLevel | String | Niveau de préférence en matière de restauration |
**MediaEntertainment type de données**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Name | String | Nom du média ou divertissement préféré |
| PreferenceLevel | String | Niveau de préférence pour les médias ou le divertissement |
**PaymentForm type de données**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Name | String | Nom associé au mode de paiement |
| Type | String | Type de moyen de paiement |
| PreferenceLevel | String | Niveau de préférence du mode de paiement |
| UsageContext | String | Contexte dans lequel le formulaire de paiement est utilisé |
**PetInfo type de données**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Type | String | Type d’animal |
| PreferenceLevel | String | niveau de préférence pour animal de compagnie |
**Type de données de demande spéciale**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Type | String | Type de demande spéciale |
| Name | String | Nom de la demande spéciale |
| PreferenceLevel | String | Niveau de préférence de la demande |
**Type de données marketing**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| ChannelType | String | Type de canal marketing (par exemple : SMS, e-mail) |
| OptIn | String | Statut d’inscription pour le marketing |
| Frequency (Fréquence) | String | Fréquence des communications marketing |
| StartDate | String | Date de début de la préférence marketing |
| EndDate | String | Date de fin de la préférence marketing |
**Type de données médicales**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Oxygen | String | Préférences d’approvisionnement en oxygène |
| MedicalEquipment | String | Détails sur le matériel médical |
| Assistance | String | Type d’assistance médicale requise |
| Stretcher | String | Exigences des invités en matière de civière |
| WheelChair | String | Type de fauteuil roulant et assistance requise |
**Type de données de bagages**
| Champ hotelPreference standard | Type | Description |
| --- | --- | --- |
| Bicycle | String | Besoins en bagages à vélo |
| BaggageType | String | Informations sur les bagages (par exemple : encombrants) |
| Courier | String | Préférence en matière de bagages pour les services de messagerie |
| Fragile | String | Préférences d’articles fragiles |
| Niveau de préférence | String | Niveau de préférence de bagages |
# Mappage de type d’objet à la réservation aérienne standard
Les rubriques de cette section fournissent la définition des réservations aériennes standard.
**Topics**
+ [Champs d’objet de réservation aérienne standard de Profils des clients](standard-air-booking-object-fields.md)
# Champs d’objet de réservation aérienne standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de réservation aérienne standard Profils des clients.
**AirBooking**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| BookingId | String | L’identifiant unique de la réservation aérienne standard |
| ContextId | String | L’identifiant spécifique au contexte pour le suivi de la source de réservation |
| PreferenceRef | String | L’identifiant faisant référence à l’objet de préférence pour la réservation |
| BookingName | String | Le nom associé à la réservation |
| PassengerIndex | String | Index du passager inclus dans la réservation |
| TravellerId | String | Identifiant unique du voyageur associé à la réservation |
| GroupBooking | String | Indique si la réservation est pour un groupe |
| NumberOfPassengers | String | Nombre total de passagers inclus dans la réservation |
| NumberOfAdults | String | Nombre total d’adultes inclus dans la réservation |
| NumberOfChildren | String | Nombre total d’enfants inclus dans la réservation |
| ProcessedDate | String | Date à laquelle la réservation a été traitée |
| CreatedDate | String | Date de création de la réservation |
| CreatedBy | String | Identité du créateur |
| UpdatedDate | String | Date de la dernière mise à jour |
| UpdatedBy | String | Identifiant de la personne ayant mis à jour la réservation pour la dernière fois |
| Statut | String | État de réservation actuel |
| PriorityStatus | String | Niveau de priorité de la réservation |
| ReservationStatus | String | Statut de la réservation |
| MarketingCode | String | Code représentant une source ou une campagne marketing |
| MarketingName | String | Nom de la campagne de marketing |
| TravelAgent | String | Agent de voyage associé à la réservation |
| TravelAgency | String | Nom de l’agence de voyages d’affaires |
| TravelCorpNumber | String | Numéro de client d’entreprise |
| Booker | String | Indique s’il s’agit de la personne qui a effectué la réservation |
| AdditionalInformation | String | Informations supplémentaires sur la forme libre |
| E-mail | String | Adresse e-mail de contact pour les mises à jour des jours de voyage |
| PhoneNumber | String | Numéro de téléphone de contact pour les mises à jour sur les jours de voyage |
| CancelledDate | String | Date d’annulation de la réservation (le cas échéant) |
| Diplomat | String | Indique le statut diplomatique |
| Child | String | Indique si le passager est un enfant |
| Désactivé | String | Indique le statut d’invalidité |
| Oxygen | String | Indique le besoin d’un apport en oxygène |
| PetOnly | String | La réservation est uniquement pour le transport d’un animal de compagnie |
| CancellationCharge | String | Frais d’annulation, le cas échéant. 0 signifierait aucun frais |
| Refundable | String | Informations sur le remboursement de la réservation |
| Inventory | Inventory | Détails de l’inventaire pour la réservation |
| Loyalty | Loyalty | Détails relatifs au programme de fidélité pour la réservation |
| Channel | Channel | Détails du canal pour la réservation |
| Payment | Payment | Informations de paiement pour la réservation |
| BillingAddress | Adresse | Détails de l’adresse de facturation pour la réservation |
| Price | Price | Détails du prix de réservation |
| PaymentStatus | PaymentStatus | État du paiement de la réservation |
| Attributes | Map | Attributs personnalisés ou d’extension |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**Type de données de fidélité**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| ProgramName | String | Nom du programme de fidélité |
| MembershipId | String | Numéro de membre du programme de fidélité |
| Tier | String | Niveau d’adhésion au programme de fidélité |
**Type de données Channel**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| CreationChannelId | String | ID du canal utilisé pour créer la réservation |
| LastUpdatedChannelId | String | ID du canal utilisé pour mettre à jour la réservation |
| Method | String | Méthode utilisée via le canal (par exemple : Web, application, téléphone) |
**Type de données de paiement**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| Type | String | Type de mode de paiement (par exemple : carte, bon) |
| CreditCardToken | String | Carte tokenisée pour une référence sécurisée |
| CreditCardType | String | Type de carte de crédit utilisée |
| CreditCardExpiration | String | Date d’expiration de la carte |
| Cvv | String | Code CVV |
| NameOnCreditCard | String | Cardholder name |
| RoutingNumber | String | Numéro de routage bancaire (le cas échéant) |
| AccountNumber | String | Numéro de compte bancaire (le cas échéant) |
| VoucherId | String | Bon d’achat utilisé pour le paiement |
| DiscountCode | String | Code de réduction promotionnel appliqué |
| DiscountPercent | String | Pourcentage de réduction appliqué au paiement |
**Type de données d’adresse de facturation**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Address1 | String | La première ligne de l’adresse d’un client. |
| Address2 | String | La deuxième ligne de l’adresse d’un client. |
| Address3 | String | La troisième ligne de l’adresse d’un client. |
| Address4 | String | La quatrième ligne de l’adresse d’un client. |
| City | String | La ville de l’adresse du client. |
| Country | String | Le pays de l’adresse du client. |
| County | String | Le comté de l’adresse du client. |
| PostalCode | String | La code postal de l’adresse du client. |
| Province | String | La province de l’adresse du client. |
| State | String | L’état de l’adresse du client. |
**Type de données de prix**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| TotalPrice | String | Prix total de la réservation |
| BasePrice | String | Prix de base de la réservation |
| TravellerPrice | String | Prix payé par voyageur |
| DiscountAmount | String | Réduction appliquée au tarif de base |
| Currency | String | Devise dans laquelle le paiement a été effectué |
**Type de données relatives à l’état du paiement**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| PaidAt | String | Horodatage de la fin du paiement |
| AwaitingPayment | String | Indique que le paiement est en attente |
| RequiredBy | String | Date d’échéance du paiement |
**Type de données d’inventaire**
| Champ airBooking standard | Type | Description |
| --- | --- | --- |
| Seats | String | Nombre total de places lors de la réservation |
# Mappage de type d’objet au segment aérien standard
Les rubriques de cette section fournissent la définition des segments aériens standard.
**Topics**
+ [Champs d’objet de segment aérien standard de Profils des clients](standard-air-segment-object-fields.md)
# Champs d’objet de segment aérien standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de segment aérien standard Profils des clients.
**Segment aérien**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| SegmentId | String | Identifiant unique du segment aérien standard |
| BookingRef | String | Identifiant de référence de réservation |
| SegmentName | String | Nom/description du segment |
| PassengerIndex | String | Numéro d’index du passager |
| SegmentIndex | String | Numéro d’index du segment |
| SeatSelection | String | Détails sur le choix des sièges |
| NumberOfPassengers | String | Nombre total de passagers |
| NumberOfLegs | String | Nombre d’étapes de vol |
| Tier | String | tier/status Niveau des passagers |
| Origin | String | Code de l’aéroport de départ |
| OriginCountryCode | String | Code de pays de départ |
| Dest | String | Code de l’aéroport de destination |
| DestCountryCode | String | Code de pays de destination |
| ProcessedDate | String | Date du traitement du segment |
| CreatedDate | String | Date de création de l’enregistrement |
| CreatedBy | String | Utilisateur qui a créé l’enregistrement |
| UpdatedDate | String | Date de la dernière mise à jour de l’enregistrement |
| UpdatedBy | String | Utilisateur ayant mis à jour l’enregistrement pour la dernière fois |
| Statut | String | Statut actuel du segment |
| FlightNumber | String | Numéro de vol |
| Carrier | String | Code du transporteur |
| CarrierType | String | Type de transporteur |
| IsInternational | String | Indique si le vol est international |
| IsEticket | String | Indique si le billet est électronique |
| IsArmed | String | Indique si un passager est armé |
| LapInfant | String | Détails concernant les bébés |
| Pet | String | Indique si la personne voyage avec un animal de compagnie |
| PrisonerOrGuard | String | Indique un statut de prisonnier ou de gardien |
| Child | String | Indique si le passager est un enfant |
| Married | String | Indique si les segments sont mariés |
| CheckinEligible | String | Indique l’admissibilité à l’enregistrement |
| InEligibleReason | String | Raison si vous n’êtes pas éligible à l’enregistrement |
| UnEscortedMinor | String | Indique le statut de mineur non accompagné |
| PremiumAccess | String | Indique l’achat d’un accès premium |
| MissingData | String | Indique des données manquantes |
| CurrentClassOfService | String | Classe de service actuelle |
| BookedClassOfService | String | Classe de service initialement réservée |
| CodeShare | String | Indique un vol en partage de code |
| ReverseCodeShare | String | Indique un partage de code inverse |
| MarketCarrierCode | String | Code de transporteur marketing |
| OpCarrierCode | String | Code du transporteur |
| InConnection | String | Détails de la connexion entrante |
| OutConnection | String | Détails de la connexion sortante |
| MilesToEarn | String | Miles à cumuler |
| Duration | String | Durée du vol |
| DurationTimeUnit | String | Unité de temps pour la durée |
| Distance | String | Distance du vol |
| DistanceUnit | String | Unité de mesure de distance |
| SellType | String | Indique s’il s’agit d’une vente forcée |
| GoShow | String | Indique s’il s’agit d’un go show |
| Incapacitated | String | Indique si le passager est invalide |
| Upgraded | String | Indique si le vol a été surclassé |
| Downgraded | String | Indique si le vol a été déclassé |
| BaggageInsurance | String | assurance bagages |
| MaxAllowedBaggage | String | Maximum de bagages autorisés |
| BaggageQuantity | String | Nombre de sacs |
| BaggageFee | String | Frais de bagages totaux |
| Arrival | Port | Détails d’arrivée pour le segment |
| Departure | Port | Détails de départ pour le segment |
| Seat | Seat | Détail du siège |
| Priority | Priority | Détail des priorités |
| Doc | Doc | Informations sur les documents d’accompagnement pour le voyage |
| Baggage | Liste des bagages | Détail des bagages |
| Pets | Liste des animaux | Détails sur les animaux |
| OtherServices | OtherService Liste | Détail des autres services |
| Attributes | Map | Attributs supplémentaires |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**Type de données de bagages**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| Id | String | Identifiant des bagages |
| TagNumber | String | Numéro d’étiquette de bagage |
| DepartureDate | String | Date de départ |
| BaggageType | String | Type de bagage |
| Pondération | String | Poids des bagages |
| Length | String | Longueur des bagages |
| Width | String | Largeur des bagages |
| Height | String | Hauteur des bagages |
| PriorityBagDrop | String | Service de dépôt de bagages prioritaires |
| PriorityBagReturn | String | Service de retour de bagages prioritaires |
| HandsFreeBaggage | String | Service de bagages mains libres |
| Fee | String | Frais des bagages |
| IsGateBag | String | Indique les bagages enregistrés à la porte |
| IsHeavy | String | Indique un bagage lourd |
**Type de données de siège**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| SeatNumber | String | Numéro de siège |
| SeatZone | String | Zone du siège |
| SeatType | String | Type de siège |
| Price | String | Prix du siège |
| NeighborFree | String | Indique si le siège voisin est libre |
| UpgradeAuction | String | Indique la disponibilité de la mise aux enchères |
| Available | String | Indique la disponibilité du siège |
| ExtraSeat | String | Indique un siège supplémentaire |
| AdditionalInformation | String | Informations sur les sièges supplémentaires |
**Type de données de port**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| Location | String | Nom du lieu |
| Code | String | Code de l’aéroport |
| Terminal | String | Terminal de l’aéroport |
| Country | String | Pays de l’aéroport |
| Date | String | Date |
| Heure | String | Heure |
| EstimatedTime | String | Durée estimée |
| ScheduledTime | String | Durée planifiée |
**Type de données de priorité**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| TransactionId | String | Identificateur de transaction |
| PriorityServiceType | String | Type de service prioritaire |
| LoungeAccess | String | Indique l’accès au salon |
| Price | String | Prix du service prioritaire |
| AdditionalInformation | String | Informations sur les priorités supplémentaires |
**Type de données sur les animaux**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| Species | String | Espèces animales |
| Breed | String | Race d’animal |
| Pondération | String | Poids de l’animal |
| WeightUnit | String | Unité de mesure du poids |
| TransportType | String | Type de transport d’animaux |
**OtherService type de données**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| ServiceType | String | Type de service |
| Description | String | Description du service |
| Price | String | Prix du service |
**Type de données du document**
| Champ airSegment standard | Type | Description |
| --- | --- | --- |
| DocType | String | Types de document |
| DocTypeNeeded | String | Indique si le document est requis |
| Nationality | String | Nationalité sur le document |
| DateOfBirth | String | Date de naissance |
| AppId | String | Identifiant de l’application |
| AgentId | String | Identifiant de l’agent |
| VerifiedDateTime | String | Délai de vérification des documents |
# Mappage de type d’objet à la réservation d’hôtel standard
Les rubriques de cette section fournissent la définition des réservations d’hôtel standard.
**Topics**
+ [Champs d’objet de réservation d’hôtel standard de Profils des clients](standard-hotel-reservation-object-fields.md)
# Champs d’objet de réservation d’hôtel standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de réservation d’hôtel standard Profils des clients.
**Réservation d’hôtel**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| ReservationId | String | Identifiant unique de la réservation d’hôtel standard |
| ConfirmationNumber | String | Numéro de confirmation fourni par l’hôtel ou le moteur de réservation |
| PreferenceRef | String | L’identifiant faisant référence à l’objet de préférence pour la réservation |
| Statut | String | État actuel de la réservation (par exemple : confirmée, annulée) |
| TripType | String | But ou nature du voyage (par exemple : loisirs, affaires) |
| BrandCode | String | Code représentant la marque de l’hôtel |
| HotelCode | String | Code identifiant l’hôtel en question |
| PhoneNumber | String | Numéro de téléphone pour la réservation |
| EmailAddress | String | Adresse e-mail de contact pour la réservation |
| GroupId | String | Identifiant liant la réservation à une réservation de groupe |
| ContextId | String | Identifiant spécifique au contexte pour le suivi de la source de réservation |
| ProcessedDate | String | Horodatage du traitement de la réservation |
| CreatedDate | String | Horodatage de la création de la réservation |
| CreatedBy | String | Identifiant de la user/system personne qui a créé la réservation |
| UpdatedDate | String | Horodatage de la dernière mise à jour de la réservation |
| UpdatedBy | String | Identifiant de la personne user/system qui a mis à jour la réservation |
| AgentId | String | Identifiant de l’agent chargé de la réservation |
| Reserver | String | Indique si le profil est le réserveur |
| SameDayRate | String | Indique si la réservation a été faite pour le jour même |
| Refundable | String | Indique si la réservation est remboursable |
| CancellationCharge | String | Frais d’annulation, le cas échéant. 0 signifierait aucun frais |
| TransactionId | String | Identifiant unique de la transaction |
| AmountPerNight | String | Montant facturé par nuit pour la chambre |
| AdditionalNote | String | Remarques ou instructions spéciales |
| NumberOfNights | String | Nombre de nuits sur réservation |
| NumberOfGuests | String | Nombre total d’invités dans la réservation |
| TotalAmountBeforeTax | String | Coût total avant taxes |
| TotalAmountAfterTax | String | Coût total après taxes |
| Checkout | CheckOut | Détails du départ |
| Loyalty | Loyalty | Détails du programme de fidélité |
| Room | Room | Détails de la chambre |
| CheckIn | CheckIn | Détails de l’enregistrement |
| Payment | Payment | Détails du paiement |
| Currency | Currency | Détails de la devise |
| Cancellation | Cancellation | Détails d’annulation |
| Channel | Channel | Détails du canal |
| RatePlan | RatePlan | Détails du plan tarifaire |
| Guests | Guests | Détails des invités |
| Services | Liste des services | Liste des services |
| Attributes | Map | Attributs supplémentaires |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**Type de données de départ**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Early | String | Un départ anticipé est prévu ou demandé |
| Late | String | Un départ en retard est prévu ou demandé |
| Self | String | Un départ en libre-service est prévu ou demandé |
| Date | String | Date de départ de la réservation |
**Type de données de fidélité**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| ProgramName | String | Nom du programme de fidélité |
| MembershipId | String | Identifiant du membre dans le programme de fidélité |
| Tier | String | Catégorie ou niveau de fidélité |
**Type de données de chambre**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| TypeCode | String | Code pour le type/la catégorie de chambre |
| TypeName | String | Nom du type de chambre |
| TypeDesc | String | Description du type de chambre |
| Number | String | Numéro de chambre attribué |
| Capacity | String | Capacité maximale de la chambre |
| AccessibilityType | String | Fonctionnalités d’accessibilité |
| SmokingAllowed | String | Indique s’il est permis de fumer dans la chambre |
**CheckIn type de données**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Date | String | Date d’arrivée de la réservation |
| DigitalKey | String | Indique si une clé de chambre numérique a été émise |
| Early | String | Indique si un enregistrement anticipé a été demandé |
| Late | String | Indique si un enregistrement tardif a été demandé |
| RoomKeys | String | Nombre de clés de chambre délivrées |
| UserSelectedRoom | String | Vrai si le client a sélectionné sa propre chambre |
**Type de données de paiement**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Type | String | Type de mode de paiement (par exemple : crédit, débit, voucher) |
| CreditCardToken | String | Numéro de carte de crédit tokenisé |
| CreditCardType | String | Type de carte de crédit (par exemple : Visa, Amex) |
| CreditCardExpiration | String | Date d’expiration de la carte de crédit |
| Cvv | String | Valeur de vérification de la carte |
| NameOnCreditCard | String | Nom imprimé sur la carte de crédit |
| RoutingNumber | String | Numéro d’acheminement bancaire |
| AccountNumber | String | Numéro de compte bancaire |
| VoucherId | String | Identifiant du coupon en cas d’utilisation |
| DiscountCode | String | Code de réduction appliqué |
| DiscountPercent | String | Pourcentage de réduction appliqué |
**Type de données de devise**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Code | String | Code ISO pour la devise (par exemple : USD) |
| Name | String | Nom complet de la devise (par exemple : dollar américain) |
| Symbol | String | Symbole de la devise (par exemple, \$1) |
**Type de données d’annulation**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Raison | String | Motif de l’annulation |
| Comment | String | Remarques d’annulation supplémentaires |
**Type de données Channel**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| CreationChannelId | String | Identifiant du canal par lequel la réservation a été effectuée |
| LastUpdatedChannelId | String | Identifiant du canal qui a mis à jour la réservation pour la dernière fois |
| Method | String | Méthode utilisée pour la réservation (par exemple : Web, application mobile) |
**RatePlan type de données**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Code | String | Code identifiant du plan tarifaire réservé |
| Name | String | Nom du plan tarifaire réservé |
| Description | String | Description du plan tarifaire |
**Type de données de service**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| ServiceType | String | Type de service (spa, petit-déjeuner, etc.) |
| Description | String | Description du service |
| Cost | String | Coût du service |
**Type de données de client**
| Champ hotelReservation standard | Type | Description |
| --- | --- | --- |
| Adults | String | Nombre de clients adultes |
| Children | String | Nombre de clients enfants |
# Mappage de type d’objet à la fidélité standard
Les rubriques de cette section fournissent la définition des fidélités standard.
**Topics**
+ [Champs d’objet de fidélité standard de Profils des clients](standard-loyalty-object-fields.md)
# Champs d’objet de fidélité standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de fidélité standard Profils des clients.
**Loyalty**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| LoyaltyId | String | Identifiant unique du programme de fidélité standard |
| ProgramId | String | Identifiant du programme de fidélité |
| MembershipId | String | Identifiant alternatif au sein du programme |
| ProgramName | String | Nom du programme de fidélité |
| Groupe | String | Groupe ou catégorie du programme de fidélité |
| Channel | String | Canal par lequel le programme de fidélité est accessible |
| CreatedDate | String | Date de création du compte de fidélité |
| EnrollmentDate | String | Date à laquelle le client s’est inscrit au programme |
| CreatedBy | String | Utilisateur ou système ayant créé le compte de fidélité |
| UpdatedDate | String | Date de dernière mise à jour du compte de fidélité |
| LastUpdatedBy | String | Utilisateur ou système ayant mis à jour le compte de fidélité pour la dernière fois |
| UpgradeDate | String | Date de dernière mise à niveau de la catégorie |
| RenewalDate | String | Date de renouvellement de l’adhésion au programme de fidélité |
| AdditionalInformation | String | Toute information supplémentaire |
| EmailAddress | String | Adresse e-mail du client |
| EmailAddressVerified | String | Drapeau indiquant si l’e-mail est vérifié |
| PhoneNumber | String | Numéro de téléphone du client |
| PhoneNumberVerified | String | Drapeau indiquant si le numéro de téléphone est vérifié |
| Statut | String | État actuel du compte de fidélité |
| Tier | Tier | Détails de la catégorie |
| Points | Points | Détail des points |
| PointExpirations | PointExpiration Liste | Détails sur l’expiration des points |
| Payment | Payment | Détails du paiement |
| PaymentInformation | PaymentInformation | Détails des informations de paiement |
| BillingAddress | Adresse de fidélité | Détails de l’adresse |
| Attributes | Map | Attributs supplémentaires non couverts par ailleurs |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**Type de données d’adresse de fidélité**
| Champ airPreference standard | Type de données | Description |
| --- | --- | --- |
| Address1 | String | La première ligne de l’adresse d’un client. |
| Address2 | String | La deuxième ligne de l’adresse d’un client. |
| Address3 | String | La troisième ligne de l’adresse d’un client. |
| Address4 | String | La quatrième ligne de l’adresse d’un client. |
| City | String | La ville dans laquelle habite le client. |
| Country | String | Le pays dans lequel habite le client. |
| County | String | Le comté dans lequel habite le client. |
| PostalCode | String | La code postal de l’adresse du client. |
| Province | String | La province dans laquelle habite le client. |
| State | String | L’état dans lequel habite le client. |
**Type de données de catégorie**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| CurrentTier | String | Catégorie de fidélité actuel du client |
| NextTier | String | Catégorie suivante possible pour le client |
| PointsToNextTier | String | Points nécessaires pour atteindre la catégorie suivante |
**Type de données de points**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| Points.Unit | String | Unité de mesure des points |
| Points.Lifetime | String | Total des points cumulés à vie |
| Points.Balance | String | Solde de points actuel |
| Points.Redeemed | String | Total de points échangés |
**PointExpiration type de données**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| Points | String | Points expirant |
| Date | String | Date d’expiration des points |
**Type de données de paiement**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| Type | String | Type de paiement |
| CreditCardToken | String | Référence de carte de crédit tokenisée |
| CreditCardType | String | Type de carte de crédit (par exemple : Visa) |
| CreditCardExpiration | String | Date d’expiration de la carte de crédit |
| Cvv | String | Valeur de vérification de la carte |
| NameOnCreditCard | String | Nom inscrit sur la carte |
| RoutingNumber | String | Numéro d’acheminement bancaire |
| AccountNumber | String | Numéro de compte bancaire |
| VoucherId | String | Identifiant du bon |
**PaymentInformation type de données**
| Champ de fidélité standard | Type | Description |
| --- | --- | --- |
| Planning | String | Calendrier des paiements |
| LastPaymentDate | String | Date du dernier paiement |
| NextPaymentDate | String | Date du prochain paiement |
| NextBillAmount | String | Montant de la prochaine facture |
| CurrencyCode | String | Devise (par exemple : USD) |
| CurrencyName | String | Nom complet de la devise |
| CurrencySymbol | String | Symbole de la devise (par exemple, \$1) |
# Mappage de type d’objet à la transaction de fidélité standard
Les rubriques de cette section fournissent la définition d’une transaction de fidélité standard.
**Topics**
+ [Champs d’objet de transaction de fidélité standard de Profils des clients](standard-loyalty-transaction-object-fields.md)
# Champs d’objet de transaction de fidélité standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de transaction de fidélité standard Profils des clients.
**Transaction de fidélité**
| Champ loyaltyTransaction standard | Type | Description |
| --- | --- | --- |
| TransactionId | String | Identifiant unique de la transaction de fidélité standard. |
| TransactionName | String | Nom ou étiquette de la transaction. |
| TransactionType | String | Type de transaction (par exemple : gagner, échanger, ajuster). |
| ProgramRef | String | Référence au programme de fidélité associé. |
| MembershipRef | String | Référence à l’abonnement de fidélité utilisé lors de la transaction. |
| PromotionRef | String | Référence à une promotion qui a influencé cette transaction. |
| CreatedDate | String | Date de création de la transaction. |
| TransactionDate | String | Date à laquelle la transaction a eu lieu. |
| Industry | String | Secteur associé à la transaction (par exemple : compagnie aérienne, hôtel). |
| Location | String | Lieu où la transaction a eu lieu. |
| CreatedBy | String | Identifiant indiquant qui a créé la transaction. |
| UpdatedDate | String | Date de la dernière mise à jour de la transformation. |
| UpdatedBy | String | Identifiant de la personne qui a mis à jour la transaction pour la dernière fois. |
| Statut | String | État actuel de la transaction. |
| AccrualType | String | Méthode de comptabilisation (manuelle, automatisée, etc.). |
| Catégorie | String | Catégorie de transaction (par exemple : vol, séjour à l’hôtel). |
| Channel | String | Canal par lequel la transaction a été initiée (par exemple : en ligne, en magasin). |
| ProductId | String | Identifiant du produit ou du service lié à la transaction. |
| Amount | String | Montant dépensé ou traité dans le cadre de la transaction. |
| OriginValue | String | Valeur initiale avant toute conversion ou tout décalage. |
| OriginValueCurrency | String | Devise de la valeur de transaction initiale. |
| OriginValueOffset | String | Ajustement de la valeur initiale pour les promotions, les remboursements, etc. |
| PointsEarned | String | Total des points accumulés grâce à cette transaction. |
| PointOffset | String | Points ajustés (par exemple : bonus, pénalités). |
| QualifyingPointsEarned | String | Points pris en compte pour la qualification à la catégorie supérieure. |
| TierBefore | String | Catégorie client avant la transaction. |
| TierAfter | String | Catégorie client après la transaction. |
| Brand | String | Marque associée à la transaction. |
| Description | String | Description narrative de la transaction. |
| AdditionalInformation | String | Informations supplémentaires sous forme libre relatives à la transaction. |
| PaymentMethod | String | Mode de paiement utilisé (par exemple : carte, voucher). |
| PointTransfer | PointTransfer | Détails sur le transfert de points |
| Attributes | Map | Attributs supplémentaires. |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer type de données**
| Champ loyaltyTransaction standard | Type | Description |
| --- | --- | --- |
| TransferId | String | Identifiant de la transaction de transfert. |
| SourceProgramId | String | Identifiant du programme de fidélité source. |
| DestinationProgrmId | String | Identifiant du programme de fidélité de destination. |
| SourceMembershipId | String | Identifiant de membre dans le programme source. |
| DestinationMembershipId | String | Identifiant de membre dans le programme de destination. |
| PointsTransferred | String | Points déduits du programme source. |
| PointsReceived | String | Points crédités au programme de destination. |
# Mappage de type d’objet à la promotion de fidélité standard
Les rubriques de cette section fournissent la définition de la promotion des fidélités standard.
utilisant
**Topics**
+ [Champs d’objet de promotion de fidélité standard de Profils des clients](standard-loyalty-promotion-object-fields.md)
# Champs d’objet de promotion de fidélité standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de promotion de fidélité standard Profils des clients.
**Promotion de fidélité**
| Champ loyaltyPromotion standard | Type | Description |
| --- | --- | --- |
| PromotionId | String | Identifiant unique de la promotion de fidélité standard. |
| PromotionName | String | Le nom de la promotion. |
| PromotionType | String | Le type ou la catégorie de promotion (par exemple : bonus, augmentation de niveau, bon d’achat). |
| ProgramType | String | Indique le type de programme de fidélité auquel la promotion est liée. |
| ProgramRef | String | Identifiant de référence du programme de fidélité correspondant. |
| PartnerId | String | Identifiant de référence d’une organisation partenaire impliquée dans la promotion. |
| PartnerNumber | String | Un identifiant ou un numéro lié au partenaire. |
| Tier | String | Catégorie ciblée ou impactée par la promotion. |
| StartDate | String | Date à partir de laquelle la promotion devient active. |
| EnrolledDate | String | Date à laquelle l’utilisateur s’est inscrit à la promotion. |
| EndDate | String | Date à laquelle finit la promotion. |
| Amount | String | Valeur monétaire ou valeur en points associée à la promotion. |
| Period | String | Durée de la promotion (par exemple : hebdomadaire, mensuelle, basée sur une campagne). |
| Statut | String | État actuel de la promotion (par exemple : active, expirée, terminée). |
| CreatedDate | String | Date à laquelle l’enregistrement de promotion a été créé. |
| CreatedBy | String | Utilisateur ou système qui a créé l’enregistrement de promotion. |
| UpdatedDate | String | Date de la dernière mise à jour de l’enregistrement. |
| UpdatedBy | String | Utilisateur ou système ayant mis à jour la promotion pour la dernière fois. |
| CampaignRef | String | Référence externe à une campagne plus large à laquelle appartient cette promotion. |
| AdditionalInformation | String | Remarques diverses ou textes marketing concernant la promotion. |
| TriggerLimit | TriggerLimit | Détails sur la limite de déclencheurs |
| Usage | Usage | Détails d’utilisation |
| Rules | Rules | Détails sur les règles de promotion |
| Incentive | Incentive | Détails sur les stratégies incitatives et les promotions |
| Attributes | Map | Métadonnées supplémentaires ou valeurs spécifiques au programme. |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**Type de données de règles**
| Champ loyaltyPromotion standard | Type | Description |
| --- | --- | --- |
| Name | String | Nom de la règle dans les règles de promotion. |
| Description | String | Description de la règle dans les règles de promotion. |
**Type de données de stratégies incitatives**
| Champ loyaltyPromotion standard | Type | Description |
| --- | --- | --- |
| Type | String | Le type de stratégie incitative (par exemple : bonusPoints, bon d’achat, tierUpgrade). |
| Value | String | Valeur de la stratégie incitative, telle que le montant des points ou la valeur du bon d’achat. |
| Unit | String | L’unité de valeur de la stratégie incitative (par exemple : points, %, USD). |
**TriggerLimit type de données**
| Champ loyaltyPromotion standard | Type | Description |
| --- | --- | --- |
| Times | String | Nombre de fois qu’une promotion peut être déclenchée. |
| Interval | String | Intervalle pour la limite de déclenchement. |
**Type de données d’utilisation**
| Champ loyaltyPromotion standard | Type | Description |
| --- | --- | --- |
| UsageProgressPercent | String | Pourcentage de progression de l’utilisation de la promotion. |
| UsageCompleted | String | Nombre d’utilisations terminées. |
| UsageTarget | String | Nombre cible d’utilisations. |
# Mappage du type d'objet pour Web Analytics Object
**WebAnalytics Schéma d'objet standard**
| Champ | Type | Description |
| --- | --- | --- |
| Attributs d'événement |
| EventId | String | Identifiant unique pour un événement d'analyse Web. |
| EventType | String | Type d'événement d'analyse Web, par exemple : affichage de la page, soumission d'un formulaire, clics sur un bouton,Tirez vers le haut de la ligne principale\$1 u0000Interaction avec la barre de recherche, messages d'erreur des applications, interactions avec le panier, achats, défilements, etc. |
| EventTimestamp | Number | Horodatage de l'événement en millisecondes. |
| EventDuration | Number | EventDuration représente le temps passé par un utilisateur au cours d'une interaction particulière, mesuré en secondes. Les cas d'utilisation courants incluent : le temps passé à consulter un produit, la durée d'une session de navigation sur une page particulière, le temps passé sur une fonctionnalité, etc. |
| EventValue | Number | EventValue est un attribut numérique qui représente la valeur ou l'importance d'un événement d'interaction. Les cas d'utilisation courants incluent : le montant de l'achat pour les événements liés aux transactions, les valeurs d'évaluation pour les évaluations de produits, le pourcentage d'achèvement pour les visionnages de vidéos, etc. |
| Attributs de session |
| ID de session | String | Identifiant unique de la session. |
| Séance. StartTimestamp | Number | Époque en millisecondes indiquant l'horodatage de début de la session. |
| Attributs de page/écran |
| Titre de la page | String | Titre d'un App/Screen nom Web pour une application mobile. |
| Page.Emplacement | String | URL d'une page Web. Pour les appareils mobiles, il peut s'agir d'un lien profond ou d'un itinéraire vers l'écran. |
| Référent de page | String | Écran/page précédent. |
| Page.Catégorie | String | Regroupement logique d'un screen/page. Might be useful to group nested URLs/app emplacement. |
| Éléments HTML/DOM |
| Identifiant de l'élément | String | ID de l'élément HTML |
| Type d'élément | String | Type d'élément : bouton, liens d'ancrage, etc. |
| Elément. Classes | String | Classes de style CSS de l'élément |
| Elément.Texte | String | Texte de l'élément (utile pour les boutons, les espaces réservés aux champs de saisie, etc.). |
| Élément. AltText | String | AltText d'un élément HTML (généralement utilisé pour les images). |
| Elément. Source | String | Source d'une vidéo, d'une image, etc. |
| Formulaire |
| ID du formulaire | String | Identifiant unique pour un formulaire de saisie |
| Nom du formulaire | String | Nom du formulaire |
| Forme.Longueur | String | Nombre de champs de saisie dans un formulaire. |
| Formulaire. ValidationErrors | Number | Nombre d'erreurs de validation dans le formulaire. |
| Formulaire. FieldsCompleted | Number | Nombre de champs complétés. |
| Formulaire. FieldsRequired | Number | Nombre de champs obligatoires. |
| Recherche |
| Rechercher. Requête | String | Chaîne de requête utilisée dans l'entrée |
| Rechercher. TotalMatchingResults | Number | Nombre total de résultats de recherche. |
| Rechercher. ResultsPerPage | Number | Nombre de résultats affichés par page. |
| Rechercher. CurrentResultsPage | Number | Page de résultats actuelle que l'utilisateur est en train de consulter. |
| Rechercher. FilterExpression | String | Toute expression de filtre supplémentaire utilisée. |
| Rechercher. SortCriteria | String | Critères de tri des résultats de recherche. Par exemple : pertinence, prix, etc. |
| Rechercher. SortOrder | String | Ordre de tri des résultats de recherche : croissant ou décroissant. |
| Article/Liste des articles |
| Élément | Élément | Article ciblé dans un événement, indiquant l'article ajouté au panier, l'article consulté, etc. |
| ItemsList | Liste - | Liste ciblée des articles inclus dans un événement, indiquant les articles achetés, les articles d'un panier, les résultats de recherche d'articles, etc. |
| Impressions sur les articles |
| AdditionalItemImpressions | Liste
- | Liste d'impressions d'articles supplémentaires |
| Chariot |
| ID du panier | String | Identifiant unique pour un panier. |
| Panier. ItemsCount | Number | Nombre d'articles dans le panier. |
| Panier. Devise | String | Devise pour la valeur du panier. |
| Valeur du panier | Number | Valeur monétaire des articles du panier. |
| Informations de commande |
| OrderId | String | Identifiant unique pour une commande. Nous ne stockerons que l'identifiant de commande ici, les autres informations relatives à la commande seront stockées dans l'objet de commande standard. |
| Appareil |
| DeviceId | String | Identifiant unique de l'appareil de l'utilisateur. |
| Défiler les attributs |
| Faites défiler. DepthPercentage | String | Pourcentage de profondeur de défilement vertical. Cela permet de comprendre jusqu'où un utilisateur fait défiler une page Web. |
| Scroll.PositionX | Number | Position du défilement horizontal en pixels à partir de la gauche. |
| Scroll.PositionY | Number | Position du défilement vertical en pixels à partir du haut. |
| Erreur |
| Erreur.Description | String | Brève description de l'erreur. |
| Erreur.Type | String | Error/Server Erreur de saisie utilisateur. |
| Utilisateur |
| ID utilisateur | String | Identifiant unique de l'utilisateur |
| Utilisateur. AnonymousId | String | Anonyme UserId. Il s'agirait d'un identifiant unique attribué à un utilisateur lorsqu'il n'est pas connecté. |
| Utilisateur. IsReturning | String | Une valeur booléenne indiquant si un utilisateur est en train de revenir. |
| Utilisateur. IsLoggedIn | String | Valeur booléenne indiquant si un utilisateur est connecté. |
| Emplacement de l'activité |
| Location.Country | String | Pays d'activité de l'utilisateur. |
| Emplacement.État | String | État de l'activité de l'utilisateur. |
| Lieu.Province | String | Province d'activité de l'utilisateur. |
| Emplacement.Comté | String | Pays d'activité de l'utilisateur. |
| Emplacement.Ville | String | Ville d'activité de l'utilisateur. |
| Emplacement.Latitude | String | Coordonnées de localisation de l'activité de l'utilisateur |
| Emplacement.Longitude | String | Coordonnées de localisation de l'activité de l'utilisateur |
| Attributs des applications |
| Application.Name | String | Nom de l'application. |
| Application.Version | String | Si l'appareil est mobile, nous pouvons capturer la version de l'application ici. L'utilisateur pourrait également envisager de l'utiliser pour des A/B tests sur la population ou des attributs d'expérimentation. |
| Application.Environnement | String | Environnements d'applications, tels que - Beta, Gamma, Prod. |
| Attributs personnalisés |
| Attributes | Map | Tous les attributs ou métadonnées personnalisés à ajouter à l'événement. |
**WebAnalytics Schéma d'objet d'article**
| Champ | Type | Description |
| --- | --- | --- |
| Id | String | Identifiant unique de l'article. |
| Titre | String | Titre de l'article. |
| Catégorie | String | Catégorie de l'article |
| Value | String | Valeur monétaire de l'article. |
| Currency | String | Devise de l'article. |
| Quantity | Number | Quantité de l'article |
| ImpressionType | String | Chaîne identifiant le type d'impression d'un événement. Par exemple : en vedette, sponsorisé, meilleurs choix, etc. |
| ImpressionId | String | Un identifiant de chaîne permettant d'identifier de manière unique une impression. |
**Schéma d'objet standard de l'appareil**
| Champ | Type | Description |
| --- | --- | --- |
| DeviceId | String | Identifiant unique de l'appareil. |
| Type | String | Type d'appareil (par exemple, ordinateur de bureau, mobile) |
| Modèle | String | Modèle d'appareil, comme - Macbook Pro/Air, IPhone 16, etc. |
| Fabricant | String | Fabricant de l'appareil. |
| OperatingSystem | String | Indique Windows MacOs, IOS, Android. |
| OperatingSystemVersion | String | Version du système d'exploitation |
| ScreenWidth | Number | Largeur de l'écran ViewPort |
| ScreenHeight | Number | Hauteur de l'écran ViewPort |
| Navigateur | String | Nom du navigateur avec lequel l'utilisateur interagit. |
| BrowserVersion | String | Version du navigateur |
| Paramètre régional | String | Paramètres régionaux de l'appareil ou de l'application. |
| Attributes | Map | Tous les attributs personnalisés d'un appareil. |
# Cartographie des types d'objets pour le catalogue d'articles
| Champ | Type | Description |
| --- | --- | --- |
| Id | String | Identifiant unique de l'article du catalogue. |
| Name | String | Nom de l'article |
| Code | String | Code de l'article du catalogue |
| Type | String | Type d'article du catalogue |
| Catégorie | String | Catégorie de l'article dans le catalogue |
| Description | String | Description de l'article |
| AdditionalInformation | String | Toute information supplémentaire relative à l'article. |
| ImageLink | String | Lien vers l'image de l'article |
| Lien | String | URL de l'article |
| Price | String | Prix de l'article |
| CreatedAt | Long | Horodatage de l'époque pour laquelle l'article a été créé |
| UpdatedAt | Long | Horodatage de l'époque pour laquelle l'article a été mis à jour |
| Attributes | Map | Attributs supplémentaires de l'article |
**Note**
Vous ne pouvez supprimer le type d'objet de domaine que via APIs. Vous pouvez supprimer l'intégration du catalogue d'articles une fois que tous les recommandateurs ont d'abord été supprimés. Cela permet d'éviter les problèmes de dépendance des données.
**Étapes à suivre pour supprimer :**
1. Supprimer tous les recommandateurs existants dans votre domaine
2. Accédez à l'intégration du catalogue d'articles.
3. Sélectionnez l'option de suppression.
# Mappage de type d’objet aux revenus liés aux séjours en hôtel standard
Les rubriques de cette section fournissent la définition des revenus liés aux séjours en hôtel standard.
**Topics**
+ [Champs d’objet de revenus liés aux séjours en hôtel standard de Profils des clients](standard-hotel-stay-revenue-object-fields.md)
# Champs d’objet de revenus liés aux séjours en hôtel standard de Profils des clients
Le tableau suivant répertorie tous les champs de l’objet de revenus liés aux séjours en hôtel standard Profils des clients.
**Revenus liés aux séjours en hôtel**
| hotelStayRevenue Champ standard | Type | Description |
| --- | --- | --- |
| StayRevenueId | String | L’identifiant unique des revenus liés aux séjours en hôtel. |
| CurrencyCode | String | Code ISO pour la devise (par exemple : USD) |
| CurrencyName | String | Nom complet de la devise (par exemple : dollar américain) |
| CurrencySymbol | String | Symbole de la devise (par exemple, \$1) |
| ReservationId | String | Identifiant unique de la réservation d’hôtel |
| GuestId | String | Identifiant unique pour le client |
| LastUpdatedOn | String | Horodatage de la dernière mise à jour de l’enregistrement des séjours |
| CreatedOn | String | Horodatage du moment où le cas de séjour a été créé |
| LastUpdatedBy | String | Identifiant de la personne user/system qui a mis à jour le dossier de séjour pour la dernière fois |
| CreatedBy | String | Identifiant de l' user/system auteur de l'enregistrement du séjour |
| StartDate | String | Date de début du séjour en hôtel |
| HotelCode | String | Code identifiant l’hôtel en question |
| Type | String | Type de revenu (par exemple : tarif de la chambre, frais accessoires, taxes) |
| Description | String | Description de l’article des revenus |
| Amount | String | Montant de l’article des revenus |
| ProcessedDate | String | Date à laquelle les revenus ont été traités |
| Statut | String | État de l’article des revenus |
| Attributes | Map | Métadonnées supplémentaires ou valeurs spécifiques au programme. |
**Champs d’index standard**
| Nom d’index standard | Champ d’enregistrement de préférence standard |
| --- | --- |
| \$1 hotelStayRevenue Identifiant | StayRevenueId |
# Propriétés supplémentaires des types d’objets dans les Profils de clients
Un type de propriété définit la clé à utiliser pour chiffrer les données du type d’objet.
Il existe une option qui définit si de nouveaux profils peuvent être créés par l’ingestion de cet objet. Normalement, lorsqu’un objet ingéré ne peut pas être associé à un profil existant, un nouveau profil est créé tant que cette option est true. Si elle n’est pas true, l’objet ingéré est créé et écrit dans la file d’attente de lettres mortes du domaine.
Il indique également la durée pendant laquelle les données de ce type d’objet doivent être conservées dans Profils des clients.
**Note**
La rétention des objets individuels est définie au moment de l’ingestion des données. La modification de la rétention pour un type d’objet spécifique ne s’applique qu’aux nouvelles données ingérées. Elle ne s’applique pas aux données existantes déjà ingérées.
**Note**
Si cet objet correspond à un profil existant, il ne remplacera pas les champs remplis manuellement par le biais d’un appel d’API ou de l’espace de travail de l’agent, afin d’empêcher les ingestions automatisées de remplacer les champs manuels.
Supposons, par exemple, qu'un profil soit créé manuellement avec FirstName « John » par un agent dans l'espace de travail de l'agent. Un objet mappant des données au FirstName champ du profil standard est ingéré. Si cet objet est associé au profil, il ne remplacera pas le FirstName « John ».
# Profils inférés
Lorsqu’un profil est créé par l’ingestion d’un objet ne comportant aucun champ, l’objet de profil standard de ce nouveau profil est vide. Cet objet de profil standard vide est un **profil déduit**.
Lors de la création d’un profil déduit, les deux champs suivants sont renseignés dans l’objet standard à partir de l’objet de profil, si disponible.
+ Si un champ est défini avec le type de contenu `EMAIL_ADDRESS` dans l’objet ingéré, cette valeur sera renseignée dans le champ `EmailAddress` du profil standard.
+ S’il existe un champ avec le type de contenu `PHONE_NUMBER` dans l’objet ingéré, cette valeur sera renseignée dans le champ `PhoneNumber` du profil standard.
Les valeurs de ces champs sont renseignées dans le profil standard même si aucune cible n’est définie dans la définition du champ.
Pour en savoir plus sur les types de modèles d’enregistrements de contacts, ainsi que sur la façon d’ajuster le modèle utilisé sur votre domaine, consultez [Exemples d’utilisation du modèle d’enregistrement de contact](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples).
# Modèles d’enregistrement des contacts dans Profils des clients Amazon Connect
Un enregistrement de contact sert d’objet de profil qui capture les métadonnées essentielles de divers événements de contact, tels que les appels téléphoniques ou les chats. Il joue un rôle essentiel dans la documentation et l’analyse des interactions avec les clients.
Lorsqu’un événement de contact a lieu, nous proposons trois modèles par défaut distincts qui peuvent être appliqués à votre domaine. Ces modèles servent d’options de configuration et régissent la manière dont l’événement de contact est géré dans le système. Chaque modèle définit des règles et des actions spécifiques, ce qui vous permet d’adapter le traitement des événements de contact en fonction des besoins de votre entreprise.
**Topics**
+ [Créez des profils déduits et associez automatiquement des profils (CTR-) NoInferred](#ctr-contact-record-template-no-inferred)
+ [Associer automatiquement les profils uniquement (CTR-) AutoAssociateOnly](#ctr-contact-record-template-auto-associate)
+ [Création de profils déduits uniquement (CTR)](#ctr-contact-record-template-inferred-only)
+ [Exemples d’utilisation du modèle d’enregistrement de contact](#ctr-contact-record-template-usage-examples)
+ [Comment mettre à jour le type d’enregistrement de contact dans la console AWS](#ctr-contact-record-template-usage-examples-console)
+ [Ajout automatique de noms à un profil depuis des contacts e-mail](#add-email-names-to-profile)
## Créez des profils déduits et associez automatiquement des profils (CTR-) NoInferred
**Description**
Lorsque le NoInferred modèle CTR est utilisé et qu'un événement de contact, tel qu'un appel téléphonique, a lieu, un processus spécifique est lancé pour traiter les données. Dans un premier temps, le système utilise la clé `_ctrContactId` pour rechercher un profil existant associé à l’événement de contact. Si un profil correspondant est trouvé, l’événement de contact est automatiquement associé à ce profil. Toutefois, si aucun profil existant n’est trouvé à l’aide de la clé `_ctrContactId`, le système procède à la recherche d’un profil à l’aide d’une clé secondaire appelée `_phone`. Cette clé est utilisée pour localiser un profil existant en fonction du numéro de téléphone associé à l’événement de contact. Lorsqu’un profil correspondant est trouvé, l’événement de contact est automatiquement associé à ce profil.
Dans les cas où ni la clé `_ctrContactId` ni la clé `_phone` ne donnent un profil existant, le système crée un nouveau profil déduit. Ce profil déduit est ensuite renseigné avec les métadonnées de l’événement de contact, garantissant ainsi que les informations sont capturées et stockées dans le système.
Ce processus garantit une gestion efficace des événements de contact, favorise l’association automatique avec les profils existants et permet la création de profils déduits lorsque cela est nécessaire. En tirant parti de ces mécanismes, les organisations peuvent conserver un enregistrement complet des interactions avec les clients et gérer efficacement les données relatives à leurs événements de contact au sein du système.
Il est recommandé d'utiliser le NoInferred modèle CTR comme comportement par défaut en raison de ses avantages significatifs, notamment pour réduire les doublons de profils
![\[Le schéma du NoInferred modèle Contact Record CTR-.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## Associer automatiquement les profils uniquement (CTR-) AutoAssociateOnly
**Description**
Le AutoAssociateOnly modèle CTR fonctionne de la même manière que le NoInferred modèle CTR, à une différence importante près : il ne crée pas de profil inféré lorsqu'aucun profil existant ne peut être trouvé pour l'association automatique.
Lorsqu'un événement de contact, tel qu'un appel téléphonique, a lieu, le AutoAssociateOnly modèle CTR utilise la `_ctrContactId` clé pour rechercher un profil existant correspondant. Si un profil est trouvé, l’événement de contact est automatiquement associé à ce profil.
Toutefois, si aucun profil existant n’est trouvé à l’aide de la clé `_ctrContactId`, le modèle utilise un mécanisme de recherche secondaire utilisant la clé `_phone`. Il recherche un profil existant associé au même numéro de téléphone que l’événement de contact. Si un profil correspondant est trouvé, l’événement de contact est automatiquement associé à ce profil.
Le but de l'utilisation du AutoAssociateOnly modèle CTR est de permettre l'association automatique avec les profils existants tout en maintenant un contrôle strict sur la création des profils. Contrairement au NoInferred modèle CTR-, ce modèle empêche la création de profils déduits lorsqu'aucune correspondance n'est trouvée. Il garantit que les profils ne sont créés que manuellement, offrant ainsi aux organisations un niveau supérieur de contrôle et de précision dans la gestion des profils.
En utilisant le AutoAssociateOnly modèle CTR-, les organisations peuvent tirer parti de l'association automatique tout en respectant des règles spécifiques concernant la création de profils. Cette approche permet une gestion rationalisée des événements de contact et un contrôle précis de l’écosystème des profils, garantissant ainsi une représentation précise des données et facilitant une gestion efficace des clients.
![\[Le schéma du AutoAssociateOnly modèle Contact Record CTR-.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## Création de profils déduits uniquement (CTR)
**Description**
Le modèle CTR s’appuie uniquement sur la clé `_ctrContactId` pour rechercher un profil existant et il associe automatiquement l’événement de contact au profil si une correspondance est trouvée. Toutefois, dans les cas où aucun profil existant n’est trouvé, le modèle crée un profil déduit et le renseigne avec les métadonnées de l’événement de contact.
Bien que ce comportement garantisse la capture des événements de contact, même en l’absence de profil pré-existant, il peut potentiellement entraîner la création de nombreux profils déduits. Cette abondance de profils déduits peut entraîner le problème de doublons de profils au sein du système.
Pour répondre à cette préoccupation et promouvoir de meilleures pratiques de gestion des profils, nous vous recommandons vivement d'utiliser le NoInferred modèle CTR comme option par défaut. En utilisant le NoInferred modèle CTR, le système élimine la création de profils déduits, réduisant ainsi le nombre de profils dupliqués. Ce modèle permet une gestion plus rationalisée et plus efficace des événements de contact, ce qui améliore l’intégrité et la précision des données.
En adoptant le NoInferred modèle CTR- comme choix par défaut, les entreprises peuvent optimiser leurs processus de gestion des profils, minimiser la duplication des données et garantir une représentation plus fiable des interactions avec les clients.
![\[Le schéma du modèle CTR d’enregistrement de contact.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## Exemples d’utilisation du modèle d’enregistrement de contact
**Amazon Connect site web d'administration**
+ Sur le site Web Amazon Connect d'administration, lors de la création d'un nouveau domaine, vous avez la possibilité de sélectionner le comportement CTR souhaité. Cela peut être fait via les cases d’option disponibles dans la section **Création de profils et association automatique**. De même, lors de la sélection d’un domaine existant, la case d’option reflétera le comportement précédemment associé à ce domaine.
+ Lorsque vous modifiez un domaine actuellement activé, la page des détails du domaine affiche le comportement actuellement appliqué dans la section **Création de profils et association automatique**. En cliquant sur le bouton **Modifier** dans l’en-tête de cette section, vous serez redirigé vers la page **Modifier** **la création de profils et association automatique**. Ici, vous pouvez choisir un comportement différent en fonction de vos besoins.
+ Si vous visualisez le mappage CTR depuis la page **Mappage de données**, vous pouvez également choisir le bouton **Modifier le modèle**. Cette action vous amène également sur la page **Modifier** **la création de profils et association automatique**, où vous pouvez sélectionner un comportement différent adapté à vos besoins.
Ces options vous offrent une certaine flexibilité dans la gestion du comportement CTR de vos domaines, ce qui vous permet de personnaliser et de modifier facilement les paramètres en fonction de vos préférences spécifiques ou de l’évolution des exigences de votre entreprise.
**AWS INTERFACE DE LIGNE DE COMMANDE (CLI)**
+ Pour utiliser le NoInferred modèle **CTR-**, exécutez la commande suivante sur la CLI :
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ Pour utiliser le AutoAssociateOnly modèle **CTR-**, exécutez la commande suivante sur la CLI :
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ Pour utiliser le modèle **CTR**, exécutez la commande suivante sur l’interface de ligne de commande :
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `
**API**
Pour plus d'informations sur l'utilisation de l'API, voir [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
## Comment mettre à jour le type d’enregistrement de contact dans la console AWS
1. Dans la console Profils des clients, sélectionnez **Afficher les détails** dans la section du **Domaine Profils des clients**.
![\[Choisissez Afficher les détails dans la section Domaine Profils des clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. Sur la page **Détails du domaine**, choisissez **Modifier** dans la section **Création de profils et association automatique**.
![\[Choisissez Modifier dans la section Création de profils et association automatique.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. Sélectionnez le comportement d’enregistrement de contact que vous souhaitez appliquer à votre domaine et choisissez **Enregistrer**.
![\[Sélectionnez le comportement d’enregistrement de contact que vous souhaitez appliquer à votre domaine et choisissez Enregistrer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## Ajout automatique de noms à un profil depuis des contacts e-mail
Vous pouvez configurer un flux pour propager un nom depuis un contact e-mail vers le profil du client. Utilisez le bloc [Profils des clients](customer-profiles-block.md), configuré pour utiliser l’action [Mettre à jour le profil](customer-profiles-block.md#customer-profiles-block-properties-update-profile).
# Associez l’enregistrement de contact à un profil trouvé à l’aide de la clé \$1phone dans Profils des clients
Vous pouvez associer automatiquement l’enregistrement de contact à un profil trouvé à l’aide de la clé `_phone`.
**Exemple**
Dans le domaine, le profil suivant est créé par l’API `CreateProfile` :
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
Lorsqu’un appel est reçu du `PhoneNumber` \$111234567890 à l’aide du modèle CTR par défaut, l’enregistrement de contact n’est pas automatiquement associé au profil ci-dessus, sauf si un agent a déjà associé manuellement l’enregistrement de contact avec le même appelant au profil ci-dessus. Si l’enregistrement de contact n’a pas été associé manuellement ou automatiquement, la fonctionnalité Profils des clients crée un profil déduit avec les informations de l’enregistrement de contact.
Pour associer automatiquement le profil ci-dessus aux enregistrements de contacts sans intervention manuelle de l'agent, vous pouvez utiliser le NoInferred modèle CTR-. Lorsqu'un appel est reçu du `PhoneNumber` \$111234567890 à l'aide du NoInferred modèle CTR-, l'enregistrement du contact est automatiquement associé au profil ci-dessus à l'aide de la clé de profil. `_phone`
Il existe deux scénarios dans lesquels la fonctionnalité Profils des clients ne peut *pas* associer automatiquement les enregistrements de contacts à un profil :
+ Si plusieurs profils sont trouvés à l’aide de la clé de profil `_phone`, la fonctionnalité Profils des clients ne peut pas associer l’enregistrement de contact à un profil unique et la demande est rejetée.
+ Si aucun profil n’est trouvé pour la clé de profil `_phone`, la fonctionnalité Profils des clients crée un profil déduit.
Pour utiliser le modèle CTR afin de remplacer le NoInferred modèle CTR par défaut, exécutez la commande suivante sur la CLI :
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`
Pour revenir au comportement par défaut, exécutez la commande suivante sur l’interface de ligne de commande :
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`
# Exemples de mappages de types d’objets dans Profils des clients Amazon Connect
## Un mappage de type d’objet qui génère un profil
L’exemple suivant montre les données qui renseignent le profil standard.
Voici l’objet entrant :
```
{
"account": 1234,
"email": "john@examplecorp.com",
"address": {
"address1": "Street",
"zip": "Zip",
"city": "City"
},
"firstName": "John",
"lastName": "Doe"
}
```
Le code suivant montre que l’objet entrant est mappé dans un objet de profil standard et indexe `PersonalEmailAddress`, `fullName` et `accountId`, qui est une clé unique.
```
{
"Fields": {
"accountId": {
"Source": "_source.account",
"Target": "_profile.AccountNumber",
"ContentType": "NUMBER"
},
"shippingAddress.address1": {
"Source": "_source.address.address1",
"Target": "_profile.ShippingAddress.Address1"
},
"shippingAddress.postalCode": {
"Source": "_source.address.zip",
"Target": "_profile.ShippingAddress.PostalCode"
},
"shippingAddress.city": {
"Source": "_source.address.city",
"Target": "_profile.ShippingAddress.City"
},
"personalEmailAddress": {
"Source": "_source.email",
"Target": "_profile.PersonalEmailAddress",
"ContentType": "EMAIL_ADDRESS"
},
"fullName": {
"Source": "{{_source.firstName}} {{_source.lastName}}"
},
"firstName": {
"Source": "_source.firstName",
"Target": "_profile.FirstName"
},
"lastName": {
"Source": "_source.lastName",
"Target": "_profile.LastName"
}
},
"Keys": {
"_email": [
{
"FieldNames": ["personalEmailAddress"]
}
],
"_fullName": [
{
"FieldNames": ["fullName"]
}
],
"_account": [
{
"StandardIdentifiers": ["PROFILE","UNIQUE"],
"FieldNames": ["accountId"]
}
]
}
}
```
Notez que `email` et `fullname` sont indexés, mais ils ne sont pas utilisés pour rechercher le profil. Le compte est la clé unique. Il est nécessaire de spécifier l’objet. Chaque fois qu’un objet avec le même ID de compte est ingéré, il remplace l’objet précédent avec le même ID de compte.
Plusieurs champs sont renseignés dans l’objet de profil standard (consultez les champs avec une `Target` définie).
## Un mappage de type d’objet qui ne renseigne pas le profil standard
Cet exemple montre un cas d’utilisation plus complexe. Il ingère les données relatives à un profil mais ne renseigne pas nécessairement l’objet de profil standard.
Voici l’objet entrant :
```
{
"email": "john@examplecorp.com",
"timestamp": "2010-01-01T12:34:56Z",
"subject": "Whatever this is about",
"body": "Body of ticket"
}
```
Voici un moyen de mapper ces données :
```
{
"Fields": {
"email": {
"Source": "_source.email",
"ContentType": "EMAIL_ADDRESS"
},
"timestamp": {
"Source": "_source.timestamp"
}
},
"Keys": {
"_email": [
{
"StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
"FieldNames": ["email"]
}
],
"ticketEmail": [
{
"StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
"FieldNames": ["email"]
}
],
"uniqueTicket": [
{
"StandardIdentifiers": ["UNIQUE"],
"FieldNames": ["email","timestamp"]
}
]
}
}
```
Cet exemple ingère les données et, lors de la première recherche, il ingère l’adresse e-mail.
+ Si l’adresse e-mail correspond à un seul profil, elle est utilisée pour joindre les données à ce profil spécifique. L’identifiant unique du ticket est composé de l’adresse e-mail et de l’horodatage puisqu’il n’existe aucun autre identifiant unique.
+ Si aucun profil n’existe avec l’adresse e-mail spécifiée, un nouveau profil est créé avec le seul champ `EmailAddress` renseigné. L’objet ingéré est attaché à ce nouveau **profil déduit**. Les deux clés consultables permettant de trouver le profil sont `_email` et `uniqueTicket`.
+ Si plusieurs profils existent avec l’adresse e-mail spécifiée, un nouveau profil est créé avec le seul champ `EmailAddress` renseigné et l’objet est attaché à ce nouveau profil. Ce profil est créé avec la clé `ticketEmail` définie, en plus de `_email` et `uniqueTicket`. Tous les tickets suivants provenant de cette adresse e-mail sont affectés à ce nouveau **profil déduit**. La raison en est que la clé ` _email` fait référence à trois profils et est donc supprimée, mais la clé `ticketEmail` ne fait référence qu’à un seul profil (le nouveau profil déduit) et est toujours valide.
+ Dans les cas où un nouveau **profil déduit** est créé, le champ `EmailAddress` est renseigné à partir du premier objet qui l’a créé.
# Types d’objets de profil implicites dans Profils des clients Amazon Connect
Vous pouvez utiliser n'importe quel type d'objet correspondant au nom d'un identifiant de modèle (tel que renvoyé par l'[ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API) sans le définir explicitement. Le type d’objet correspondra exactement à la définition du modèle de ce type d’objet. Si un type d’objet explicite est défini, il remplace le type implicite.
Les types d'objets implicites sont inclus dans l'[ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html)API ou renvoyés par les [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html)opérations, mais ils peuvent toujours être supprimés si vous souhaitez supprimer toutes les données ingérées à partir de ce type d'objet.
# Mappage des données optimisé par l’IA générative dans Amazon Connect
Amazon Connect Customer Profiles fournit une fonctionnalité de cartographie des données clients basée sur l'IA générative qui réduit considérablement le temps nécessaire à la création de profils unifiés, vous permettant ainsi de proposer des expériences clients plus personnalisées.
Grâce à cette fonctionnalité, lorsque les administrateurs de centres d'appels ajoutent des données clients à partir de l'un des plus de 70 connecteurs de données sans code disponibles tels qu'Adobe Analytics, Salesforce ou Amazon Simple Storage Service (S3), Amazon Connect Customer Profiles analysera les données provenant de ces sources afin de déterminer automatiquement comment organiser et combiner des données qui existent sous différents formats et provenant de sources disparates dans des profils unifiés dans. Amazon Connect Les administrateurs des centres de contact peuvent examiner et terminer la configuration des profils clients, afin de fournir aux agents des informations pertinentes sur les clients et de personnaliser IVRs dynamiquement les chatbots pour améliorer la satisfaction des clients et la productivité des agents.
Le mappage des données client optimisé par l’IA générative est disponible dans les régions suivantes :
+ USA Est (Virginie du Nord)
+ USA Ouest (Oregon)
+ Afrique (Le Cap)
+ Asie-Pacifique (Singapour)
+ Asie-Pacifique (Sydney)
+ Asia Pacific (Tokyo)
+ Asie-Pacifique (Séoul)
+ Canada (Centre)
+ Europe (Francfort)
+ Europe (Londres)
## Configuration du mappage de données optimisé par l’IA générative
1. Ouvrez la console Amazon Connect Customer Profiles.
1. Dans l’onglet **Intégrations de sources de données**, choisissez **Ajouter une intégration de source de données**.
1. Configurez la connexion. Sélectionnez la source de données dans la liste déroulante qui contient tous les connecteurs pris en charge disponibles.
![\[Sélectionnez la source de données dans la liste déroulante qui contient tous les connecteurs pris en charge disponibles.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. Mappez les données. Sélectionnez l’option permettant de générer automatiquement le mappage des données de sélectionner un modèle de mappage déjà existant ou d’en créer un à partir de zéro.
![\[Mappez les données. Sélectionnez l’option permettant de générer automatiquement le mappage des données de sélectionner un modèle de mappage déjà existant ou d’en créer un à partir de zéro.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)
1. Passez en revue le résumé du mappage. Passez en revue le résumé des résultats du mappage généré automatiquement, qui montre tous les attributs du client. Apportez des modifications aux clés d’ingestion et confirmez-les avant de commencer l’ingestion des données. Pour en savoir plus sur les mappages des champs et les clés, consultez [Détails de la définition du mappage de type d’objet dans Profils des clients Amazon Connect](object-type-mapping-definition-details.md).
![\[Passez en revue le résumé du mappage. Passez en revue le résumé des résultats du mappage généré automatiquement, qui montre tous les attributs du client. Apportez des modifications aux clés d’ingestion et confirmez-les avant de commencer l’ingestion des données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## Comment ça marche
Le système fonctionne en quatre phases. Au cours de la première phase, la fonctionnalité Profils des clients récupère les attributs de la source et, s’ils sont disponibles, échantillonne les données de votre source de données, puis détermine le type d’objet le plus approprié pour la cible. Pour une source de données Amazon S3, le premier fichier CSV trouvé dans le compartiment et le préfixe Amazon S3 sélectionnés sera utilisé comme exemple de données. Pour les autres sources de données, Customer Profiles extrait les attributs de la source. AppFlow Au cours de la deuxième phase, un grand modèle de langage (LLM) est utilisé pour poursuivre le traitement de chacun des attributs personnalisés et les mapper aux attributs de profil client standard. Le LLM est à nouveau utilisé dans la troisième phase pour sélectionner les attributs appropriés pouvant servir de clés, tels que les identifiants de client. Enfin, dans la quatrième phase, le détecteur de format d’horodatage analyse les horodatages pour maintenir l’ordre chronologique correct des enregistrements. Le système est capable de générer le mappage pour un maximum de 120 attributs en moins de 20 secondes après avoir combiné les résultats des prédictions.
## Résolution des problèmes de mappage de données optimisé par l’IA générative
Les sections suivantes présentent les éventuels messages d’erreur que vous pouvez rencontrer. Elles fournissent également la cause et la résolution de chaque problème.
### Erreur : Impossible d’analyser la chaîne d’objet en JSON
La chaîne d’objet de la demande n’est pas un objet JSON valide. Passez en revue la chaîne d’objet de la demande et vérifiez qu’il s’agit d’un objet JSON valide.
### Erreur : la valeur pour ’objects’ ne satisfait pas la contrainte : le membre doit avoir une longueur inférieure ou égale à 5
La demande contient trop d’objets. Jusqu’à cinq objets sont autorisés dans une demande. Réduisez le nombre d’objets à cinq ou moins.
### Erreur : limite de 120 attributs dépassée
Jusqu’à 120 attributs sont autorisés dans un objet JSON, y compris les attributs JSON imbriqués. Supprimez de l’objet JSON certains attributs qui n’ont pas besoin d’être mappés.
![\[Jusqu’à 120 attributs sont autorisés dans un objet JSON, y compris les attributs JSON imbriqués. Supprimez de l’objet JSON certains attributs qui n’ont pas besoin d’être mappés.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### Avertissement : Nous n’avons pas trouvé de **clé unique** permettant de différencier vos données. Nous n’avons pas trouvé de **clé de profil** identifiant vos profils.
Le modèle n’a pas pu trouver de type d’objet valide à partir de l’objet donné. Modifiez l’entrée ou utilisez l’approche du mappage manuel, telle que suggérée.
![\[Le modèle n’a pas pu trouver de type d’objet valide à partir de l’objet donné. Modifiez l’entrée ou utilisez l’approche du mappage manuel, telle que suggérée.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)
# Limites de données des Profils des clients Amazon Connect
La fonctionnalité Profils des clients Amazon Connect vous permet de personnaliser l’intégration de vos données en définissant des limites d’ingestion de données pour différents types de données clients que vous utilisez pour créer un profil unifié. Définir des limites pour vos mappages de données vous permet de hiérarchiser la quantité de données à ingérer entre les mappages. La limite maximale par défaut pour tous les mappages par profil est de 1 000.
**Note**
Les limites des données sont des estimations et peuvent varier légèrement, avec un écart possible de quelques unités dans les deux sens pendant les périodes de forte ingestion sur un seul profil.
## Comment configurer les limites de données des Profils des clients
1. Ouvrez la console Amazon Connect Customer Profiles.
1. Choisissez l’onglet **Limites de données** pour configurer les limites des objets de données.
![\[Accédez à l’onglet Limites de données pour configurer les limites des objets de données.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. Passez le curseur sur la limite de l’objet de données souhaité et cliquez sur l’icône de modification.
![\[Passez le curseur sur la limite de l’objet de données souhaité et cliquez sur l’icône de modification.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. Entrez la limite et cochez l’icône en forme de coche pour enregistrer ou mettre à jour la limite.
![\[L’image montre une nouvelle limite en cours de saisie et met en évidence l’icône en forme de coche utilisée pour enregistrer ou mettre à jour votre limite.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## Comment effacer les limites de données des Profils des clients
1. Sélectionnez la case d’option correspondant à l’objet de données dont vous souhaitez effacer la limite. Vous pourrez ensuite choisir **Effacer la limite**.
![\[Met en évidence la case d’option situé à gauche de l’objet de données sur la page des limites de données. Sélectionner la case d’option vous permet d’activer le bouton Effacer pour définir une limite de données pour l’objet.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. Tapez *confirmer* pour effacer la valeur limite de l’objet de données que vous avez sélectionné.
![\[Une fenêtre contextuelle qui vous demande de confirmer que vous souhaitez effacer la valeur limite de l’objet de données. Vous confirmez l’action d’effacement en tapant « confirmer » en minuscules.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)
# Création et ingestion de données client dans Profils des clients
Vous pouvez définir les données provenant de n’importe quelle source à l’aide d’Amazon S3 et enrichir facilement un profil de client sans avoir besoin d’intégrations personnalisées ou prédéfinies. Supposons, par exemple, que vous souhaitiez fournir aux agents des informations pertinentes sur l’historique des achats. Vous pouvez importer les données des transactions d’achat depuis une application interne dans un fichier de feuille de calcul sur S3, puis les lier à un profil de client.
Pour effectuer cette configuration, vous devez définir un [mappage de type d’objet](customer-profiles-object-type-mapping.md) qui décrit à quoi ressemble l’objet de profil personnalisé. Ce mappage définit comment les champs de vos données peuvent être utilisés pour renseigner les champs du profil standard ou comment ils peuvent être utilisés pour attribuer les données à un profil spécifique.
Après avoir créé le mappage des types d'objets, vous pouvez utiliser l'[PutProfileObject](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html)API pour télécharger les données de profil personnalisées de votre CRM vers l'objet de profil personnalisé.
**Note**
La fonctionnalité Profils des clients ne prend pas en charge l’ingestion de données provenant d’en-têtes CSV contenant une notation par points.
Pour obtenir la liste des autorisations IAM requises pour que la fonctionnalité Profils des clients puisse accéder aux données du compartiment Amazon S3 à des fins de mappage des données, consultez `PutProfileObject` dans le tableau dans [Actions définies par Profils des clients Amazon Connect](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions).
## Ingestion Profils des clients
**Ingestion de profils basés sur des comptes**
1. Chargez les fichiers de données dans S3. L’ingestion des profils référencés dans les profils de compte et les profils de compte eux-mêmes doivent se faire séparément.
1. Le nouveau fichier utilisé pour l’ingestion des profils de compte doit inclure de nouveaux attributs : type de profil et préférences d’engagement pour le courrier électronique et le téléphone.
1. Ingérez des fichiers depuis S3 vers le Profil du client à l’aide de la console AWS
**Exemples de profils (référencés dans les profils basés sur les comptes suivants) CSV**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Exemples de profils basés sur des comptes CSV**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Exemple de préférences d’engagement par e-mail** :
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"}
]
```
**Exemple de préférences d’engagement par téléphone** :
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"}
]
```
**Note**
En effet **ProfileType**`PROFILE`, vous pouvez ingérer et ajouter des préférences d'engagement en utilisant la même méthode.
1. Créez deux mappages de données, l’un pour les sous-profils et l’autre pour les profils basés sur des comptes.
![\[Créez deux intégrations de sources de données qui créeront chacune un mappage basé sur la relation décrite. Par exemple, les comptes/profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png)
1. Puis, mappez les attributs du profil client. Notez la destination appelée `ProfileType`.
![\[Puis, mappez les attributs du profil client. Notez la destination appelée ProfileType.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png)
**Exemple de mappage de type d’objet pour l’ingestion de profils référencés dans des profils basés sur des comptes**
```
{
"AllowProfileCreation": true,
"Description": "Standard Profile Object Type",
"Fields": {
"FirstName": {
"ContentType": "STRING",
"Source": "_source.FirstName",
"Target": "_profile.FirstName"
},
"LastName": {
"ContentType": "STRING",
"Source": "_source.LastName",
"Target": "_profile.LastName"
},
"PhoneNumber": {
"ContentType": "PHONE_NUMBER",
"Source": "_source.PhoneNumber",
"Target": "_profile.PhoneNumber"
},
"PersonalEmailAddress": {
"ContentType": "EMAIL_ADDRESS",
"Source": "_source.PersonalEmailAddress",
"Target": "_profile.PersonalEmailAddress"
},
"State": {
"ContentType": "STRING",
"Source": "_source.State",
"Target": "_profile.Address.State"
},
"CustomerId": {
"ContentType": "STRING",
"Source": "_source.CustomerId",
"Target": "_profile.Attributes.CustomerId"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
}
},
"Keys": {
"CustomerId": [
{
"FieldNames": [
"CustomerId"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Répétez le processus pour ingérer des profils basés sur des comptes. Remarque : EngagementPreferences .Email et EngagementPreference .Phone.
![\[Répétez le processus pour ingérer des profils basés sur des comptes. Remarque : EngagementPreferences .Email et EngagementPreference .Phone.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png)
**Exemple de mappage de type d’objet pour l’ingestion de profils basés sur des comptes**
```
{
"AllowProfileCreation": true,
"Description": "Account-based profiles Object Type",
"Fields": {
"AccountNumber": {
"ContentType": "STRING",
"Source": "_source.AccountId",
"Target": "_profile.AccountNumber"
},
"PrimaryOwner": {
"ContentType": "STRING",
"Source": "_source.PrimaryOwner",
"Target": "_profile.Attributes.PrimaryOwner"
},
"SecondaryOwner": {
"ContentType": "STRING",
"Source": "_source.SecondaryOwner",
"Target": "_profile.Attributes.SecondaryOwner"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
},
"EmailEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.EmailEngagementPreferences",
"Target": "_profile.EngagementPreferences.Email"
},
"PhoneEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.PhoneEngagementPreferences",
"Target": "_profile.EngagementPreferences.Phone"
}
},
"Keys": {
"Account": [
{
"FieldNames": [
"AccountNumber"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Créez deux intégrations de sources de données qui créeront chacune un mappage basé sur la relation décrite. Par exemple, les comptes/profils.
**Note**
L'ingestion de profils basés sur des comptes ne doit avoir lieu qu'après avoir vérifié la réussite de l'ingestion des profils référencés dans les profils basés sur les comptes à l'aide de l'[SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API ou des métriques de profil dans la console Amazon Connect Customer Profiles.
Le mappage généré automatiquement ne fonctionne pas pour l’ingestion de profils basés sur des comptes et de leurs sous-profils.
La liste des préférences de contact par e-mail et par téléphone peut contenir soit `KeyName` et `KeyValue`, soit `ProfileId` pour référencer les profils enfants. `KeyName` doit être l’identifiant unique.
Les mises à jour des sous-profils ne mettent pas à jour les préférences d’engagement dans les profils basés sur des comptes. Les mises à jour doivent se faire par voie d’ingestion.
# Création d’une intégration Kinesis avec Profils des clients Amazon Connect
Les étapes suivantes décrivent le processus de diffusion d’objets depuis Amazon Kinesis Data Streams vers Profils des clients Amazon Connect. L’intégration comprend deux étapes principales :
1. Configurez un EventBridge canal pour diffuser les données de votre Kinesis Data Stream vers un EventBridge bus.
1. Configurez une intégration des données Customer Profiles avec votre flux de données Kinesis à l'aide du Pipe que vous avez créé EventBridge
## Étape 1 : Diffuser les données de Kinesis vers EventBridge
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)
1. Dans le volet de navigation, sélectionnez **Event Buses (Bus d’événements)**.
1. Choisissez **Create event bus (Créer un bus d’événement)**.
1. Dans la section **Détails du bus d’événements**, entrez un nom descriptif. Par exemple, `kinesis-to-customer-profiles`.
1. Choisissez **Créer**.
1. Accédez à la page détaillée du flux de données Kinesis.
1. Sélectionnez l'onglet **EventBridge Pipes**, puis sélectionnez **Connect Kinesis Data Stream to** Pipe.
1. Donnez un nom à votre EventBridge pipe.
1. Suivez l’assistant de configuration jusqu’à ce que vous atteigniez la page de **configuration de Target**.
1. Pour la cible, sélectionnez le bus d’événements créé à l’étape 1. Par exemple, `kinesis-to-customer-profiles`.
1. Après la section **Cible**, développez l’accordéon **Transformeur d’entrée cible**.
1. Configurez le transformeur d’entrée cible comme suit :
```
{
"data": <$.data>
}
```
1. Choisissez **Créer un canal** pour terminer la configuration.
À ce stade, vous avez correctement configuré le routage des événements Kinesis vers. EventBridge Ensuite, nous allons créer une intégration avec la fonctionnalité Profils des clients.
## Étape 2 : Ingérer les EventBridge données dans les profils des clients
1. Allez dans **Profils des clients** dans la console Amazon Connect.
1. Dans l’onglet **Intégrations de sources de données**, choisissez **Ajouter une intégration de source de données**.
1. Sélectionnez **Kinesis** dans la liste déroulante **Source de données**
1. Dans le menu déroulant **du nom du EventBridge canal**, sélectionnez le canal créé à l'étape 1 et choisissez **Next**.
1. Sur la page **Données de mappage**, sélectionnez le mappage de type d’objet approprié et choisissez **Suivant**.
1. Passez en revue votre configuration sur la page **Vérifier et intégrer**, puis choisissez **Ajouter une intégration de source de données** pour terminer la configuration.
Votre flux de données Kinesis est désormais intégré aux Profils des clients Amazon Connect, vous êtes désormais prêt à envoyer des événements depuis Kinesis aux Profils des clients.
# Exportez les données de votre profil client unifié
Amazon Connect Customer Profiles permet d'exporter des données en temps réel de profils clients unifiés vers un flux de données Amazon Kinesis. Vous pouvez activer la diffusion de données et recevoir automatiquement les données des nouveaux profils et les mises à jour des profils existants dans votre flux de données Amazon Kinesis Data Streams.
Vous pouvez conserver les données de vos systèmes sources, telles que CRMs les outils d'automatisation du marketing, up-to-date avec les dernières informations issues des profils Amazon Connect clients. Par exemple, lorsqu’un client appelle votre centre de contact pour mettre à jour son adresse, un agent peut effectuer la modification pour ajouter la nouvelle adresse du client et les informations de profil mises à jour sont envoyées à un flux de données Kinesis en temps réel.
Pour effectuer cette configuration, vous devez activer **Exportation de données** dans la console Profils des clients.
## Activation de l’exportation en temps réel
**Pour activer la diffusion de données pour votre domaine**
1. Ouvrez la console Amazon Connect Customer Profiles.
1. Sélectionnez l’onglet **Exportation de données**, puis choisissez **Activer la diffusion de données**.
![\[L’exportation de données en temps réel active le flux de données Kinesis.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. Choisissez **Activer la diffusion de données** et sélectionnez un flux de données Kinesis existant dans le menu déroulant, ou choisissez **Créer un flux de données Kinesis** pour ouvrir la console Kinesis et créer le flux. Pour plus d’informations, consultez [Création et gestion de flux](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
![\[L’exportation de données en temps réel active le flux de données Kinesis.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. Cliquez sur le bouton **Activer la diffusion de données** pour enregistrer vos paramètres.
## Désactivation de l’exportation en temps réel
**Pour désactiver la diffusion de données pour votre domaine**
1. Ouvrez la console Amazon Connect Customer Profiles.
1. Sélectionnez l’onglet **Exportation de données**, puis choisissez **Désactiver le flux de données**.
![\[L’exportation de données en temps réel désactive le flux de données Kinesis.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/disable-real-time-export-1.png)
## Exportation en temps réel des données utiles Kinesis
**Exemple d’événement de sortie dans un document JSON**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
La version actuelle du schéma.
**EventId**
L’ID unique de l’événement.
**EventTimestamp**
Horodatage de l'événement selon le ISO8601 standard.
**EventType**
Le type d’événement exporté.
Valeurs : CREATED, UPDATED, HEALTH\$1CHECK
+ CRÉÉ : L'événement d'exportation était pour CreateProfile.
+ MISE À JOUR : L'événement d'exportation était pour un UpdateProfile.
+ HEALTH\$1CHECK : L'événement d'exportation visait à s'assurer que les profils clients pouvaient être correctement intégrés dans `putEvent` Kinesis Stream. HealthCheck
**DomainName**
Le domaine auquel appartient l’événement. `/Domain` de l’événement
**ObjectTypeName**
Le type d’objet de l’événement
Valeurs : `_profile`, `_asset`, `_order`, `_case`. Vous pouvez également utiliser un nom de modèle prédéfini tel qu'`Salesforce-Account`un nom d'objet personnalisé que vous pouvez créer à l'aide de l'[ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
**AssociatedProfileId**
L’ID du profil standard auquel l’objet est associé. Il n’est présent que si le type d’objet n’est pas `_profile`
**ProfileObjectUniqueKey**
Identifiant unique du ProfileObject produit généré par le service.
Type : Chaîne
**Object**
Le profil standard ou l’objet de profil standard lui-même.
**IsMessageRealTime**
Indique si le message est en temps réel ou s’il a été redirigé.
**Exemple de données utiles dans un document JSON**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# Dépannage de l’exportation d’événements en temps réel vers votre flux de données Kinesis
Il se peut qu’il y ait un délai lors de la première exportation des événements vers votre flux de données Kinesis. Cela est dû au temps nécessaire pour propager les autorisations IAM pour le rôle lié au service. En cas de problème réel, le statut du streaming peut entrer dans un état d’erreur.
![\[Les événements ne parviennent pas à atteindre le flux de données Kinesis de destination, ce qui entre dans un état d’erreur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
Les sections suivantes présentent les éventuels messages d’erreur que vous pouvez rencontrer. Elles fournissent également la cause et la résolution de chaque problème.
## Erreur : le flux de données Kinesis n’est pas actif. Veuillez vérifier la configuration et recréer le flux d’événements ultérieurement
Le flux de données Kinesis de destination n’est pas dans un état `ACTIVE`. Cela peut se produire lors de la création ou de la suppression de votre flux de données Kinesis. Pour résoudre l’erreur, assurez-vous que votre flux de données Kinesis est dans un état ACTIVE et réactivez le paramètre de diffusion de données.
## Erreur : le flux de données Kinesis n’existe pas. Veuillez recréer le flux d’événements avec une destination de flux de données Kinesis valide
Le flux de données Kinesis de destination est supprimé. Pour résoudre l’erreur, réactivez la diffusion de données avec un flux de données Kinesis existant comme destination.
## Erreur : le flux de données Kinesis est limité. Veuillez envisager de fournir un débit Kinesis plus élevé de manière appropriée
Le flux de données Kinesis de destination est limité (sous-provisionné). Pour résoudre l’erreur, assurez-vous que le flux de données Kinesis de destination possède un nombre de partitions suffisant, puis réactivez la diffusion de données.
## Erreur : la clé KMS utilisée pour chiffrer le flux de données Kinesis est limitée. Veuillez envisager d’augmenter le quota de demandes KMS de manière appropriée
La clé KMS utilisée par le flux de données Kinesis est limitée. Pour résoudre cette erreur, réactivez la diffusion de données.
## Erreur : vérifiez la configuration de la clé KMS de votre flux de données Kinesis
La fonctionnalité Profils des clients ne peut pas accéder à la clé KMS utilisée par le flux de données Kinesis. Cela peut se produire lorsque votre clé KMS est dotée d’une stratégie de clé qui refuse l’accès au rôle lié au service Profils des clients ou lorsque la clé n’a pas le statut Activé. Pour résoudre l’erreur, assurez-vous que la stratégie de clé KMS ne refuse pas l’accès au rôle lié au service Profils des clients et que la clé a le statut Activé. Réactivez la diffusion de données pour résoudre cette erreur.
# Configurez l’exportation groupée pour toutes vos données de Profils des clients unifiées
**Note**
Pour suivre les étapes décrites dans cette rubrique, vous devez avoir des compétences de développeur et une expérience de l'utilisation d' AWS KMS Amazon S3.
Lorsque Profils des clients Amazon Connect crée un profil client unifié, il améliore, affine et améliore les données et informations brutes pour obtenir un profil plus précis en combinant des données provenant de sources internes et tierces. La fonctionnalité Profils des clients améliore également la qualité des jeux de données grâce à l’ajout de nouvelles données. Vous pouvez utiliser les jeux de données améliorés pour d’autres cas d’utilisation, par exemple pour formuler des stratégies de marketing, de vente et de service client plus informées et ciblées. Par exemple, vous pouvez tirer parti du profil client unifié pour :
+ Auditer les données clients dont vous disposez dans l’ensemble d’un domaine.
+ Effectuer des analyses internes, par exemple pour les rapports de vente et de marketing.
+ Exporter les données dans vos propres outils ou dans des produits tiers, afin de personnaliser les publicités et de cibler les clients.
Pour exploiter les données de profil client unifiées pour d’autres cas d’utilisation, vous pouvez les exporter en masse vers Amazon S3. Cette rubrique explique comment procéder.
**Topics**
+ [Étape 1 : configurer une clé KMS et le compartiment S3](#enable-cpbulk-export)
+ [Étape 2 : créer une tâche d’exportation groupée](#create-bulk-export-job)
+ [Étape 3 : vérifier le statut d’une tâche d’exportation en bloc](#check-status-bulk-cp-export)
+ [Étape 4 : afficher les données exportées dans S3](#view-bulk-cp-export)
+ [Mise à jour de la tâche d’exportation en bloc](#update-bulk-cp-export)
+ [Suppression ou annulation de la tâche d’exportation en bloc - non prise en charge](#delete-bulk-cp-export)
## Étape 1 : configurer une clé KMS et le compartiment S3
Pour activer l’exportation groupée pour votre domaine, vous devez configurer les ressources suivantes :
+ [Une clé KMS avec une politique de ressources spécifique](#cp-kms)
+ [Un compartiment S3 de destination avec une politique de ressources spécifique](#cp-s3-bulk). Ne configurez pas de [listes de contrôle d'accès (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) sur le compartiment.
Ces étapes sont expliquées ci-dessous.
### Création d’une nouvelle clé KMS ou réutilisation d’une clé KMS existante
Pour configurer une clé KMS pour l'exportation en masse, vous devez créer ou réutiliser une clé KMS existante qui se trouve dans la même AWS région que le compartiment Amazon S3 que vous prévoyez de configurer comme destination d'exportation en bloc. Vous devez autoriser le AppIntegrations service Amazon Connect à effectuer des actions KMS pour la clé.
Ajoutez la déclaration suivante à la **stratégie de clé**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Enable AppIntegrations access to KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root"
],
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### Configuration d’un compartiment Amazon S3
Vous devez configurer un compartiment nouveau ou existant dans la même AWS région que la clé KMS, et configurer une politique de ressources sur le compartiment S3.
Lors de la configuration du compartiment, assurez-vous de sélectionner **Chiffrement avec SSE-KMS** et d’utiliser la même clé KMS que lors de la procédure précédente. En outre, ne l'activez pas ACLs sur le compartiment S3.
Voici un exemple de stratégie de ressources.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow AppIntegrations to write data to destination bucket",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## Étape 2 : créer une tâche d’exportation groupée
Pour créer une tâche d'exportation groupée, vous devez appeler l'Amazon Connect suivant AppIntegrations APIs :
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): Cette API crée une intégration avec la source de données (par exemple, les profils clients).
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): cette API écrit les données vers la destination (par exemple, un compartiment S3) en utilisant la source de données.
Vous trouverez ci-dessous plus d'informations sur la façon de les appeler APIs.
### Création d’une intégration des données
Une intégration de données représente la *source de données* de vos données. Vous pouvez appeler l'[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API ou exécuter la commande [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI pour créer une intégration de données. Vous devez fournir un *type d’objet* Customer Profiles et un *domaine* Customer Profiles.
Si vous souhaitez exporter plusieurs types d’objets, vous devez créer une intégration de données distincte pour chacun d’entre eux. Par exemple, si vous souhaitez exporter les objets `_profile` et `_asset`, il est nécessaire de créer deux intégrations de données distinctes.
**Note**
Les données ingérées au cours des 30 dernières minutes peuvent ne pas être incluses dans l’exportation.
L'exemple de code suivant montre comment exécuter la commande [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI.
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "bulk-export-job-01" \
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \
--source-uri "AmazonConnect://AppIntegrations" \
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
```
L'exemple de code suivant montre comment appeler l'[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API.
```
{
"Description": "Data integration for _profile objects",
"KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
"Name": "unique-data-integration-name-01",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"my-domain-pdx"
],
"objectType": [
"_profile"
]
}
}
}
```
### Création d’une association d’intégration de données
Une association d’intégration de données représente la destination vers laquelle vous souhaitez exporter vos données et une plage de temps permettant de sélectionner les données à exporter. Vous pouvez appeler l'[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API ou exécuter la commande [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI pour créer une intégration de données. Vous pouvez configurer l’intervalle de temps à l’aide des propriétés `StartTime` et `EndTime`. Cette plage horaire correspond à la date de dernière mise à jour des objets dans Profils des clients.
Le compartiment S3 de destination que vous spécifiez peut être simplement le nom du compartiment, ou il peut inclure un cas supplémentaire ou un préfixe S3 dans lequel vous souhaitez que les données soient exportées.
**Note**
Pour le quota pour les **tâches d’exportation en bloc simultanées**, consultez [Amazon Connect Quotas de service relatifs aux profils clients](amazon-connect-service-limits.md#customer-profiles-quotas). Une fois qu’une tâche d’exportation en bloc est terminée ou échoue, elle n’est plus prise en compte dans le quota de simultanéité.
L'exemple de code suivant montre comment exécuter la commande [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI.
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
L'exemple de code suivant montre comment appeler l'[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API.
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## Étape 3 : vérifier le statut d’une tâche d’exportation en bloc
Pour consulter l'état de votre tâche d'exportation en bloc, vous pouvez appeler l'[ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API ou exécuter la commande [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
L'exemple de code suivant montre comment exécuter la commande [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"
```
## Étape 4 : afficher les données exportées dans S3
Lorsque l’association d’intégration des données est sur `IN_PROGRESS`, vous commencerez à voir les données copiées dans votre compartiment S3.
Les données exportées sont écrites selon la structure de chemin suivante :
+ \$1BucketNameAndFolderName\$1
+ \$1AwsAccountId\$1
+ \$1DomainName\$1
+ \$1RequestTimestamp\$1
+ \$1lStartTime\$1-\$1EndTime\$1
+ \$1ObjectTypeName\$1
+
Voici un exemple de chemin :
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## Mise à jour de la tâche d’exportation en bloc
Une fois le travail terminé, vous pouvez mettre à jour l’association d’intégration des données avec une heure de début et une heure de fin d’extraction des données différentes. Cela crée une nouvelle tâche d’exportation en masse. Cela peut être utile si vous avez déjà effectué une exportation en bloc et que vous souhaitez exporter uniquement les données mises à jour depuis l’exportation précédente. Par exemple, si votre dernière tâche d’exportation en masse remonte à trois mois, vous pouvez mettre à jour votre association d’intégration de données sur une période allant d’il y a 3 mois à aujourd’hui.
Vous pouvez appeler l'[UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API ou exécuter la commande [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI pour mettre à jour la tâche d'exportation.
L'exemple de code suivant montre comment exécuter la commande [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI.
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
## Suppression ou annulation de la tâche d’exportation en bloc - non prise en charge
Vous ne pouvez pas supprimer ou annuler l’exportation groupée. Une fois qu’une tâche d’exportation est terminée, elle n’est plus prise en compte dans votre quota d’exportation.
# Suppression d’un domaine de Profils des clients Amazon Connect
La suppression de mappages supprimera uniquement les objets et les données associés à ce mappage spécifique. Si plusieurs objets sont associés à un profil, la suppression d’un mappage spécifique risque de ne pas effacer les données du profil. Si vous souhaitez supprimer des données spécifiques, vous devez supprimer le mappage, mais vos profils peuvent toujours exister s’ils contiennent des données provenant d’autres mappages. Cela pourrait entraîner des frais supplémentaires pour les profils existants. Pour éviter cela, vous pouvez supprimer votre domaine Profils des clients à l’aide de la console Amazon Connect en suivant ces étapes.
1. Connectez-vous à la Amazon Connect console et sélectionnez Customer Profiles dans le volet de navigation de gauche. Choisissez votre domaine Profils des clients, puis **Afficher les détails**.
![\[La page Suppression d’un domaine Profils des clients Amazon Connect, le bouton Afficher les détails du domaine.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png)
1. Choisissez **Delete domain (Supprimer le domaine)**.
![\[La page Suppression d’un domaine Profils des clients Amazon Connect, le bouton Supprimer le domaine.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png)
1. Pour supprimer votre domaine, entrez *confirmer* dans le champ et choisissez **Supprimer un domaine**.
![\[La page Suppression d’un domaine Profils des clients Amazon Connect, le bouton de confirmation Supprimer le domaine après avoir saisi la confirmation manuellement.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png)
# Configuration des attributs calculés dans Profils des clients Amazon Connect
Les *attributs calculés* sont des valeurs dérivées d’autres attributs à l’aide de formules. Vous pouvez les utiliser pour identifier les comportements agrégés des utilisateurs.
Vous pouvez créer des attributs calculés pour définir votre propre logique métier afin de transformer les données de votre profil client en points de données exploitables. Cela vous permet de personnaliser les expériences automatisées telles que les réponses vocales interactives.
En utilisant des attributs calculés, vous pouvez identifier les principaux attributs relatifs au comportement passé de vos clients. Par exemple :
+ Le dernier site Web visité ou le dernier agent consulté
+ Modèles de comportement, tels que le canal préféré et la fréquence des contacts
+ Valeur client, telle que le nouveau client et le montant moyen des tickets
Vous pouvez utiliser l’API d’attributs calculés pour créer un nouvel attribut à l’aide d’opérations d’agrégation courantes telles que la moyenne, le nombre, le minimum, le maximum et la somme.
Les attributs calculés transforment automatiquement les données brutes en temps réel en points de données et en indicateurs exploitables. Les administrateurs du centre de contact sont en mesure de définir et de configurer des calculs en fonction des données brutes disponibles dans les profils des clients. Ces attributs calculés vous permettent de créer plus facilement des expériences automatisées telles que la réponse vocale interactive (IVR) ou les chatbots. Vous pouvez créer des expériences personnalisées et aider les agents à comprendre le contexte client plus rapidement.
Pour obtenir la liste des AWS régions dans lesquelles les attributs calculés APIs sont disponibles, voir[Disponibilité de l’API d’attributs calculés Profils des clients par région](regions.md#customerprofiles_calculatedattributesregion).
**Topics**
+ [Démarrer avec les attributs calculés](customerprofiles-calculated-attributes-admin-website.md)
+ [Attributs calculés APIs](customerprofiles-calculated-attributes-apis.md)
+ [Création d’une définition d’attribut calculée personnalisée](customerprofiles-calculated-attributes-creating-definition.md)
+ [Validation des valeurs d’attributs calculés](customerprofiles-calculated-attributes-validating-values.md)
+ [Attributs calculés par défaut](customerprofiles-default-calculated-attributes.md)
+ [Résolutions et messages d’erreur](customerprofiles-calculated-attributes-troubleshooting.md)
# Commencer à utiliser les attributs calculés dans les profils Amazon Connect clients
Utilisez des attributs calculés pour définir votre propre logique métier afin de transformer vos données de profil client en points de données exploitables pour personnaliser les expériences automatisées, telles que les réponses vocales interactives.
En utilisant des attributs calculés, vous pouvez identifier les attributs clés relatifs au comportement passé de vos clients, à leurs habitudes comportementales et à leur valeur client.
Les rubriques de cette section vous montrent comment créer, afficher, modifier et supprimer des attributs calculés.
**Topics**
+ [Création d’attributs calculés](calculated-attributes-admin-website-create.md)
+ [Configuration des filtres d’événement](calculated-attributes-admin-website-event-filters.md)
+ [Affichage des attributs calculés](calculated-attributes-admin-website-view.md)
+ [Modification des attributs calculés](calculated-attributes-admin-website-edit.md)
+ [Suppression d’attributs calculés](calculated-attributes-admin-website-delete.md)
# Création d’attributs calculés dans Amazon Connect
1. Conditions préalables : Assurez-vous de disposer des autorisations de profil de sécurité nécessaires. Pour de plus amples informations, veuillez consulter [Mise à jour des autorisations pour les attributs calculés dans Profils des clients Amazon Connect](security-profile-customer-profile-calc-attribs.md).
1. Sur le site Web de l' Amazon Connect administration, accédez à **Profils clients**, **Attributs calculés**, choisissez **Créer un attribut** dans la vue du tableau **des attributs calculés**.
![\[L’onglet Profils des clients dans l’espace de travail de l’agent, le bouton Associer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)
1. Pour créer un attribut calculé, attribuez un nom descriptif, ajoutez une description (facultative) avec des détails sur l’attribut et configurez les champs obligatoires :
+ **Calcul :** définit le mode de calcul des attributs (average/count/sum/minimum/first occurrence/last occurrence/maxoccurrence).
+ **Attribut :** point de données issu de vos données de profil client.
**Note**
Si vous sélectionnez un attribut à partir d'un type d'objet standard (`_asset``_case`,,`_order`), les attributs doivent être inclus PascalCase. Cela signifie que la première lettre de chaque mot du nom de l’attribut est en majuscule, par exemple `_case.CreatedBy` ou `_order.TotalPrice`.
![\[L’onglet Profils des clients dans l’espace de travail de l’agent, le bouton Associer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)
1. De plus, vous pouvez ajouter un autre attribut en sélectionnant l’icône *plus*. Vous pouvez choisir jusqu’à deux attributs pour les calculer et les combiner par un opérateur. Spécifiez un opérateur tel que *plus* ou *moins* pour combiner les valeurs d’attribut.
![\[L’onglet Profils des clients dans l’espace de travail de l’agent, le bouton Associer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)
1. Une fois le calcul sélectionné, vous pouvez éventuellement configurer le nombre d’événements, la période et l’horodatage de la source. Par défaut, les attributs calculés sont configurés pour utiliser un nombre illimité d’événements, une période illimitée et un horodatage basé sur la date d’ingestion.
Une sortie est renvoyée lorsqu’il y aura au moins un événement pendant la période spécifiée.
+ **Nombre d’événements :** configurez la limite ou utilisez un nombre illimité (par défaut)
+ **Période :** définissez une période spécifique ou utilisez une durée illimitée (par défaut)
+ **Horodatage de la source :** choisissez entre un champ d’horodatage spécifique ou une date d’ingestion (par défaut)
**Note**
Bien qu’il n’y ait pas de limite d’événements, il existe une limite de taille des données, les données les plus anciennes étant remplacées par les plus récentes. L’horodatage de la source ne peut pas être modifié après la création.
![\[L’onglet Profils des clients dans l’espace de travail de l’agent, le bouton Associer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)
1. Vous avez la possibilité de définir des critères afin de n’inclure que les événements pertinents dans les calculs. Pour plus d’informations, consultez [Configuration des filtres d’événement](calculated-attributes-admin-website-event-filters.md).
1. Choisissez **Créer** pour créer l’attribut calculé.
1. Une fois qu’un attribut calculé a été créé avec succès, une bannière s’affiche dans la vue tableau pour utiliser l’attribut calculé dans un segment ou un flux. Vous pourrez également consulter le statut des attributs calculés en fonction de leur état de préparation.
![\[Une bannière indiquant que l’attribut calculé a été créé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)
# Configuration des filtres d’événement
Les filtres d’événements vous permettent de filtrer les objets de profil à utiliser dans l’attribut calculé. Par exemple, un filtre d’événements peut filtrer les objets d’actifs standard du client afin que seuls les actifs dont le **Statut est installé OU enregistré** soient inclus dans le calcul.
**Note**
Vous ne pouvez pas modifier les filtres d’événements après avoir créé une définition d’attribut calculée.
Lorsque vous créez un attribut calculé, vous pouvez créer un ou plusieurs filtres d’événement. Un filtre d’événement se compose des éléments suivants :
![\[Composants du filtre d’événements.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)
+ **Groupes de filtres** : groupe de filtres que vous appliquez aux objets du profil. Vous pouvez ajouter plusieurs groupes de filtres connectés par des relations OU.
+ **Filtres** : filtre les objets de profil inclus dans le calcul de l’attribut calculé en spécifiant des attributs, des opérateurs et des valeurs. Vous pouvez ajouter autant de filtres que vous le souhaitez pour votre cas d’utilisation.
+ **Attribut** : attribut de l’objet à filtrer. Vous pouvez sélectionner des attributs à partir d’objets stockés dans le domaine Profils des clients ou utiliser les noms de champs définis dans la définition du type d’objet. Pour plus d’informations sur les mappages de types d’objets, consultez [Détails de la définition du mappage de type d’objet dans Profils des clients Amazon Connect](object-type-mapping-definition-details.md).
**Note**
Sur le site Web de l' Amazon Connect administrateur, la liste déroulante des attributs indique l'horodatage de la dernière fois qu'un objet de profil a été enregistré ou mis à jour avec l'attribut.
S’il existe à la fois un attribut d’un objet de profil et un champ d’un type d’objet portant le même nom, le filtre d’événements donne la priorité au nom du champ du type d’objet dans son filtrage. Par exemple, si un objet de profil possède un attribut nommé **Status** et qu’il existe également un champ de type d’objet nommé **Status**, le filtre utilisera le champ de type d’objet **Status** pour le filtrage.
+ **Opérateur** — L’opérateur détermine la relation entre l’attribut et la valeur que vous saisissez. Pour plus d'informations, voir [Opérateurs de filtre](#calculated-attributes-admin-website-event-filter-operators)
+ **Valeur** — Valeur à utiliser pour filtrer les objets. Vous pouvez spécifier plusieurs valeurs connectées par des relations OR. Par exemple, *Le statut de la ressource est installé ou enregistré*. Notez que les valeurs sont sensibles à la casse. Par exemple, *Le statut de la ressource est installé* renvoie des résultats différents de ceux de *Le statut de la ressource est installé*. Pour consulter les objets de profil, utilisez l'[ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API Amazon Connect Customer Profiles.
Vous pouvez éventuellement créer jusqu'à deux filtres d'événements et créer une relation (AND/OR/EXCLUDE) entre eux. Pour plus de détails sur la relation, voir[Relation entre les filtres d’événements](#calculated-attributes-admin-website-relationship-between-event-filters).
## Opérateurs de filtre
Les opérateurs déterminent la relation entre l’attribut et une valeur que vous entrez. Le tableau suivant présente les opérateurs disponibles.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)
**Note**
Les attributs calculés sur le site Web Amazon Connect d'administration utilisent le fuseau horaire UTC et l'heure par défaut de 00:00:00 UTC pour tous les filtres basés sur le temps. Vous pouvez filtrer par date, mais les heures sont enregistrées avec la même valeur. Si vous entrez la date du 01/01/2024, la console transmet l’heure au format 2024-01-01T00:00:00Z.
**Note**
Par défaut, les filtres d’événements sont évalués lorsqu’un objet de profil est enregistré ou mis à jour. Par exemple, si vous filtrez des objets de ressources standards dont la date `PurchaseDate` se situe dans la semaine écoulée, le temps relatif est calculé comme étant *la semaine écoulée à compter du moment où l’objet de ressource a été enregistré ou mis à jour*. Cela signifie que les résultats du filtrage peuvent varier en fonction du moment où l’objet est enregistré ou mis à jour.
## Relation entre les filtres d’événements
Vous pouvez éventuellement ajouter le deuxième filtre d’événements et définir une relation avec le premier filtre d’événements. Lorsque vous créez un attribut calculé sur le site Web d’administration Amazon Connect , vous pouvez avoir un maximum de deux filtres d’événements par attribut calculé. Si vous ajoutez le deuxième filtre d’événement à votre attribut calculé, vous pouvez choisir l’une des deux façons de spécifier la manière dont les deux filtres d’événements sont connectés :
+ **Relation ET** : si vous utilisez la relation ET pour connecter deux filtres d’événements, les objets répondant à la fois au premier et au deuxième filtre d’événement seront inclus dans le calcul.
+ **Relation OU** : si vous utilisez la relation OU pour connecter deux filtres d’événements, les objets répondant au premier ou au deuxième filtre d’événement seront inclus dans le calcul.
+ **Relation EXCLURE** : si vous utilisez la relation EXCLURE pour connecter deux filtres d’événements, les objets répondant au premier filtre d’événement mais non au second seront inclus dans le calcul.
## Étapes suivantes
+ [Utilisez votre attribut calculé dans votre centre de contact via l’éditeur Flow](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes)
+ [Utilisez votre attribut calculé pour définir un segment client](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+ [Affichage des attributs calculés dans Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html)
+ [Modification des attributs calculés dans Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html)
+ [Suppression d’attributs calculés dans Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html)
# Affichage des attributs calculés dans Amazon Connect
1. Connectez-vous au site Web d' Amazon Connect administration à l'adresse https ://*instance name*.my.connect.aws/. Utilisez un compte d’administration ou un compte attribué à un profil de sécurité disposant de l’autorisation **Profils des clients - Attributs calculés**.
1. Dans Amazon Connect, dans le volet de navigation de gauche, choisissez **Profils des clients**, **Attributs calculés**.
1. Sur la page **Attributs calculés**, choisissez un attribut calculé dans la colonne **Nom** du tableau.
L’image suivante illustre un exemple d’attributs calculés répertoriés dans la colonne **Nom**.
![\[Tableau répertoriant les attributs calculés.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)
1. Vous êtes maintenant en mesure d’afficher les détails de l’attribut que vous avez sélectionné. L’image suivante présente une page de détails pour un attribut calculé.
![\[Vue détaillée d’un attribut calculé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)
# Modification des attributs calculés dans Amazon Connect
1. Pour modifier un attribut calculé, choisissez un attribut dans la vue de la table en sélectionnant la case d’option, qui active le bouton **Modifier**. Choisissez **Modifier**.
![\[modifier un attribut calculé\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)
1. Vous pouvez modifier la **Description**, la **Période** et le **Nombre d’événements**. Choisissez **Save (Enregistrer)** lorsque vous avez terminé.
![\[Modifiez un attribut calculé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)
# Suppression d’attributs calculés dans Amazon Connect
1. Pour supprimer un attribut calculé, choisissez un attribut dans la table en sélectionnant la case d’option située à côté de l’attribut que vous souhaitez supprimer.
1. Une fois sélectionné, choisissez **Supprimer**.
1. Dans la fenêtre contextuelle **Supprimer l’attribut**, vérifiez les détails et entrez *confirmer* pour activer le bouton **Supprimer**.
![\[Supprimez un attribut calculé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)
1. Sélectionnez **Delete (Supprimer)**.
# Attributs calculés des profils clients Amazon Connect APIs
Vous pouvez utiliser l'attribut calculé des profils clients suivant APIs
------
#### [ CreateCalculatedAttributeDefinition ]
**CreateCalculatedAttributeDefinition**
Créez un nouvel attribut calculé. Cela nécessite un type d’objet existant dans le domaine. Vous pouvez définir les attributs que vous souhaitez extraire d’un seul objet source et les opérations mathématiques à leur appliquer de manière agrégée, ainsi que la plage de temps et le nombre d’objets.
Après la création, les nouvelles données d’objet ingérées dans Profils des clients seront incluses dans l’attribut calculé, qui peut être récupéré pour un profil à l’aide de l’API `GetCalculatedAttributeForProfile`. Pour utiliser également les données historiques, spécifiez `UseHistoricalData` comme étant vrai. Les champs `Readiness` et `Status` de la réponse de l’API fourniront des informations concernant le statut de l’inclusion des données historiques dans l’attribut calculé.
La définition d’un attribut calculé le rend disponible pour tous les profils d’un domaine. Chaque attribut calculé ne peut référencer qu'un seul champ ObjectType et au plus deux à partir de celui-ci ObjectType.
**Demande**
```
POST /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
```
**Réponse**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Corps de la demande**
+ **CalculatedAttributeName**
Le nom unique (par domaine) de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **DisplayName**
Le nom d’affichage de l’attribut calculé.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obligatoire : non
+ **Description**
La description de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1 000 caractères.
+ Obligatoire : non
+ **UseHistoricalData**
Si les données historiques ingérées avant la création de l’attribut calculé doivent être incluses dans les calculs.
+ Type : Boolean
+ Obligatoire : non
+ **AttributeDetails**
Les détails des attributs utilisés dans la définition et des opérations mathématiques impliquées entre les attributs. Consultez les composants suivants :
+ **Attributs**
Une liste des éléments d’attribut spécifiés dans l’expression mathématique.
+ **AttributeItem**
Les détails d’un élément d’attribut unique spécifié dans l’expression mathématique.
+ Nom
+ Le nom d’un attribut défini dans un type d’objet de profil.
+ Type : String
+ **Expression**
L’expression mathématique exécutée sur les éléments d’attribut fournis dans la liste d’attributs. Chaque élément de l'expression doit suivre la structure de \$1 "\$1ObjectTypeName. AttributeName\$1 \$1 ».
+ Exemple : `{ObjA.AttributeA} - {ObjA.AttributeB}`
+ Type : String
+ Nous prenons uniquement en charge les opérations mathématiques suivantes : `+ - * /`
+ Vous ne pouvez pas modifier l’expression une fois qu’une définition d’attribut calculée est créée
+ **Conditions**
Définit les critères et seuils d’agrégation d’attributs calculés.
+ Type : objet Conditions
+ Range
+ ObjectCount
+ Threshold
+ **Range**
La période relative pendant laquelle les données sont incluses dans l’agrégation.
+ Type : objet Range
+ Valeur : durée des unités spécifiées. `ValueRange` écrase Value.
+ Type : Integer
+ Obligatoire : non
+ ValueRange: structure permettant aux clients de spécifier une fenêtre temporelle relative sur laquelle les données sont incluses dans l'attribut calculé. Utilisez des nombres positifs pour indiquer que le point final est dans le passé, et des nombres négatifs pour indiquer qu'il se trouve dans le futur. ValueRangeremplace la valeur.
+ Type : ValueRange
+ Obligatoire : non
+ Démarrer
+ Heure de début à laquelle les objets doivent être inclus. Utilisez des nombres positifs pour indiquer que le point de départ est dans le passé, et des nombres négatifs pour indiquer qu’il se trouve dans le futur.
+ Type : Integer
+ Obligatoire : oui
+ Fin
+ Heure finale à laquelle les objets doivent être inclus. Utilisez des nombres positifs pour indiquer que le point de départ est dans le passé, et des nombres négatifs pour indiquer qu’il se trouve dans le futur.
+ Type : Integer
+ Obligatoire : oui
+ TimestampSource: expression spécifiant le champ de votre objet JSON à partir duquel la date doit être analysée. L'expression doit suivre la structure de \$1 "\$1ObjectTypeName. \$1 \$1 ». Par exemple, si votre type d'objet est MyType et que la source JSON l'est`{"generatedAt": {"timestamp": "1737587945945"}}`, cela TimestampSource devrait être le cas`"{MyType.generatedAt.timestamp}"`.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 255 caractères.
+ Obligatoire : non
+ TimestampFormat: le format du champ d'horodatage de votre objet JSON est spécifié. Cette valeur doit être EPOCHMILLI (pour les horodatages d'époque Unix avec précision de second/millisecond niveau) ou ISO\$18601 (suivant le format ISO\$18601 avec précision de niveau, avec un décalage facultatif de Z ou au format second/millisecond HH:MM ou HHMM.). Par exemple, si votre type d'objet est MyType et que la source JSON l'est`{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},`, alors cela TimestampFormat devrait être le cas`"ISO_8601"`.
+ Unité : unité de temps
+ Valeurs valides : jours
+ Obligatoire : oui
+ Obligatoire : oui
+ Portée initiale : 366 jours maximum
+ **ObjectCount**
Le nombre d’objets de profil utilisés pour l’attribut calculé.
+ Type : Number
+ Plage : 1 à 100
+ Obligatoire : non
+ **Threshold**
La logique de comparaison pour générer un attribut true/false calculé.
+ Type : objet Threshold
+ Value
+ La valeur du seuil
+ Type : String
+ Obligatoire : non
+ Opérateur
+ L’opérateur du seuil
+ Type : ENUM
+ Valeurs valides :
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obligatoire : non
+ **Statistique**
L’opération d’agrégation à effectuer pour l’attribut calculé.
+ Type : ENUM
+ Valeurs valides :
+ FIRST\$1OCCURRENCE
+ LAST\$1OCCURRENCE
+ COUNT
+ SUM
+ MINIMUM
+ MAXIMUM
+ AVERAGE
+ MAX\$1OCCURRENCE
------
#### [ UpdateCalculatedAttributeDefinition ]
**UpdateCalculatedAttributeDefinition**
Mettez à jour une définition d’attribut calculée. Les mises à jour sont limitées au nom d’affichage, à la description, à la plage de temps, au nombre d’objets et au seuil. Cette API prend en charge les mises à jour partielles, de sorte que seuls les paramètres nécessitant une mise à jour doivent être inclus.
**Note**
Lors de la mise à jour des conditions :
L’augmentation de la plage de dates d’un attribut calculé ne déclenchera pas l’inclusion de données historiques supérieures à la plage de dates actuelle.
TimestampSource et TimestampFormat ne peut pas être mis à jour une fois qu'une définition d'attribut calculée a été créée.
**Demande**
```
PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"DisplayName": "string",
"Description": "string",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
}
}
```
**Réponse**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Corps de la demande**
+ **DisplayName**
Le nom d’affichage de l’attribut calculé.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obligatoire : non
+ **Description**
La description de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1 000 caractères.
+ Obligatoire : non
+ **Conditions**
Définit les critères et seuils d’agrégation d’attributs calculés.
+ Type : objet Conditions
+ Range
+ ObjectCount
+ Threshold
+ **Range**
La période relative pendant laquelle les données sont incluses dans l’agrégation.
+ Type : objet Range
+ Valeur : durée des unités spécifiées
+ Type : Integer
+ Obligatoire : non
+ ValueRange: structure permettant aux clients de spécifier une fenêtre temporelle relative sur laquelle les données sont incluses dans l'attribut calculé. Utilisez des nombres positifs pour indiquer que le point final est dans le passé, et des nombres négatifs pour indiquer qu'il se trouve dans le futur. ValueRangeremplace la valeur.
+ Type : ValueRange
+ Obligatoire : non
+ Démarrer
+ Heure de début à laquelle les objets doivent être inclus. Utilisez des nombres positifs pour indiquer que le point de départ est dans le passé, et des nombres négatifs pour indiquer qu’il se trouve dans le futur.
+ Type : Integer
+ Obligatoire : oui
+ Fin
+ Heure finale à laquelle les objets doivent être inclus. Utilisez des nombres positifs pour indiquer que le point de départ est dans le passé, et des nombres négatifs pour indiquer qu’il se trouve dans le futur.
+ Type : Integer
+ Obligatoire : oui
+ Unité : unité de temps
+ Valeurs valides : jours
+ Obligatoire : oui
+ Obligatoire : oui
+ Portée initiale : 366 jours maximum
+ **ObjectCount**
Le nombre d’objets de profil utilisés pour l’attribut calculé.
+ Type : Number
+ Plage : 1 à 100
+ Obligatoire : non
+ **Threshold**
La logique de comparaison pour générer un attribut true/false calculé.
+ Type : objet Threshold
+ Value
+ La valeur du seuil
+ Type : String
+ Obligatoire : non
+ Opérateur
+ L’opérateur du seuil
+ Type : ENUM
+ Valeurs valides :
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obligatoire : non
------
#### [ GetCalculatedAttributeDefinition ]
**GetCalculatedAttributeDefinition**
Récupérez une définition d’attribut calculée.
**Demande**
```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Corps de la demande**
```
The request does not have a request body.
```
**Réponse**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Unit": "string",
"Value": number
"ValueRange"
{
"Start": number
"End": number
},
"TimestampFormat": "string",
"TimestampSource": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"UseHistoricalData" boolean,
"Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED",
"Readiness": {
"ProgressPercentage": number,
"Message": "string",
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Paramètres de demande URI**
+ **DomainName**
Nom unique du domaine.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **CalculatedAttributeName**
Le nom unique (par domaine) de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
------
#### [ DeleteCalculatedAttributeDefinition ]
**DeleteCalculatedAttributeDefinition**
Supprimez une définition d’attribut calculé existante. Notez que la suppression d’un attribut calculé par défaut est possible, mais une fois supprimé, vous ne pourrez plus annuler cette action et vous devrez le recréer vous-même à l’aide de l’API `CreateCalculatedAttributeDefinition` si vous souhaitez le récupérer.
**Demande**
```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Corps de la demande**
```
The request does not have a request body.
```
**Réponse**
```
The response does not have a response body.
```
**Paramètres de demande URI**
+ **DomainName**
Nom unique du domaine.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **CalculatedAttributeName**
Le nom unique (par domaine) de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
------
#### [ ListCalculatedAttributeDefinitions ]
**ListCalculatedAttributeDefinitions**
Récupérez toutes les définitions d’attributs calculées pour un domaine.
**Demande**
```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Corps de la demande**
```
The request does not have a request body.
```
**Réponse**
```
{
"Items": [
{
"UseHistoricalData": boolean,
"ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED,
"CalculatedAttributeName": "string",
"CreatedAt": number,
"Description": "string",
"DisplayName": "string",
"LastUpdatedAt": number,
"Tags": {
"string" : "string"
}
}
],
"NextToken": "string"
}
```
**Paramètres de demande URI**
+ **DomainName**
Nom unique du domaine.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **MaxResults**
Le nombre maximum d’objets renvoyés par page.
+ Plage valide : valeur minimum de 1. Valeur maximale de 100
+ **NextToken**
Le jeton de pagination issu de l'appel ListCalculatedAttributeDefinition d'API précédent.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1 024 caractères
------
#### [ GetCalculatedAttributeForProfile ]
**GetCalculatedAttributeForProfile**
Lance le calcul et récupère le résultat d’un seul attribut calculé pour un seul profil.
**Demande**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```
**Corps de la demande**
```
The request does not have a request body.
```
**Réponse**
```
{
"Name": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial": "string",
"LastObjectTimestamp" : number
}
```
**Paramètres de demande URI**
+ **DomainName**
Nom unique du domaine.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **CalculatedAttributeName**
Le nom unique (par domaine) de l’attribut calculé.
+ Type : String
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
------
#### [ ListCalculatedAttributesForProfile ]
**ListCalculatedAttributesForProfile**
Lance le calcul et récupère les résultats de tous les attributs calculés pour un seul profil.
**Demande**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Corps de la demande**
```
The request does not have a request body.
```
**Réponse**
```
{
"Items": [
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial" : "string",
"LastObjectTimestamp" : number
},
...
],
"NextToken": "string"
}
```
**Paramètres de demande URI**
+ **DomainName**
Nom unique du domaine.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 64 caractères.
+ Modèle : `^[a-zA-Z0-9_-]+$`
+ Obligatoire : oui
+ **ProfileId**
+ Modèle : `[a-f0-9]{32}`
+ Obligatoire : oui
+ **MaxResults**
Le nombre maximum d’objets renvoyés par page.
+ Plage valide : valeur minimum de 1. Valeur maximale de 100
+ **NextToken**
Le jeton de pagination issu de l'appel ListCalculatedAttributeDefinition d'API précédent.
+ Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1 024 caractères
------
# Création d’une définition d’attribut calculée personnalisée pour Profils des clients Amazon Connect
À l'aide de l'[CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API Customer Profiles, vous pouvez créer par programmation votre propre attribut calculé en fonction d'un type d'objet personnalisé.
Dans cette rubrique, nous expliquons comment créer un attribut calculé à l’aide d’un fichier JSON personnalisé.
## Étape 1 : créer un fichier JSON
Créez un fichier JSON avec le contenu suivant :
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"UseHistoricalData": true,
"DisplayName": "your-display-name",
"Description": "your-description",
"AttributeDetails": {
"Attributes": [
{
"Name": "your-attribute-name"
}
],
"Expression": "{your-object-type.your-attribute-name}"
},
"Statistic": "your-statistic",
"Conditions": {
"Range": {
"ValueRange"
{
"Start": your-range-start
"End": your-range-end
},
"TimestampSource": "{your-object-type.your-timestamp-source}",
"Unit": "days"
},
"ObjectCount": your-object-count,
"Threshold": {
"Value": "your-threshold-value",
"Operator": "your-threshold-operator"
}
}
}
```
Pour personnaliser le fichier JSON avec vos propres valeurs, suivez les instructions suivantes :
+ **Attributes** : il doit contenir le nom du champ de votre type d’objet que vous souhaitez utiliser pour l’attribut calculé. Deux attributs référencés dans cette liste sont pris en charge.
+ **Expression** : les expressions mathématiques de base à exécuter entre les attributs sont prises en charge. Si vous n’avez qu’un seul attribut, ce champ doit être `{ObjectTypeName.AttributeName}`. Sinon, si vous avez une expression mathématique en tête, ce champ doit contenir les deux attributs.
+ **Statistique** : il s'agit de l'opération effectuée lorsque vous appelez l'un des calculateurs APIs qui effectue réellement l'opération d'agrégation. La plupart sont explicites, mais nous avons ajouté des explications pour celles qui ne le sont pas.
**Statistiques prises en charge**
+ `FIRST_OCCURRENCE` renvoie l’attribut spécifié dans l’expression du premier objet ingéré.
+ `LAST_OCCURRENCE` renvoie l’attribut spécifié dans l’expression du dernier objet ingéré.
+ `COUNT` renvoie le nombre à partir des données sélectionnées.
+ `SUM` renvoie la somme à partir des données sélectionnées.
+ `MINIMUM` renvoie le minimum à partir des données sélectionnées.
+ `MAXIMUM` renvoie le maximum à partir des données sélectionnées.
+ `AVERAGE` renvoie la moyenne à partir des données sélectionnées.
+ `MAX_OCCURRENCE` renvoie la valeur la plus fréquente spécifiée dans l’expression.
+ **Gamme** :
+ Unités : Actuellement, seules les unités DAYS sont prises en charge.
+ ValueRange: Spécifiez des nombres positifs dans les champs ValueRange de début ou de fin pour indiquer le nombre de jours à partir desquels commencer, et des nombres négatifs pour indiquer le nombre de jours à partir desquels commencer dans le futur.
+ TimestampSource: expression spécifiant le champ de votre objet JSON à partir duquel la date doit être analysée. L'expression doit suivre la structure de \$1 "\$1ObjectTypeName. \$1 \$1 ». Par exemple, si votre type d'objet est MyType et que la source JSON l'est`{"generatedAt": {"timestamp": "1737587945945"}}`, cela TimestampSource devrait être le cas`"{MyType.generatedAt.timestamp}"`.
+ **ObjectCount**: indique le nombre d'objets sur lesquels le calcul de l'attribut calculé doit être basé.
+ **Threshold** : si, au lieu de la valeur d’attribut calculée exacte, vous souhaitez savoir si elle est supérieure à une certaine valeur, par exemple, vous pouvez utiliser un seuil.
La valeur de seuil peut être n’importe quelle chaîne et les opérateurs de seuil suivants sont pris en charge.
+ `GREATER_THAN`
+ `LESS_THAN`
+ `EQUAL_TO`
+ `NOT_EQUAL_TO`
+ UseHistoricalData: Si les données historiques ingérées avant la création de l'attribut calculé doivent être incluses dans les calculs.
## Étape 2 : appeler l' CreateCalculatedAttributeDefinition API
Après avoir créé et personnalisé le fichier JSON avec vos valeurs, appelez l'[CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API, comme indiqué dans l'exemple suivant :
```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```
Vous pouvez également utiliser le point de terminaison suivant :
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```
# Validez les valeurs d'attribut calculées dans les profils clients Amazon Connect à l'aide de APIs
Il y en a deux APIs`ListCalculatedAttributesForProfile`, `GetCalculatedAttributeForProfile` et cela se situe au niveau du profil.
+ **GetCalculatedAttributeForProfile**- récupère un seul attribut calculé pour un seul profil.
+ **ListCalculatedAttributesForProfile**- récupère une liste d'attributs calculés pour un seul profil
Avec un ID de profil valide, vous devriez voir les valeurs de vos attributs calculés :
**Exemple de réponse**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"IsDataPartial": "true",
"Value": "24144"
}
```
**IsDataPartial**- Ce drapeau signifie que l'intervalle de temps (30 jours) ou le nombre d'objets n'ont pas été atteints et que l'attribut calculé est donc toujours en cours de calcul. Par exemple, si vous souhaitez obtenir une moyenne sur 30 jours, ce n’est qu’au bout de 30 jours que le champ `IsDataPartial` sera défini sur false.
## Récupération d’une liste d’attributs calculés
**Utiliser la AWS CLI**
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```
**Utiliser la AWS CLI avec un fichier JSON personnalisé**
Créez un fichier JSON avec le contenu suivant :
```
{
"DomainName": "your-domain-name",
"ProfileId" "some-profile-id"
}
```
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Point de terminaison :**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```
## Récupération d’un seul attribut calculé
**Utilisez la AWS CLI** :
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id
```
**Utilisez la AWS CLI avec un fichier JSON personnalisé** :
Créez un fichier JSON avec le contenu suivant :
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"ProfileId" "your-profile-id"
}
```
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Point de terminaison :**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```
# Attributs calculés par défaut dans Profils des clients Amazon Connect
## Attributs calculés CTR par défaut
Amazon Connect Customer Profiles fournit aux out-of-the boîtes des attributs par défaut basés sur les enregistrements des contacts. Les attributs sont les suivants :
**Canal le plus fréquent**
```
{
"CalculatedAttributeName": "_most_frequent_channel",
"DisplayName": "Most frequent channel",
"Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Dernier canal**
```
{
"CalculatedAttributeName": "_last_channel",
"DisplayName": "Last channel",
"Description": "Returns customer's last communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Identifiant du dernier agent**
```
{
"CalculatedAttributeName": "_last_agent_id",
"DisplayName": "Last agent identifier",
"Description": "Returns identifier of the last agent customer connected with.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.id"
}
],
"Expression": "{CTR.agent.id}"
},
"Tags": {
}
}
```
**Appelant fréquent**
```
{
"CalculatedAttributeName": "_frequent_caller",
"DisplayName": "Frequent caller",
"Description": "Returns true or false based on the number of times a customer has called.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "COUNT",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": {
"Value": "5",
"Operator": "GREATER_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "contactId"
}
],
"Expression": "{CTR.contactId}"
},
"Tags": {
}
}
```
**Temps d’attente moyen**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"Description": "Returns customer's average hold time for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Tags": {
}
}
```
**Durée moyenne des appels**
```
{
"CalculatedAttributeName": "_average_call_duration",
"DisplayName": "Average call duration",
"Description": "Returns customer's average call duration for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "disconnectTimestamp"
},
{
"Name": "initiationTimestamp"
}
],
"Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}"
},
"Tags": {
}
}
```
**Durée d’attente maximale du client**
```
{
"CalculatedAttributeName": "_maximum_hold_time",
"DisplayName": "Customer's maximum hold time",
"Description": "Returns customer's maximum hold time for voice calls in the past month.",
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Statistic": "MAXIMUM",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Attributs calculés de profils par défaut
Amazon Connect Customer Profiles fournit un attribut par défaut de out-of-the boîte basé sur un profil. Les attributs sont les suivants :
**Nouveau client**
```
{
"CalculatedAttributeName": "_new_customer",
"DisplayName": "New customer",
"Description": "Returns true or false for new customer profiles created.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "TIME_DIFFERENCE_FROM_NOW",
"Conditions": {
"ObjectCount": null,
"Threshold": {
"Value": "30",
"Operator": "LESS_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "createdAt"
}
],
"Expression": "{_profile.createdAt}"
},
"Tags": {
}
}
```
## Attributs calculés de ressources par défaut
Amazon Connect Customer Profiles fournit des attributs par défaut aux out-of-the boîtes en fonction des actifs. Les attributs sont les suivants :
**Nombre de ressources**
```
{
"CalculatedAttributeName": "_assets_count",
"DisplayName": "Count of assets",
"Description": "Returns the count of assets for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetId"
}
],
"Expression": "{_asset.AssetId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Date d’achat de la première ressource**
```
{
"CalculatedAttributeName": "_asset_first_occurrence",
"DisplayName": "First asset purchased date",
"Description": "Returns purchase date of the customer's first asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Date d’achat de la dernière ressource**
```
{
"CalculatedAttributeName": "_asset_last_occurrence",
"DisplayName": "Last asset purchased date",
"Description": "Returns purchase date of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Prix total des ressources**
```
{
"CalculatedAttributeName": "_assets_price_sum",
"DisplayName": "Total asset price",
"Description": "Returns customer's total asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "SUM",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Prix moyen des ressources**
```
{
"CalculatedAttributeName": "_assets_price_average",
"DisplayName": "Average asset price",
"Description": "Returns customer's average asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nom de la première ressource**
```
{
"CalculatedAttributeName": "_assets_name_first_occurrence",
"DisplayName": "First asset name",
"Description": "Returns name of the customer's first asset",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nom de la dernière ressource**
```
{
"CalculatedAttributeName": "_assets_name_last_occurrence",
"DisplayName": "Last asset name",
"Description": "Returns name of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Attributs calculés de cas par défaut
Amazon Connect Customer Profiles fournit des attributs par défaut aux out-of-the boîtes en fonction des cas. Les attributs sont les suivants :
**Nombre de cas**
```
{
"CalculatedAttributeName": "_cases_count",
"DisplayName": "Count of cases",
"Description": "Returns the count of customer's cases for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Date de création du premier cas**
```
{
"CalculatedAttributeName": "_case_first_occurrence",
"DisplayName": "First case created date",
"Description": "Returns created date of the customer's first case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Date de création du dernier cas**
```
{
"CalculatedAttributeName": "_case_last_occurrence",
"DisplayName": "Last case created date",
"Description": "Returns created date of the customer's last case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nombre de cas ouverts**
```
{
"CalculatedAttributeName": "_cases_open_status_count",
"DisplayName": "Count of open cases",
"Description": "Returns the count of customer's open cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Nombre de cas clôturés**
```
{
"CalculatedAttributeName": "_cases_closed_status_count",
"DisplayName": "Count of closed cases",
"Description": "Returns the count of customer's closed cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Closed"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Attributs calculés d’enregistrements de communication par défaut
Amazon Connect Customer Profiles fournit des attributs par défaut aux out-of-the boîtes en fonction des enregistrements de communication. Les attributs sont les suivants :
**Date d’ouverture du dernier e-mail**
```
{
"CalculatedAttributeName": "_campaign_email_last_open",
"DisplayName": "Last email open date",
"Description": "Returns the last email open date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.Open.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.Open.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Nombre d’e-mails ouverts**
```
{
"CalculatedAttributeName": "_campaign_email_open_count",
"DisplayName": "Email open count",
"Description": "Returns the number of times emails were opened by a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Nombre d’envois d’e-mails**
```
{
"CalculatedAttributeName": "_campaign_email_delivery_count",
"DisplayName": "Email delivery count",
"Description": "Returns the number of times emails were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Delivery.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Delivery"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Nombre de SMS envoyés**
```
{
"CalculatedAttributeName": "_campaign_sms_delivery_count",
"DisplayName": "SMS delivered count",
"Description": "Returns the number of times SMS were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_DELIVERED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_DELIVERED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Date du dernier SMS bloqué**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop",
"DisplayName": "Last SMS blocked date",
"Description": "Returns the last SMS blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Date du dernier opérateur SMS bloqué**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop_carrier",
"DisplayName": "Last SMS carrier blocked date",
"Description": "Returns the last SMS carrier blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_CARRIER_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_CARRIER_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Attributs calculés de commandes par défaut
Amazon Connect Customer Profiles fournit des attributs par défaut aux out-of-the boîtes en fonction des commandes. Les attributs sont les suivants :
**Nombre de commandes**
```
{
"CalculatedAttributeName": "_orders_count",
"DisplayName": "Count of orders",
"Description": "Returns the count of orders for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "OrderId"
}
],
"Expression": "{_order.OrderId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Date de création de la première commande**
```
{
"CalculatedAttributeName": "_order_first_occurrence",
"DisplayName": "First order created date",
"Description": "Returns created date of the customer's first order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Date de création de la dernière commande**
```
{
"CalculatedAttributeName": "_order_last_occurrence",
"DisplayName": "Last order created date",
"Description": "Returns created date of the customer's last order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Prix total de toutes les commandes**
```
{
"CalculatedAttributeName": "_orders_total_price_sum",
"DisplayName": "Total price of all orders",
"Description": "Returns sum of total price for all customer's orders.",
"Statistic": "SUM",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Moyenne des commandes par rapport au prix total**
```
{
"CalculatedAttributeName": "_orders_total_price_average",
"DisplayName": "Orders average of total price",
"Description": "Returns average of total price for all customer's orders.",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
# Messages d’erreur et résolutions pour les attributs calculés des Profils des clients Amazon Connect
Le tableau suivant indique les messages d’erreur des attributs calculés, la cause et la résolution de chaque erreur.
| Message d’erreur | Cause | Résolution |
| --- | --- | --- |
| La récupération d’un attribut calculé pour un profil affiche une valeur null | Cela est probablement dû au fait que l’attribut calculé ne contient pas de données. Après la création d’un attribut calculé, de nouvelles données doivent être ingérées. | Ingérez de nouvelles données ou réingérez d'anciennes données via les intégrations ou le et. CreateProfile PutProfileObject APIs |
# Configuration des segments clients dans Profils des clients Amazon Connect
Un *segment client* est un groupe de profils de clients qui partagent certains attributs. Par exemple, un segment client peut contenir l’ensemble de vos clients qui résident dans une ville donnée ou tous les clients qui appellent fréquemment et dont les dépenses moyennes sont supérieures à 500 dollars. Avec Amazon Connect les campagnes sortantes, vous pouvez envoyer des campagnes à un segment de clientèle.
Les segments clients sont évalués dynamiquement en fonction des attributs que vous définissez et peuvent changer au fil du temps lorsque la valeur des attributs change. Par exemple, si vous ajoutez de nouveaux profils au domaine Profils des clients, ou si vous modifiez ou supprimez des profils existants, le nombre de profils de ce segment client peut augmenter ou diminuer. Pour plus d’informations sur la création d’un segment client, consultez [Création de segments clients dans Amazon Connect](customer-segments-building-segments.md).
Comme condition préalable à la création de segments Amazon Connect, votre administrateur doit configurer votre domaine dans l'AWS Management Console et configurer les intégrations pour intégrer les données de profil, de commande, d'actif et de and/or dossier dans les profils clients. Pour de plus amples informations, veuillez consulter [Activez les profils clients pour votre instance Amazon Connect.](enable-customer-profiles.md). L’activation des intégrations de données vous permettra de continuer à générer vos segments dynamiques en fonction des nouvelles données arrivant sur votre domaine.
Les segments clients contiennent uniquement les profils des clients de votre domaine Profils des clients Amazon Connect. Les profils des clients peuvent être ingérés depuis S3 ou des applications externes, ou créés via l’application d’agent, les flux de contacts ou l’API. Pour plus d’informations sur les profils des clients, consultez [Qu’est-ce qu’un profil de client dans Amazon Connect ?](customer-profiles-what-data.md).
**Topics**
+ [Création de segments clients](customer-segments-building-segments.md)
+ [Gestion des segments](customer-segments-managing-segments.md)
+ [Création de segments à partir de fichiers importés](customer-segments-imported-files.md)
+ [Exportation des segments vers un fichier CSV](customer-segments-exporting-segments.md)
+ [Utilisation de l’assistant d’IA de segmentation](customer-segments-ai-assistant.md)
+ [Résolution des problèmes](customer-segments-troubleshooting.md)
# Création de segments clients dans Amazon Connect
**Note**
**La segmentation basée sur SQL (version bêta) nécessite l'activation du magasin de données. Rendez-vous sur l'écran de la page d'accueil des profils clients et activez le stockage des données dans le bandeau bleu supérieur**
**Note**
Pour accéder à l'expérience du générateur de segmentation sur le site Web Amazon Connect d'administration, vous devez disposer d'autorisations relatives aux profils de sécurité pour cette fonctionnalité. Pour de plus amples informations, veuillez consulter [Attribution d’autorisations de profil de sécurité pour gérer les segments clients](security-profile-customer-profile-segmentation.md).
Avant de créer des segments, nous vous recommandons d’intégrer les données de configuration de votre domaine Profils des clients pour remplir les profils de votre domaine Profils des clients. Pour plus d’informations sur la configuration des intégrations de données avec Profils des clients, consultez [Intégration d’applications externes à la fonctionnalité Profils des clients Amazon Connect](integrate-external-apps-customer-profiles.md).
Les segments peuvent inclure des événements que vous avez capturés à l’aide d’attributs calculés. Pour plus d’informations sur la façon de configurer des attributs calculés personnalisés et pour consulter les offres des Profils des clients sur les attributs calculés par défaut, consultez [Configuration des attributs calculés dans Profils des clients Amazon Connect](customerprofiles-calculated-attributes.md).
Amazon Connect propose deux méthodes pour créer des segments de clientèle : 1/ Définissez des segments via Spark SQL (version bêta ; nécessite l'activation du magasin de données) ; 2/ Définissez des segments via des groupes d'audience et des filtres (segmentation classique). Dans les deux cas, vous pouvez utiliser des instructions en langage naturel via l'assistant Segment AI alimenté par l'IA générative. Si vous définissez des segments de l'une des manières, vous déplacez ce segment vers l'autre et vous devez recommencer.
## Segments alimentés par Spark SQL
Les segments optimisés par Spark SQL vous permettent d'utiliser des données complètes de profil client et des fonctionnalités étendues pour définir des segments. Vous pouvez utiliser des attributs d'objet de profil standard et des attributs d'objet personnalisés. Vous pouvez également utiliser des fonctionnalités basées sur SQL, telles que la jonction d'objets standard et personnalisés pour utiliser les données de différents objets, le filtrage des segments à l'aide de statistiques telles que les percentiles et la standardisation des champs de date pour effectuer des comparaisons.
Vous pouvez commencer par saisir une invite en langage naturel dans Segment Assistant AI. L'assistant Segment AI définira le segment, y compris sa traduction dans Spark SQL. Segment Assistant AI indiquera les étapes à suivre pour définir le segment et vous pourrez valider qu'il correspond à ce que vous vouliez créer. Vous pouvez également consulter le code SQL, les étapes du SQL en langage naturel et un résumé du code SQL Spark généré par l'IA pour faciliter la validation. Si vous souhaitez apporter des modifications, vous pouvez mettre à jour votre invite en langage naturel ou apporter des modifications directement au SQL Spark.
Vous avez également la possibilité de créer directement le segment Spark SQL.
**À l'instar de la segmentation classique, les segments alimentés par Spark SQL peuvent être utilisés dans les appels d'adhésion aux segments, les blocs de flux et les campagnes sortantes.**
**Lorsque vous utilisez un segment Spark SQL dans un appel d'adhésion à un segment, un blocage de flux ou une campagne sortante initiée par un événement client, il utilise le dernier segment exporté (instantané du segment). L'instantané du segment utilisé pour l'adhésion expire un an après sa création. Si vous recevez une erreur 4XX, assurez-vous d'avoir exporté le segment (instantané du segment).**
**Les campagnes sortantes lancées par un segment de clientèle ne nécessitent pas que vous exportiez le segment (instantané du segment).**
### Étape 1 : créer un segment
Dans l'assistant Segment AI, sélectionnez « Comment créer un segment » pour obtenir des conseils supplémentaires sur la création de segments intéressants ou « Je souhaite générer un segment » pour saisir une invite en langage naturel pour créer le segment.
Vous pouvez également utiliser SQL pour définir un nouveau segment dans l'éditeur de requêtes.
**Remarque : si vous souhaitez créer une campagne sortante basée sur le fuseau horaire, vous devez vous assurer que l'attribut timezone fait partie de la sortie du segment**
**Remarque : si vous souhaitez utiliser le segment dans des campagnes sortantes, vous devez vous assurer que le profil indiqué IDs dans le résultat du segment est unique**
### Étape 2 : définir un nom et une description
Pour Nom, entrez un nom de segment qui soit facilement identifiable ultérieurement.
**Remarque -** Le site Web d'administration Amazon Connect utilise le nom saisi comme nom `DisplayName` du segment et génère un identifiant basé sur celui-ci. L'identifiant généré est utilisé `SegmentDefinitionName` lorsque vous accédez au segment à l'aide des profils clients APIs.
Pour Description, saisissez éventuellement une description pour le segment client.
### Étape 3 : Vérifiez et validez le segment
Passez en revue les données utilisées par l'assistant Segment AI et les étapes suivies par le modèle d'IA pour générer votre segment. Vous pouvez également consulter le code SQL qu'il a créé pour définir le segment dans l'éditeur de requêtes. S'il n'a pas été en mesure de créer le segment, répondez aux commentaires qu'il a fournis pour l'aider à créer un segment précis. Une fois qu'un segment a été généré, Customer Profiles créera automatiquement une estimation du segment pour vous.
Si vous souhaitez apporter des modifications, vous pouvez fournir une nouvelle invite en cliquant sur « Nouvelle conversation » ou sur create/edit SQL dans l'éditeur de requêtes.
Si vous n'utilisez pas l'assistant Segment AI, vous pouvez valider la requête et créer l'estimation en cliquant sur le bouton « Valider et estimer la requête » sous l'éditeur de requêtes.
**Remarque : les segments alimentés par Spark SQL peuvent prendre du temps en fonction de la quantité de données de profil que vous utilisez dans le segment et du code SQL utilisé, comme c'est le cas pour les autres moteurs de requêtes (par exemple, les jointures multiples entre objets prennent du temps).**
### Étape 4 : Création d'un segment
Une fois que vous avez créé un segment et que vous êtes satisfait, sélectionnez le bouton « Créer un segment » en haut à droite. Une fois le segment créé, vous pouvez sélectionner Actions : exporter au format .csv, utiliser le segment dans Flows et utiliser le segment dans les campagnes sortantes.
**Remarque : si vous utilisez le segment dans des campagnes sortantes ou des blocs de flux, l'appartenance au segment sera vérifiée en fonction de la date de dernière création du segment. Si vous avez besoin de vérifier l'appartenance aux segments en temps réel pendant l'exécution du flux ou de la campagne, utilisez la segmentation classique.**
## Segmentation classique avec groupes d'audience et filtres
Lorsque vous créez un segment client, vous choisissez les publics de départ et vous affinez ces publics en choisissant les filtres qui définissent le segment. Par exemple, vous pouvez créer un groupe de publics, puis choisir un filtre de tous les clients qui vivent dans un pays spécifique et qui appellent fréquemment. Les segments sont recalculés à la demande, par exemple lors de l’exécution de la campagne, de l’exécution du flux de contacts et de l’estimation ou de l’exportation des segments. En conséquence, la taille et la composition de chaque segment changent au fil du temps.
En outre, vous pouvez créer un deuxième groupe de publics, puis créer une relation (ET, OU ou EXCLURE) entre les deux groupes de publics pour affiner, concaténer ou exclure les clients du premier groupe de publics.
![\[Deux groupes de publics.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-building-segments-1.png)
## Groupes de publics
Lorsque vous créez un segment client, vous créez un ou plusieurs groupes de publics. Un groupe de publics est constitué des composants suivants :
![\[Schéma conceptuel montrant les composantes des groupes de publics.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-audience-groups-1.png)
+ **Publics de départ** : segments client qui définissent la population d’utilisateurs initiale. Vous pouvez spécifier jusqu’à 5 publics de départ, ou tous les profils de votre domaine Profils des clients.
+ **Groupes de filtres** : catégories d’informations de public que vous appliquez au-dessus des publics de départ. Vous pouvez ajouter plusieurs groupes de filtres connectés par des relations OU.
+ **Filtres** : les filtres réduisent le nombre de publics appartenant au segment. Vous pouvez ajouter autant de filtres que vous le souhaitez afin d’adapter le segment à vos besoins.
Un segment de clientèle doit comporter au moins un groupe d'audience, mais vous pouvez éventuellement créer un deuxième groupe d'audience, puis créer une relation (AND/OR/EXCLUDE) entre les deux groupes d'audience. Consultez [Étape 5 : ajouter le deuxième groupe de publics (facultatif)](#step-5-add-the-second-audience-group-optional) pour plus de détails sur la relation.
## Création d’un segment client
Les étapes suivantes décrivent la création et la configuration d’un segment client :
+ Étape 1 : créer un segment
+ Étape 2 : configurer le nom et la description
+ Étape 3 : choisir les publics de départ à inclure dans le groupe de publics 1
+ Étape 4 : choisir et configurer les groupes de filtres (facultatif)
+ Étape 5 : ajouter un groupe de publics 2 (facultatif)
### Étape 1 : créer un segment
1. Pour créer un segment, assurez-vous d’avoir créé des autorisations des profils de sécurité comme condition préalable. Pour plus d’informations, consultez [Attribution d’autorisations de profil de sécurité pour gérer les segments clients](security-profile-customer-profile-segmentation.md). En outre, pour mieux visualiser les membres de votre segment, nous vous recommandons l’ingestion de données avant de créer le segment. Pour ingérer des profils via S3 ou des applications externes, consultez [Création et ingestion de données client dans Profils des clients](customer-profiles-object-type-mappings.md) ou [Intégration d’applications externes à la fonctionnalité Profils des clients Amazon Connect](integrate-external-apps-customer-profiles.md).
1. Choisissez **Créer un segment** dans la vue du tableau des Segments clients.
![\[Le bouton Créer un segment.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png)
### Étape 2 : définir un nom et une description
+ Pour **Nom**, entrez un nom de segment qui soit facilement identifiable ultérieurement.
**Note**
Le site Web de l' Amazon Connect administrateur utilise le nom saisi comme nom `DisplayName` du segment et génère un identifiant basé sur celui-ci. L'identifiant généré est utilisé `SegmentDefinitionName` lorsque vous accédez au segment à l'aide des profils clients APIs.
+ Pour **Description**, saisissez éventuellement une description pour le segment client.
![\[Section Nom du segment.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png)
### Étape 3 : choisir les publics de départ à inclure dans le groupe de publics 1
Vous allez d’abord choisir la manière dont vous souhaitez définir les publics de départ pour le groupe de publics.
1. Sous **Groupe de publics 1**, dans la liste déroulante **Public initial**, sélectionnez un ou plusieurs segments à inclure dans le groupe de publics, ou choisissez **Tous les profils dans Profils des clients**.
**Note**
Lorsque vous choisissez plusieurs segments comme public de départ, les segments sont liés par des relations `OR`. Par exemple, si vous choisissez les segments **Clients abonnés Premium** et **Clients abonnés Basic** comme public de départ, tous les profils appartenant à l’un ou l’autre de ces segments seront inclus.
![\[Liste déroulante du public initial.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png)
1. Pour créer un segment avec ProfileType, commencez par utiliser **All Accounts from Customer Profiles** comme audience initiale. Cette approche vous permet de filtrer efficacement les profils basés sur les comptes. Il est important de noter que, sauf indication contraire de votre part, le processus de segmentation exportera automatiquement tous les profils du domaine des Profils des clients. Ce comportement par défaut garantit une couverture complète mais peut être ajusté pour répondre à des besoins de ciblage spécifiques.
Voici un exemple de la façon dont une définition de segment peut être créée (basée sur des comptes ou des profils standard) :
**Filtre tous les profils basés sur un compte (=ACCOUNT\$1PROFILE) ProfileType**
![\[Filtre tous les profils basés sur le compte (ProfileType=ACCOUNT_PROFILE).\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png)
**Note**
Pour créer un segment uniquement avec des sous-profils, créez un nouveau public qui exclut les profils basés sur des comptes. Par exemple, les profils dont `ProfileType` est PROFILE ou bien dont `ProfileType` est vide.
![\[Pour créer un segment uniquement avec des sous-profils, créez un nouveau public qui exclut les profils basés sur des comptes.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png)
**Exemple de campagne qui cible les comptes à contacter en utilisant `Phone`**
![\[Exemple de campagne qui cible les comptes à contacter en utilisant Phone\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png)
Dans cet exemple, la campagne cible un seul compte avec la séquence d’appels suivante :
1. Premières tentatives pour joindre John (ID : 2)
1. Si John ne répond pas, il appelle Sally (ID : 3) comme contact de secours
1. Une fois que vous avez choisi un public de départ, la section **Public estimé** est mis à jour pour afficher les profils éligibles. Une fois que vous avez modifié les groupes de publics, vous pouvez cliquer sur le bouton **Actualiser** dans la section Public estimé pour récupérer l’estimation.
![\[Une section consacrée au public estimé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png)
### Étape 4 : choisir et appliquer des filtres de public (facultatif)
Après avoir choisi vos publics de départ, vous pouvez affiner les publics en appliquant une logique conditionnelle aux attributs. Les segments prennent en charge les attributs de profils standards, les attributs de profils personnalisés et les attributs calculés.
![\[Filtres de public.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png)
**Pour choisir et configurer les filtres de public**
1. Pour **Attribut**, vous pouvez choisir un attribut parmi les types suivants
1. **Attributs calculés** - filtrez le public en fonction de l’un des attributs calculés.
Consultez [Configuration des attributs calculés dans Profils des clients Amazon Connect](customerprofiles-calculated-attributes.md) pour en savoir plus sur les attributs calculés par défaut et comment configurer des attributs calculés personnalisés.
1. **Attributs standard** - filtrez l’audience en fonction de l’un de ses attributs de profils standards.
Consultez [Définition de profil standard dans Profils des clients Amazon Connect](standard-profile-definition.md) la liste des attributs de profils standards.
1. **Attributs personnalisés** - filtrez le public en fonction de l’un des attributs de profils personnalisés.
**Note**
Nous stockons jusqu’à 1 000 attributs de profil les plus récents au sein du domaine. Si votre domaine contient un grand nombre d’attributs, il est possible que les attributs les plus anciens ne soient pas affichés dans cette liste.
1. Choisissez l’**Opérateur**. Les opérateurs déterminent la relation entre l’attribut et une valeur que vous entrez. Les opérateurs disponibles sont décrits ci-dessous. Les opérateurs disponibles changent en fonction du type de valeur de l’attribut que vous avez sélectionné.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/customer-segments-building-segments.html)
**Note**
Les segments clients du site Web Amazon Connect d'administration utilisent le fuseau horaire UTC et l'heure par défaut de 00:00:00 UTC pour tous les filtres basés sur l'heure. Vous pouvez filtrer par date, mais les heures sont enregistrées avec la même valeur. Si vous entrez la date du 01/01/2024, la console transmet l’heure au format 2024-01-01T00:00:00Z.
**Note**
Lorsque vous spécifiez un filtre pour un attribut calculé, vous pouvez remplacer la période de définition de l’attribut calculé. Par exemple, le filtre `Frequent caller is true for the event time period of 60 days` remplacera l’*Appelant fréquent* [Attributs calculés par défaut dans Profils des clients Amazon Connect](customerprofiles-default-calculated-attributes.md) pour évaluer la valeur au cours des 60 derniers jours au lieu de la [période configurée dans la définition de l’attribut calculé](customerprofiles-calculated-attributes-apis.md). Ce remplacement est spécifique au segment et n’affecte pas la définition de l’attribut calculé elle-même.
![\[Attribut, opérateur et valeur à évaluer.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png)
1. Spécifiez la valeur. Vous pouvez spécifier plusieurs valeurs connectées par des relations `OR`. Par exemple, `Address.Country` est `USA` ou `Mexico`. La valeur saisie affiche des suggestions dans la liste déroulante pour les opérateurs de chaînes en fonction des profils des clients stockés dans le domaine.
**Note**
Les valeurs sont sensibles à la casse. Par exemple, *Address.Country est USA* renvoie des résultats différents de *Address.Country est usa*.
1. (Facultatif) Pour appliquer des attributs supplémentaires à ce groupe de filtres, choisissez **\$1 Filtre**. Pour créer un autre groupe de filtres, choisissez **\$1 Groupe**.
**Note**
Lorsque vous avez plusieurs filtres dans un groupe de filtres, les filtres sont connectés par des relations ET. Par exemple, un groupe de filtres contenant 2 filtres, « *Address.Country* est USA » et « Le *Temps d’attente moyen du client* est supérieur à 10 secondes », les profils dont l’*adresse.country* est USA **et** le *temps d’attente moyen* est supérieur à 10 secondes appartiendront au segment.
Lorsque vous avez plusieurs groupes de filtres dans un groupe d'audience, les segments clients du site Web Amazon Connect d'administration utilisent les relations OR pour établir des liens entre les groupes de filtres.
![\[Deux filtres de public.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png)
1. Après avoir fini de configurer le groupe de publics, sélectionnez **Créer un segment**.
### Étape 5 : ajouter le deuxième groupe de publics (facultatif)
Ajoutez éventuellement le deuxième groupe de publics et définissez une relation avec le groupe de publics 1. Lorsque vous créez un segment client à l’aide du site Web d’administration Amazon Connect , vous pouvez avoir un maximum de deux groupes de publics par segment. Si vous ajoutez un deuxième groupe de publics à votre segment, vous pouvez choisir l’une des deux façons de spécifier la manière dont les deux groupes de publics sont connectés :
+ **Relation ET** — Si vous utilisez la relation ET pour connecter deux publics, votre segment contient tous les profils qui répondent aux filtres du groupe de publics 1 et du groupe de publics 2.
+ **Relation OU** : si vous utilisez la relation OU pour connecter deux publics, votre segment contient tous les profils qui répondent aux filtres du groupe de publics 1 ou du groupe de publics 2.
+ **Relation EXCLURE** : si vous utilisez la relation EXCLURE pour connecter deux publics, le segment contiendra les profils du groupe de publics 1, à l’exception des profils du groupe de publics 2.
**Pour configurer le deuxième groupe de publics**
1. Sélectionnez la relation **ET**, **OU** ou **EXCLURE** après avoir configuré le groupe de publics 1.
![\[Les options ET, OU ou EXCLURE.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png)
1. Choisissez le public de départ dans le groupe de publics 2. Pour référence, voir[Étape 3 : choisir les publics de départ à inclure dans le groupe de publics 1](#step-3-choose-the-starting-audiences-to-include-in-audience-group).
1. (Facultatif) Choisissez les filtres selon lesquels vous souhaitez affiner vos segments. Pour référence, voir [Étape 4 : choisir et appliquer des filtres de public (facultatif)](#step-4-choose-and-apply-audience-filters-optional)
1. Lorsque vous avez fini de configurer le segment, choisissez **Create segment** (Créer un segment). Le segment est créé et vous pouvez désormais l’utiliser dans des campagnes ou des flux sortants.
![\[Message indiquant que le segment a bien été créé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png)
## Création de segments optimisés par Spark SQL
Les segments optimisés par Spark SQL vous permettent d'utiliser des données complètes de profil client et des fonctionnalités étendues pour définir des segments. Vous pouvez utiliser des attributs d'objet de profil standard et des attributs d'objet personnalisés. Vous pouvez également utiliser des fonctionnalités basées sur SQL, telles que la jonction d'objets standard et personnalisés pour utiliser les données de différents objets, le filtrage des segments à l'aide de statistiques telles que les percentiles et la standardisation des champs de date pour effectuer des comparaisons.
Vous pouvez commencer par saisir une invite en langage naturel dans Segment Assistant AI. L'assistant Segment AI définira le segment, y compris sa traduction dans Spark SQL. Segment Assistant AI indiquera les étapes à suivre pour définir le segment et vous pourrez valider qu'il correspond à ce que vous vouliez créer. Vous pouvez également consulter le code SQL, les étapes du SQL en langage naturel et un résumé du code SQL Spark généré par l'IA pour faciliter la validation. Si vous souhaitez apporter des modifications, vous pouvez mettre à jour votre invite en langage naturel ou apporter des modifications directement au SQL Spark.
Vous avez également la possibilité de créer directement le segment Spark SQL.
Les segments alimentés par Spark SQL peuvent être utilisés dans les appels d'adhésion aux segments, les blocs de flux et les campagnes sortantes. Ils vérifient le segment depuis sa dernière création (capture instantanée du segment). Si vous recevez une erreur 4XX, vous devrez exécuter l'instantané du segment.
**Note**
**La segmentation SQL s'exécute sur un magasin de données contenant des données d'une durée maximale de 10 ans. La segmentation classique utilise les données les plus récentes (données mises à jour au cours des 3 dernières années)**
### Étape 1 : créer un segment
Dans l'assistant Segment AI, sélectionnez « Comment créer un segment » pour obtenir des conseils supplémentaires sur la création de segments intéressants ou « Je souhaite générer un segment » pour saisir une invite en langage naturel pour créer le segment.
Vous pouvez également utiliser SQL pour définir un nouveau segment dans l'éditeur de requêtes.
### Étape 2 : définir un nom et une description
Pour Nom, entrez un nom de segment qui soit facilement identifiable ultérieurement.
**Note**
Le site Web d'administration Amazon Connect utilise le nom saisi comme nom `DisplayName` du segment et génère un identifiant basé sur celui-ci. L'identifiant généré est utilisé `SegmentDefinitionName` lorsque vous accédez au segment à l'aide des profils clients APIs.
Pour Description, saisissez éventuellement une description pour le segment client.
### Étape 3 : Vérifiez et validez le segment
Passez en revue les données utilisées par l'assistant Segment AI et les étapes suivies par le modèle d'IA pour générer votre segment. Vous pouvez également consulter le code SQL qu'il a créé pour définir le segment dans l'éditeur de requêtes. S'il n'a pas été en mesure de créer le segment, répondez aux commentaires qu'il a fournis pour l'aider à créer un segment précis. Une fois qu'un segment a été généré, Customer Profiles créera automatiquement une estimation du segment pour vous.
Si vous souhaitez apporter des modifications, vous pouvez fournir une nouvelle invite en cliquant sur « Nouvelle conversation » ou sur create/edit SQL dans l'éditeur de requêtes.
Si vous n'utilisez pas l'assistant Segment AI, vous pouvez valider la requête et créer l'estimation en cliquant sur le bouton « Valider et estimer la requête » situé sous l'éditeur de requêtes.
**Note**
Les segments alimentés par Spark SQL prennent du temps en fonction de la quantité de données de profil que vous utilisez dans le segment et du code SQL utilisé, comme c'est le cas pour les autres moteurs de requête (par exemple, les jointures multiples entre objets prennent généralement plus de temps).
### Étape 4 : Création d'un segment
Une fois que vous avez créé un segment et que vous êtes satisfait, sélectionnez le bouton « Créer un segment » en haut à droite. Une fois le segment créé, vous pouvez sélectionner Actions : exporter au format .csv, utiliser le segment dans Flows et utiliser le segment dans les campagnes sortantes.
**Note**
Si vous utilisez le segment dans des campagnes sortantes ou des blocs de flux, l'appartenance au segment sera vérifiée en fonction de la date de dernière création du segment. Si vous avez besoin de vérifier l'appartenance aux segments en temps réel pendant l'exécution du flux ou de la campagne, utilisez la segmentation classique.
# Gestion des segments clients dans Amazon Connect
Vous pouvez utiliser le site Web d’administration Amazon Connect pour créer, afficher, copier et exécuter d’autres tâches de gestion pour des segments clients. Si vous ouvrez un segment client pour afficher ses paramètres, vous pouvez également créer rapidement une campagne qui utilise ce segment. Pour plus d’informations sur la création de segments, consultez [Création de segments clients dans Amazon Connect](customer-segments-building-segments.md) dans le Guide du développeur Amazon Connect .
**Pour gérer les segments clients**
1. Sur la page **Segments clients**, accédez au segment que vous souhaitez gérer ou sélectionnez une action.
![\[La page Segments clients, une liste de segments.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-managing-segments-1.png)
1. Dans le menu **Actions**, les options suivantes sont disponibles :
1. **Afficher les détails** — Choisissez cette option pour afficher des informations sur le segment de clientèle, notamment la date et l'heure de création du segment, ainsi que la date et l'heure de dernière mise à jour du segment. L'utilisateur Amazon Connect a besoin de l'autorisation du profil de sécurité **CustomerProfiles.Segments.View** pour effectuer cette action.
1. **Dupliquer** — sélectionnez cette option pour créer un nouveau segment client qui est une copie du segment sélectionné. Vous pouvez ensuite modifier les paramètres dans le nouveau segment, sans modifier le segment d’origine. L' Amazon Connect utilisateur doit disposer de l'autorisation de profil de sécurité **CustomerProfiles.Segments.Create** pour effectuer cette action.
1. **Exporter CSV** — choisissez cette option pour exporter le segment client vers un fichier sur votre ordinateur. Pour plus d'informations, consultez[Exportation des segments clients vers un fichier CSV dans Amazon Connect](customer-segments-exporting-segments.md). L' Amazon Connect utilisateur doit disposer de l'autorisation du profil de sécurité **CustomerProfiles.Segments.Export** pour effectuer cette action.
1. **Supprimer** — choisissez cette option pour supprimer définitivement le segment client. Vous ne pouvez pas récupérer un segment après l'avoir supprimé. L' Amazon Connect utilisateur doit disposer de l'autorisation du profil de sécurité **CustomerProfiles.Segments.Delete** pour effectuer cette action.
**Important**
Si vous supprimez un segment, toutes les campagnes actives qui utilisent ce segment échouent. De même, tous les segments créés au-dessus du segment cesseront de fonctionner. Avant de supprimer un segment, il est conseillé de vérifier au préalable que celui-ci n’est pas utilisé par une campagne active ou d’autres segments.
# Création de segments à partir de fichiers importés dans Amazon Connect
**Note**
Pour accéder à l'expérience du générateur de segmentation sur le site Web Amazon Connect d'administration, assurez-vous que les autorisations des profils de sécurité appropriées sont configurées. Pour de plus amples informations, veuillez consulter [Attribution d’autorisations de profil de sécurité pour gérer les segments clients](security-profile-customer-profile-segmentation.md).
L’importation de segments clients utilise un fichier CSV contenant des données de profil pour créer de nouveaux profils ou mettre à jour les profils existants, qui sont ensuite regroupés dans un segment. Le fichier CSV doit avoir une taille inférieure à 1 Go et inclure des en-têtes valides correspondant aux attributs de profil standard.
Les étapes suivantes décrivent la création et la configuration d’un segment client importé :
1. [Création d’un segment](#create-new-segment)
1. [Chargement d’un fichier CSV](#upload-csv-file)
1. [Configuration des détails du segment](#configure-segment-details)
1. [Mappage des attributs des clients](#map-customer-attributes)
1. [Définition de l’expiration de profil](#set-profile-expiry)
1. [Création et surveillance de l’importation de segments](#create-monitor-segment-import)
## Création d’un segment
1. Pour créer un segment, assurez-vous d’avoir créé des autorisations des profils de sécurité comme condition préalable. Pour de plus amples informations, veuillez consulter [Attribution d’autorisations de profil de sécurité pour gérer les segments clients](security-profile-customer-profile-segmentation.md).
1. Sur le site Web Amazon Connect d'administration, accédez à **Profils clients** et **segments de clients**
1. Choisissez **Créer un segment**, puis sélectionnez **À partir du téléchargement de fichier** dans la liste déroulante
## Chargement d’un fichier CSV
Choisissez un fichier CSV de l’une des manières suivantes :
+ Choisissez **Choisir un fichier**, puis sélectionnez votre fichier.
+ Glissez et déposez votre fichier dans la zone de téléchargement.
Le fichier doit :
+ Être au format CSV
+ Être d’’une taille inférieure à 1 Go
+ Contenir des en-têtes
+ Être encodé UTF-8
## Configuration des détails du segment
Dans **Nom**, spécifiez un identifiant reconnaissable pour votre segment. Ce champ est obligatoire.
+ Utilisez uniquement des lettres (a-z, A-Z), des chiffres (0-9), des tirets (-) ou des traits de soulignement (\$1)
+ Commencez par une lettre ou un chiffre (pas un trait de soulignement)
+ Longueur maximale de 255 caractères
**Note**
Le site Web Amazon Connect d'administration utilise ce nom comme nom `DisplayName` du segment et génère un `SegmentDefinitionName` identifiant unique. Cet identifiant est utilisé lors de l'accès au segment via les profils clients Amazon Connect APIs.
Dans **Description** (facultatif), ajoutez des informations sur votre segment :
+ Longueur maximale de 1 000 caractères
## Mappage des attributs des clients
Le mappage des types d’objets définit la manière dont la fonctionnalité Profils des clients traite vos données CSV. Ce mappage :
+ Détermine la manière dont les données CSV alimentent les objets de profil standard.
+ Spécifie les champs à indexer pour l’attribution des profils.
Pour plus d’informations sur le mappage des types d’objets, consultez [Création et ingestion de données client dans Profils des clients](customer-profiles-object-type-mappings.md).
Choisissez l’une des options suivantes pour associer vos colonnes CSV aux attributs des Profils des clients :
### Option 1 : mappage alimenté par l’IA (recommandé)
1. Choisissez **Générer des attributs clients**, puis cliquez sur **Suivant**.
1. Le système analyse vos en-têtes CSV et suggère des mappages appropriés aux attributs de profils standards.
1. Passez en revue les mappages suggérés.
1. Facultatif : personnalisez les mappages :
+ Modifiez les mappages d’attributs de profils standards.
+ Ajoutez des attributs personnalisés au format : `Attributes.attribute-name`.
+ Mettez à jour l’identifiant unique.
### Option 2 : mappage manuel
1. Associez chaque en-tête de colonne CSV à un attribut de profil :
+ Attributs de fichier standard. Pour obtenir la liste complète, consultez [Définition de profil standard dans Profils des clients Amazon Connect](standard-profile-definition.md).
+ Créez des attributs personnalisés en utilisant le format : `Attributes.attribute-name`.
**Note**
Vous pouvez mapper jusqu’à 25 attributs.
1. Choisissez un attribut mappé comme identifiant client (clé unique).
### Choix d’un identifiant client
Une fois le mappage terminé, choisissez un attribut mappé comme identifiant du client. La fonctionnalité Profils des clients Amazon Connect est utilisée pour :
+ Créer de nouveaux profils ou mettre à jour des profils existants.
+ Associer les données entrantes aux profils existants.
**Note**
Les mappages d’attributs peuvent être modifiés à tout moment pendant la configuration, que ce soit à l’aide d’un mappage manuel ou basé sur l’IA.
## Définition de l’expiration de profil
Spécifiez la date d’expiration des profils importés :
1. Choisissez une option d’expiration :
+ Par défaut : 14 jours à compter de la date d’importation
+ Personnalisé : sélectionnez une date à l’aide du sélecteur de date
1. Pour les dates d’expiration personnalisées :
+ Minimum : 1 jour après importation
+ Maximum : 90 jours après l’importation
Profils des clients supprime les profils expirés du segment et du domaine des profils.
**Note**
Choisissez une période d’expiration qui correspond à vos exigences en matière de conservation des données. Déterminez si la période par défaut de 14 jours répond aux besoins de votre entreprise avant de sélectionner une date personnalisée.
## Création et surveillance de l’importation de segments
**Création du segment**
1. Examinez votre configuration.
1. Choisissez **Créer un segment**.
1. Le système va :
+ Mettre en ligne votre fichier CSV.
+ Créer/mettre à jour des profils en fonction des données.
+ Regrouper les profils dans un segment.
+ Afficher les progrès à l’aide d’une bannière de notification.
Surveillez la progression de l’importation
+ Consultez la progression de l’importation sur la page des détails du segment.
+ La bannière de notification indique que la tâche d’importation est en cours.
+ Le tableau des détails de la tâche d’importation indique :
+ Nom de fichier
+ Date de création de la tâche d’importation
+ Date de fin de la tâche d’importation
+ Nombre de profils traités
+ Nombre d’importations réussies
+ Nombre d’importations échouées
+ Vous pouvez annuler l’importation en cours.
+ Le segment peut être utilisé dans des campagnes alors que la tâche d’importation est toujours en cours.
**Note**
Les segments importés peuvent être utilisés comme n’importe quel autre segment pour les campagnes sortantes ou les exportations une fois l’importation terminée. Vous pouvez consulter les détails du segment, y compris le statut et les résultats de l’importation, sur la page des détails du segment.
# Exportation des segments clients vers un fichier CSV dans Amazon Connect
À partir de la page **Segments clients** du site Web d' Amazon Connect administration, vous pouvez exporter un segment existant vers un fichier sur votre ordinateur. Lorsque vous le faites, Customer Profiles exporte tous les attributs de profil associés aux profils du segment client vers un fichier CSV.
**Pour exporter un segment client**
1. Sur la page Segments clients, choisissez **Exporter CSV** dans le menu déroulant des actions.
![\[La page Segments clients, l’option Exporter CSV.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png)
Vous pouvez également accéder à la page **Afficher les détails**, puis choisir **Actions suivantes**, **Télécharger**.
![\[La page de détails du segment pour un segment, l’option Actions suivantes.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png)
**Note**
Le site Web Amazon Connect d'administration prend en charge l'exportation d'un segment de clientèle contenant jusqu'à 350 000 profils. Si vous devez exporter un segment contenant un grand nombre de profils, utilisez l’opération `CreateSegmentSnapshot` dans l’API des Profils des clients. L’opération `CreateSegmentSnapshot` prend en charge l’exportation d’un segment dans des fichiers ORC, JSONL et CSV vers un compartiment S3. Notez que l’API génère un fichier de test en plus du segment exporté dans le compartiment.
1. Une fois la tâche d’exportation lancée, laissez la fenêtre ou l’onglet contenant le téléchargement ouvert jusqu’à ce que le processus soit terminé.
![\[Un message indiquant que le segment est en cours d’exportation.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png)
1. Une fois le travail d'exportation terminé, le site Web de l' Amazon Connect administrateur commence automatiquement à télécharger le fichier.
![\[Un message indiquant que le segment a été correctement téléchargé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png)
Le fichier CSV exporté contient tous les [attributs standard et de profils des clients](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html) renseignés dans les profils exportés.
# Utilisation de l’assistant d’IA de segmentation dans Amazon Connect
Profils des clients Amazon Connect prend en charge la segmentation basée sur l’IA générative, ce qui permet aux utilisateurs professionnels non techniques de créer des publics à l’aide de requêtes en langage naturel ([assistant d’IA de segmentation](#generating-a-segment-by-prompt)) et de recevoir des recommandations basées sur les tendances des données clients ([cartes d’inspiration pour la création de segments](#inspiration-cards-for-segment-creation)). Ces fonctionnalités s’appuient sur les algorithmes d’intelligence artificielle avancés d’[Amazon Bedrock](https://aws.amazon.com/bedrock/) qui vous aident à améliorer la satisfaction de vos clients et à générer des revenus grâce à une approche proactive et personnalisée. Par exemple, vous pouvez créer un segment client qui ont fréquemment contacté le service client la semaine dernière avec des offres de service personnalisées. Vous pouvez également identifier les clients dont les dépenses totales ont augmenté et proposer des remises personnalisées, afin de les fidéliser et de stimuler la croissance.
Les avantages suivants sont ajoutés par l’intégration de l’IA générative dans le flux de travail de segmentation :
+ **Création de segments simplifiée** : créez des segments clients complexes à l’aide d’un langage conversationnel, en rendant le processus accessible aux utilisateurs non techniques et en améliorant l’efficacité.
+ **Inspirations de création de segments basées sur les données** : recevez des inspirations de segments basées sur l’IA en fonction des tendances des données clients.
+ **Personnalisation améliorée :** identifiez et ciblez facilement des groupes de clients spécifiques pour des communications et des offres personnalisées.
Les sections suivantes expliquent chaque fonctionnalité, comment les utiliser et les avantages qu’elles offrent pour vous aider à améliorer vos efforts de segmentation client.
**Note**
Pour utiliser l'assistant d'intelligence artificielle des segments, les utilisateurs devront être autorisés à créer des segments **CustomerProfiles.Segments.Create.**
Bien que ces outils basés sur l’IA offrent de précieuses suggestions, il est important de revoir et d’ajuster les segments recommandés pour s’assurer qu’ils correspondent aux objectifs commerciaux spécifiques de l’organisation et qu’ils sont conformes à ses politiques d’utilisation des données.
## Cartes d’inspiration pour la création de segments
Les cartes d’inspiration sont une fonctionnalité optimisée par l’IA sur la page **Segments clients**. Ils simplifient et améliorent le processus de création de segments. L’image suivante présente un exemple de trois cartes d’inspiration.
![\[Exemple de cartes d’inspiration sur la page Segments clients.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png)
Ces cartes génèrent jusqu’à trois catégories d’idées de segments à chaque fois, sur la base des données des Profils des clients Amazon Connect afin d’inspirer et de rationaliser votre processus de création de segments.
**Note**
Les données de tendance sont basées sur les dates d’ingestion des événements des attributs calculés par défaut.
**Fonctions principales**
+ **Inspirations basées sur les données** : chaque carte d’inspiration présente une idée de segment adaptée aux données et aux tendances spécifiques des clients.
+ Les cartes d’inspiration proposent des idées sur trois thèmes axés sur les entreprises :
+ **Promotion** : idées pour cibler les clients avec des stratégies promotionnelles spécifiques.
+ **Fidélisation** : identifiez les segments pour les efforts de fidélisation de la clientèle.
+ **Support** : mettez en évidence les groupes de clients susceptibles de nécessiter une attention particulière en matière de service client.
+ **Recommandations basées sur des informations** : tirez parti des tendances historiques, des informations sur les données et de l’IA générative pour créer des informations pertinentes et exploitables.
**Comment utiliser les cartes d’inspiration**
1. Accédez à la page **Segments clients**.
1. Localisez la section des cartes d’inspiration. Elle affiche trois suggestions de segments.
1. Passez en revue chaque carte pour comprendre le segment proposé et ses applications potentielles.
1. Lorsque vous trouvez une carte que vous souhaitez utiliser, choisissez **Commencer** avec cette carte.
1. Choisissez **Découvrir plus** pour générer des cartes d’inspiration supplémentaires. Elles peuvent proposer de nouvelles idées de segments basées sur les données de vos Profils des clients Amazon Connect.
1. Lorsque vous choisissez **Commencer**, vous êtes automatiquement dirigé vers la page **Créer un segment**.
1. L’idée de segment que vous avez sélectionnée est propagée dans le générateur de segments, prête à être révisée et affinée.
## Génération d’un segment à l’aide d’invites en langage naturel
L’assistant d’IA de segmentation propose une approche guidée pour créer des segments à l’aide d’invites en langage naturel, ce qui simplifie le processus de création de segments complexes, vous permet de décrire votre public cible en langage naturel et de recevoir une définition de segment structurée et exploitable.
L’image suivante présente un exemple d’invite pour l’assistant d’IA de segmentation.
![\[Exemple d’invites pour l’assistant d’IA de segmentation.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png)
**Pour accéder à cette fonctionnalité :**
1. Accédez à la page **Segment client**, puis choisissez **Créer un segment**.
1. Localisez le panneau d’assistant d’IA de segmentation sur le côté droit de la page, comme illustré sur l’image suivante.
![\[Exemple du panneau de l’assistant d’IA de segmentation sur le côté droit de la page.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png)
**Utilisation de l’assistant d’IA de segmentation**
1. L’assistant guide les utilisateurs à travers une série de questions pour comprendre les besoins de segmentation. Tous les chemins d’interaction avec l’assistant mènent à la génération d’une invite.
1. Les utilisateurs peuvent fournir une description textuelle du segment souhaité.
1. L’étape d’action d’invite propose des exemples d’invites comme références pour la rédaction de descriptions détaillées.
1. Sur la base de vos informations, Amazon Connect génère une définition de segment structurée.
1. La définition de segment générée est automatiquement appliquée au générateur de segments.
1. Vous pouvez affiner davantage le segment généré à l’aide des outils de création de segments standard. La modification des filtres dans le générateur de segments remplace les conditions existantes précédemment générées.
1. Après avoir examiné le segment généré et effectué les ajustements nécessaires, vous pouvez finaliser le processus en choisissant **Créer un segment**. Cette action enregistre votre segment et le rend disponible pour utilisation dans vos campagnes.
**Bonnes pratiques**
Lorsque vous utilisez l’assistant d’IA de segmentation, ayez les bonnes pratiques suivantes à l’esprit :
+ Rédigez des descriptions spécifiques. L’assistant d’IA de segmentation génère des conditions plus précises lorsque vous utilisez les noms d’attributs existants.
+ Assurez-vous que tous les attributs auxquels vous faites référence existent dans votre domaine.
+ Commencez par des invites simples puis essayez différentes invites. Si vous ne recevez pas ce que vous voulez du premier coup, réécrivez votre invite. L’envoi d’une nouvelle invite remplace les conditions existantes, de même que si vous choisissez **Nouvelle conversation**.
+ Prévoyez du temps pour affiner et valider les segments dans le générateur de segments afin de garantir que les segments reflètent avec précision les valeurs réelles de vos données.
**Note**
L’assistant d’IA de segmentation est conçu pour fonctionner avec des descripteurs et des critères généraux. Respectez toujours les réglementations en matière de protection des données et les politiques de l’entreprise lorsque vous décrivez des segments. Assurez-vous que vos invites et descriptions ne contiennent aucune information sensible ou personnelle.
## Feedback sur les segments générés
Après la génération d’un segment, les utilisateurs sont invités à évaluer les performances de la fonctionnalité et à fournir des commentaires. Ce mécanisme de feedback permet d’améliorer le processus de génération de segments et de garantir qu’il répond efficacement aux besoins de l’entreprise. L’image suivante illustre une page de commentaires.
![\[Exemple de message indiquant que vos commentaires ont été enregistrés.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png)
Le processus de feedback comprend deux étapes :
1. **Réaction initiale** : dans le coin inférieur droit de la section des alertes, vous trouverez des icônes représentant des pouces vers le haut et des pouces vers le bas. Cliquez sur l’un de ces éléments pour indiquer votre satisfaction générale à l’égard du segment généré.
1. **Feedback supplémentaire** : après avoir sélectionné l’icône du pouce vers le haut ou du pouce vers le bas, une option vous permet de fournir des commentaires plus détaillés. Celle-ci prend la forme d’un champ de saisie de texte dans lequel vous pouvez laisser des commentaires libres.
Nous vous encourageons à utiliser à la fois la réaction rapide (pouce vers le haut ou le bas) et la saisie de texte pour une évaluation complète, à fournir des exemples ou des cas d’utilisation spécifiques, à vous concentrer sur la manière dont le segment généré correspond aux objectifs commerciaux et à suggérer des améliorations ou des fonctionnalités supplémentaires susceptibles d’améliorer le processus de génération de segments.
Suggérez des améliorations ou des fonctionnalités supplémentaires qui amélioreraient le processus de génération de segments.
En participant activement au processus de feedback, les utilisateurs contribuent à l’amélioration continue de la fonctionnalité de génération de segments, ce qui conduit finalement à une segmentation client plus efficace et à des stratégies marketing ciblées.
## Gestion des erreurs
Lorsque vous utilisez l’assistant d’IA de segmentation pour générer des segments clients, vous pouvez parfois rencontrer un message d’erreur indiquant : **Nous ne pouvons pas traiter votre demande pour le moment.** Cette erreur peut se produire même après avoir fourni une invite valide pour la création de segments.
L’image suivante montre un exemple de ce message d’erreur.
![\[Exemple de message d’erreur indiquant qu’Amazon Connect ne peut pas traiter votre demande.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png)
Suivez les étapes ci-dessous pour comprendre et résoudre cette erreur.
**Causes possibles :**
+ **Charge système élevée** : l’assistant d’IA de segmentation peut être très sollicité ou traiter plusieurs demandes simultanément.
+ **Interruption de service temporaire** : il pourrait y avoir une brève interruption de la capacité du service à traiter de nouvelles demandes de segment.
+ **Requête complexe** : le système peut avoir besoin de plus de temps pour traiter les requêtes de segmentation particulièrement complexes ou gourmandes en ressources.
**Que faire :**
+ **Patientez et réessayez** : le message d’erreur suggère d’attendre quelques minutes avant de réessayer. Cela laisse le temps au système de résoudre tout problème temporaire.
+ **Créez manuellement votre segment** : si vous avez besoin du segment immédiatement, vous pouvez choisir de le créer manuellement à l’aide du générateur de segments
**Comment réessayer :**
1. Patientez quelques minutes.
1. Choisissez **Nouvelle conversation** en bas de l’interface de chat.
1. Démarrez une nouvelle conversation et saisissez à nouveau votre invite de création de segment.
**Bonnes pratiques**
+ Si l’erreur persiste après plusieurs tentatives, envisagez de simplifier les critères de votre segment ou de le décomposer en demandes plus petites et plus faciles à gérer.
+ Essayez d’éviter de faire des demandes répétées en succession rapide, car cela pourrait contribuer à surcharger le système.
+ Si le problème persiste, contactez le support client pour obtenir de l’aide.
N’oubliez pas que cette erreur est généralement temporaire et que le fait de suivre les instructions fournies devrait vous permettre de créer avec succès le segment souhaité.
## Limitations connues
Comprendre le cycle de vie du traitement des données est essentiel pour une utilisation efficace de l’assistant d’IA de segmentation. Cette section décrit ce à quoi les utilisateurs professionnels peuvent s’attendre au cours des différentes phases de l’intégration des données et comment cela affecte les suggestions de segments.
**Traitement des données et impact sur la qualité :** l’assistant d’IA de segmentation évolue en deux phases principales : l’ingestion initiale des données et le post-traitement. Lors de l’ingestion initiale, il se peut que le système n’utilise pas pleinement les valeurs d’attributs réelles, s’appuyant davantage sur une interprétation des invites. Par exemple, une invite destinée aux *clients VIP* peut suggérer un segment *VIP* au lieu d’utiliser le niveau *Gold* existant à partir de vos données. Une fois le traitement terminé, le système exploite les valeurs d’attributs réelles, ce qui permet de créer des segments avec plus de précision, de réduire le recours à une interprétation des invites et d’améliorer la qualité globale de la segmentation.
**Note**
Prévoyez suffisamment de temps pour le traitement complet des données avant de vous fier aux fonctionnalités avancées. Mettez régulièrement à jour les données du profil client. La précision des segments dépend de l’exhaustivité et de l’actualité des données des clients dans Profils des clients Amazon Connect. Le système signale tout attribut manquant dans ses réponses.
**Performances du système :** pendant les périodes de volume élevé, attendez-vous à des retards potentiels dans la génération des segments. Le système est optimisé pour les charges de travail classiques, mais les entreprises ayant des besoins de segmentation importants peuvent avoir besoin d’ajuster leurs processus en conséquence.
**Disponibilité des attributs** : la qualité des segments générés dépend des données clients disponibles dans Profils des clients Amazon Connect. Plus les données relatives up-to-date au profil du client sont complètes, plus le système peut interpréter les instructions et définir les segments pertinents avec précision. Si un attribut n’existe pas, nous retournerons un message avec l’attribut manquant.
**Complexité des invites** : pour les définitions de segments très complexes ou nuancées, le traitement du langage naturel peut présenter des limites. Les clients devraient commencer par des invites relativement simples et augmenter progressivement la complexité au fur et à mesure qu’ils acquièrent de l’expérience.
**Affinement des segments** : Bien que les segments générés par le système constituent un excellent point de départ, les clients voudront peut-être tout de même revoir et affiner les détails pour s’assurer que le segment correspond parfaitement à leurs objectifs commerciaux. L’interface de segmentation permet une personnalisation complète après la génération initiale.
**Performances et mise à l’échelle** : en cas de forte simultanéité, le processus de génération de segments peut présenter une certaine latence, car le modèle de langage doit traiter chaque invite. Le système est conçu pour gérer des charges de travail de segmentation typiques, mais les clients ayant des exigences de segmentation extrêmement élevées peuvent avoir besoin d’ajuster leurs flux de travail en conséquence
# Résolution des problèmes liés aux segments clients dans Amazon Connect
## L’option Segments clients n’apparaît pas dans le panneau de navigation de gauche
Si l'option **Segments clients** n'existe pas dans le panneau de navigation gauche du site Web d' Amazon Connect administration, vérifiez si les profils de sécurité de l'utilisateur disposent de l'autorisation **Segment client - Afficher**. Pour plus d'informations, consultez[Attribution d’autorisations de profil de sécurité pour gérer les segments clients](security-profile-customer-profile-segmentation.md). Une fois l’autorisation mise à jour, actualisez la page du site Web d’administration Amazon Connect pour refléter la modification.
## Le bouton Exporter CSV n’est pas disponible ou la tâche d’exportation a expiré
L'exportation d'un segment contenant plus de 350 000 profils n'est pas prise en charge sur le site Web Amazon Connect d'administration. Nous vous recommandons également d’exporter ce type de segment vers un compartiment Amazon S3 à l’aide de l’API `CreateSegmentSnapshot` via la référence de ligne de commande (CLI) ou le kit SDK.
## Erreur : vous avez atteint la limite de 60 attributs uniques
Cette erreur se produit lorsque le nombre d’attributs uniques dans la définition du segment dépasse le quota. Le nombre d’attributs uniques est compté de manière récursive, y compris les publics de départ.
**Des solutions**
+ Réduisez le nombre d’attributs uniques en supprimant les filtres de public dans la définition du segment ou en supprimant les publics de départ contenant des filtres de public.
+ [Demander une augmentation de quota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) pour les quotas de service - Nombre maximum d’attributs uniques dans le segment
Pour en savoir plus sur le quota de service par défaut, consultez la section [Quotas de service relatifs aux Profils des clients Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Erreur : vous avez atteint la limite de 10 attributs calculés uniques
Cette erreur se produit lorsque le nombre d’attributs calculés uniques dans la définition du segment dépasse le quota. Le nombre d’attributs calculés uniques est compté de manière récursive, y compris les publics de départ.
**Des solutions**
+ Réduisez le nombre d’attributs calculés uniques en supprimant les filtres de public sur les attributs calculés dans la définition du segment, ou en supprimant les publics de départ qui contiennent des filtres de public sur les attributs calculés.
+ [Demander une augmentation de quota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) pour les quotas de service - Nombre maximum d’attributs calculés uniques dans le segment.
Pour en savoir plus sur le quota de service par défaut, consultez la section [Quotas de service relatifs aux Profils des clients Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Erreur : vous avez atteint la limite de 5 publics de départ
Cette erreur se produit lorsque la profondeur des publics de départ dépasse le quota. La profondeur est comptabilisée de manière récursive pour tous les publics initiaux de votre groupe de public. Par exemple, si vous sélectionnez un segment « Surclassement locatif éligible » comme public de départ, et que le segment « Surclassement locatif éligible » comprend un autre segment comme public de départ, la profondeur sera de 2.
**Solution**
+ Supprimez un ou plusieurs publics de départ de votre groupe de publics qui contient des publics de départ profondément imbriqués.
Pour en savoir plus sur les quotas de service par défaut, consultez la section [Quotas de service relatifs aux Profils des clients Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
# Configuration de l’Explorateur de profils dans Profils des clients Amazon Connect
Amazon Connect Customer Profiles Explorer est un all-in-one tableau de bord dynamique qui fournit une vue complète à 360° de vos clients. Il unifie les données clients fragmentées et permet aux entreprises de personnaliser l’affichage des données, de suivre les interactions et de transformer les informations clients en informations exploitables qui génèrent de la valeur commerciale et fidélisent les clients. Organisations actives dans des secteurs tels que le tourisme et l’hôtellerie peuvent utiliser l’Explorateur de profils pour mieux comprendre leurs clients et interagir avec eux grâce à cette interface intuitive.
+ **Trouvez des clients instantanément** en utilisant simultanément plusieurs identifiants (e-mail, téléphone, référence de réservation, etc.) avec des résultats de recherche en temps réel.
+ **Personnalisez les affichages** pour hiérarchiser les informations les plus pertinentes en fonction des besoins spécifiques de l’entreprise, concevez une mise en page spécifique au domaine qui met en évidence les données clients les plus pertinentes que vous avez définies.
+ **Accédez au contexte client complet**, notamment aux données démographiques, à l’historique des communications, aux interactions comportementales et à l’appartenance aux segments, grâce à des visualisations et des affichages de données interactifs.
+ **Tirez parti des informations générées par l’IA** grâce à des résumés de clients mettant en évidence les principaux modèles et à des inférences comportementales personnalisées.
![\[Le tableau de bord de l’Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png)
**Topics**
+ [Activation de l’Explorateur de profils](enabling-profile-explorer.md)
+ [Mise en route](getting-started-profile-explorer.md)
+ [Définition de la mise en page](layout-definition.md)
+ [Ajout de l’Explorateur de profils à l’espace de travail de l’agent](add-profileexplorer-to-agentworkspace.md)
# Activation de l’Explorateur de profils
Les étapes suivantes vous permettront d’activer l’Explorateur de profils pour vos administrateurs et utilisateurs. Ce processus implique la configuration des autorisations pour la configuration de la mise en page et l’accès à l’affichage.
**Topics**
+ [Permettre aux administrateurs de définir une mise en page](#enable-administrators-define-layout)
+ [Permettre aux utilisateurs d’afficher l’Explorateur de profils](#enable-users-view-profile-explorer)
+ [Vérifier la configuration](#verify-setup)
## Permettre aux administrateurs de définir une mise en page
Les administrateurs ont besoin d’autorisations spécifiques pour créer et modifier les mises en page de l’Explorateur de profils :
+ Attribuez les autorisations suivantes dans le profil de sécurité de l’Explorateur de profils :
+ **Explorateur de profils - Modifier** : permet de modifier la disposition existante de l’Explorateur de profils.
+ **Explorateur de profils - Créer** : permet de créer la mise en page de l’Explorateur de profils.
+ **Explorateur de profils - Affichage** : permet d’accéder à l’affichage de la disposition configurée de l’Explorateur de profils.
![\[Ajoutez des autorisations pour permettre aux utilisateurs de créer, de modifier et d’afficher les mises en page de l’Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-administrators-define-layout-1.png)
## Permettre aux utilisateurs d’afficher l’Explorateur de profils
Les utilisateurs ont besoin des autorisations appropriées pour accéder et interagir avec la disposition de l’Explorateur de profils :
+ Attribuez les autorisations suivantes dans le profil de sécurité de l’Explorateur de profils :
+ **Explorateur de profils - Affichage** : permet d’accéder à l’affichage de la disposition configurée de l’Explorateur de profils.
![\[Ajoutez des autorisations pour permettre aux utilisateurs d’afficher les mises en page de l’Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png)
## Vérifier la configuration
Pour confirmer que l’Explorateur de profils peut être correctement activé, procédez comme suit :
Connectez-vous en tant qu’administrateur pour vérifier que vous pouvez :
+ Accéder à la page de l’Explorateur de profils.
+ Créer et modifier la mise en page de votre Explorateur de profils.
Connectez-vous en tant qu’utilisateur normal pour vérifier que vous pouvez :
+ Accéder à l’Explorateur de profils.
+ Afficher la mise en page de l’Explorateur de profils.
+ Interagir avec les fonctionnalités activées.
# Premiers pas avec l’Explorateur de profils Profils des clients Amazon Connect
Faites vos premiers pas avec l’Explorateur de profils et découvrez les bases de l’interface.
**Topics**
+ [Contrôles de la mise en page](layout-controls.md)
+ [Modification de la mise en page de votre explorateur](editing-explorer-layout.md)
+ [Enregistrement de la mise en page de votre Explorateur](saving-explorer-layout.md)
# Contrôles de la mise en page
![\[Ajoutez des autorisations pour permettre aux utilisateurs d’afficher les mises en page de l’Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/layout-controls-1.png)
Console de bienvenue de l’Explorateur de profils.
1. Modifier les onglets
1. Ajouter des widgets
1. Actions de mise en page
## Modifier les onglets
Organisez votre tableau de bord en sections logiques à l’aide des commandes par onglets :
+ **1a. Ajouter un onglet** : créez de nouveaux onglets pour séparer les différents aspects des données clients
+ **1b. Supprimer un onglet** : supprimez les onglets inutiles de votre mise en page
+ **1c. Renommer un onglet** : personnalisez les noms des onglets en fonction de leur contenu
+ **1d. Réorganiser les onglets** : glissez-déposez les onglets pour les disposer dans l’ordre de votre choix
![\[La fenêtre contextuelle Modifier les onglets apparait.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/layout-controls-2.png)
## Ajouter des widgets
Améliorez votre onglet actif avec différents widgets de visualisation des données :
### Widgets disponibles
+ Widgets par défaut
+ [Résumés générés par l’IA générative](default-widgets.md#generative-ai-summary)
+ [Informations client](default-widgets.md#customer-information)
+ [Attribut calculé](default-widgets.md#calculated-attribute)
+ [Contacts](default-widgets.md#contacts)
+ [Cas](default-widgets.md#cases-cp)
+ [Commandes](default-widgets.md#orders-cp)
+ [Assets](default-widgets.md#assets-cp)
+ Widgets personnalisés
+ [Table](custom-widgets.md#table-widget)
+ [Paire clé-valeur](custom-widgets.md#key-value-pair)
+ [Indicateur clé](custom-widgets.md#key-metric)
+ [Graphique en anneau](custom-widgets.md#donut-chart)
Il vous suffit de sélectionner un widget que vous souhaitez utiliser et de commencer à explorer
## Actions de mise en page
Gérez la configuration globale de votre tableau de bord :
+ **Enregistrer la mise en page** : préservez la configuration actuelle de votre tableau de bord
![\[Enregistrez votre fenêtre contextuelle de mise en page.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/layout-controls-3.png)
**Note**
Toutes les modifications sont dans un brouillon jusqu’à ce qu’elles soient enregistrées.
# Modification de la mise en page de votre explorateur
Personnalisez la mise en page de votre Explorateur de profils grâce à des commandes simples et intuitives pour gérer les widgets et leur placement.
## Contrôles des widgets
Chaque widget comporte un menu à trois points dans le coin supérieur droit, proposant deux options principales :
+ **1A Modifier** : ouvre le panneau de configuration pour ce widget spécifique
+ **1B Supprimer** : supprime le widget de votre mise en page
![\[Modifiez ou supprimez la fenêtre contextuelle pour la mise en page de votre Explorateur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/widget-controls-1.png)
## Personnalisation du widget
+ **Glisser & déposer** : repositionnez les widgets n’importe où sur votre tableau de bord
+ **Redimensionner** : choisissez et faites glisser les bordures du widget pour ajuster les dimensions
+ **Configurer** : accédez aux paramètres détaillés via le panneau d’édition spécifique à chaque type de widget
![\[Personnalisez et réorganisez vos widgets dans la mise en page de l’Explorateur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/widget-customization-1.png)
**Note**
Chaque type de widget possède des options de configuration uniques. Pour obtenir des informations détaillées sur les paramètres spécifiques des widgets, reportez-vous à la documentation des widgets.
## Ajout de nouveaux widgets
Pour ajouter de nouveaux composants à votre mise en page, utilisez le bouton **Ajouter des widgets** dans le panneau de configuration.
# Enregistrement de la mise en page de votre Explorateur
Comment enregistrer et gérer les configurations de mise en page de votre Explorateur de profils.
## Persistance de la mise en page
Les modifications apportées à la mise en page de votre Explorateur de profils doivent être enregistrées pour être conservées. Les modifications non enregistrées seront perdues lorsque vous quitterez la page ou que vous actualiserez votre navigateur.
## Mise en page par défaut
Chaque implémentation de l’Explorateur de profils inclut une mise en page par défaut. Il s’agit de la configuration de base pour votre organisation et peut être modifiée selon les besoins.
## Enregistrement des modifications
Pour enregistrer les modifications de mise en page :
1. Choisissez **Enregistrer** dans le menu Actions de mise en page.
1. Confirmez vos modifications dans la boîte de dialogue de sauvegarde.
1. La mise en page sera mise à jour pour tous les utilisateurs une fois l’enregistrement terminé.
![\[Enregistrez votre boîte de dialogue de mise en page dans la mise en page de l’Explorateur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/saving-changes-1.png)
**Note**
Les autorisations appropriées sont nécessaires pour enregistrer les modifications de mise en page. Pour plus d’informations sur les autorisations requises, consultez [Activation de l’Explorateur de profils](enabling-profile-explorer.md).
# Définition de la mise en page
Comprendre la structure et les composants des mises en page de l’Explorateur de profils.
**Topics**
+ [Comment ça marche](how-it-works.md)
+ [Widgets](widgets.md)
# Comment ça marche
L’Explorateur de profils propose différents widgets pour afficher les informations sur les clients. Les mises en page sont stockées sous forme de définitions JSON, représentant la structure et la configuration complètes de votre tableau de bord. Chaque widget et composant de votre mise en page visuelle correspond à un bloc JSON spécifique au sein de cette définition.
## Composants de base
Chaque composant de la définition de la mise en page est composé de cinq éléments communs :
+ **Type**
+ Définit la catégorie du composant
+ Détermine le mode de rendu du composant
+ Exemples : BoardItem, Tableau, KeyValuePair
+ **Id**
+ Identifiant unique pour chaque composant
+ Utilisé pour le suivi et les mises à jour des composants
+ Généré automatiquement lorsque des composants sont créés dans le générateur
+ **Props**
+ Propriétés spécifiques aux composants
+ Contrôle l’apparence et le comportement
+ Contient des paramètres de configuration
+ **Enfants**
+ Composants ou contenus imbriqués
+ Définit des relations hiérarchiques
+ Peut contenir plusieurs sous-composants
+ **DataSource**
+ Spécifie l’origine des données
+ Définit les paramètres d’extraction des données
+ Contrôle la liaison des données pour les composants
## Exemple de définition de composant de mise en page
Voici un exemple de structure JSON pour un composant de tableau de bord :
```
{
"Id": "unique-identifier",
"Type": "BoardItem",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "Table",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "TextContent",
"Props": {},
"Children": ["string"]
}
]
}
],
"DataSource": [
{
"Type": "source-type",
"Params": {}
}
]
}
```
## Configuration des données dynamiques
L’Explorateur de profils utilise des expressions de modèle pour accéder aux données des Profils des clients et les afficher de manière dynamique au sein de vos composants.
### Support à valeur unique
Pour les composants tels que les paires de valeurs clés et les indicateurs clés, vous pouvez accéder à :
#### Informations de profil standard
```
{{Customer.}}
```
Exemple d’utilisation :
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`
#### Attributs calculés
```
{{Customer.CalculatedAttributes.}}
```
Exemple d’utilisation :
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`
### Syntaxe de prise en charge des données tabulaires
#### Attributs calculés
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```
#### Segments
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```
#### Objets de profil
```
{{Customer.ObjectAttributes..}}
```
**Exemple d’utilisation :**
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`
### Exemples d’implémentation
#### Composant à valeur unique
```
{
"Type": "KeyValuePair",
"Props": {
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Children": ["Customer Name"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.FirstName}}"]
}
}
}
]
}
}
```
#### Composant tabulaire
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Cell": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
}
},
"Header": "Contact ID"
}
]
}
}
```
**Note**
Assurez-vous que les attributs, les objets et les segments auxquels vous faites référence existent dans votre configuration des Profils des clients avant de les utiliser dans votre mise en page.
# Widgets
Explorez les différents types de widgets disponibles dans l’Explorateur de profils.
## Présentation de
Les widgets de l’Explorateur de profils sont des éléments composites créés à partir de composants JSON au sein de votre définition de mise en page. Bien que ces widgets représentent des structures JSON complexes, notre créateur d’interface utilisateur gère automatiquement la composition technique, ce qui rend la gestion du tableau de bord simple et accessible.
**Topics**
+ [Présentation de](#widgets-overview)
+ [Widgets disponibles](#available-widgets)
+ [Widgets par défaut](default-widgets.md)
+ [Widgets personnalisés](custom-widgets.md)
## Widgets disponibles
+ Widgets par défaut
+ [Résumés générés par l’IA générative](default-widgets.md#generative-ai-summary)
+ [Informations client](default-widgets.md#customer-information)
+ [Attribut calculé](default-widgets.md#calculated-attribute)
+ [Contacts](default-widgets.md#contacts)
+ [Cas](default-widgets.md#cases-cp)
+ [Commandes](default-widgets.md#orders-cp)
+ [Assets](default-widgets.md#assets-cp)
+ Widgets personnalisés
+ [Table](custom-widgets.md#table-widget)
+ [Paire clé-valeur](custom-widgets.md#key-value-pair)
+ [Indicateur clé](custom-widgets.md#key-metric)
+ [Graphique en anneau](custom-widgets.md#donut-chart)
# Widgets par défaut
L’Explorateur de profils est fourni avec une collection de widgets préconfigurés conçus pour fonctionner parfaitement avec les données des Profils des clients. Ces widgets par défaut offrent une valeur immédiate avec une configuration minimale, ce qui vous permet de créer des tableaux de bord sophistiqués en quelques clics.
![\[Ajoutez des widgets par défaut dans la mise en page de l’Explorateur.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/default-widgets-1.png)
## Ready-to-use widgets
+ [Résumés générés par l’IA générative](#generative-ai-summary)
+ [Informations client](#customer-information)
+ [Attribut calculé](#calculated-attribute)
+ [Contacts](#contacts)
+ [Cas](#cases-cp)
+ [Commandes](#orders-cp)
+ [Assets](#assets-cp)
**Note**
Bien que ces widgets soient préconfigurés, vous pouvez toujours les personnaliser pour mieux répondre à vos besoins spécifiques. Ils servent de point de départ pour faciliter l’intégration.
## Résumés générés par l’IA générative
L’Explorateur de profils fournit par défaut des informations clients basées sur l’IA qui génèrent des résumés concis mettant en évidence les principaux modèles de comportement, fournit des informations personnalisées sur les clients basées sur l’historique des interactions et fait ressortir des recommandations exploitables à partir des données clients à 360°. Les résumés générés par l’IA aident les entreprises à prendre des décisions basées sur les données en identifiant des modèles sur plusieurs points de contact avec les clients, en fournissant des informations comportementales personnalisées spécifiques à chaque client et en améliorant l’expérience client et en renforçant la fidélité.
![\[Widget de résumés générés par l’IA générative\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/generative-ai-summary-1.png)
## Informations client
Le widget Informations clients fournit une vue claire et organisée des données des Profil des clients standards à l’aide de composants de paires clé-valeur. Ce widget par défaut affiche automatiquement les informations essentielles sur les clients dans un format facilement lisible.
### Présentation de
Ce widget utilise le composant de paire clé-valeur pour afficher les attributs du client dans une mise en page structurée.
+ Prénom
+ Nom
+ Adresse e-mail
+ Numéro de téléphone
+ Adresse
+ Numéro de compte
+ ID du profil
### Données
Le widget se connecte automatiquement à votre domaine Profils des clients et extrait les informations des attributs de profil standard. Aucune configuration supplémentaire n’est requise pour les fonctionnalités de base.
**Remarque** : Bien que ce widget soit préconfiguré avec des attributs de profil standard, vous pouvez personnaliser les attributs de profil standard qui sont affichés en fonction de vos besoins spécifiques.
#### En savoir plus
+ [Définition de profil standard](standard-profile-definition.md)
+ Paire clé-valeur
## Attribut calculé
Le widget Attribut calculé vous permet d’afficher un composant de mesures clés en utilisant les données des attributs calculés de vos profils clients.
### Présentation de
Le widget Attribut calculé vous permet d’afficher un composant de mesures clés en utilisant les données des attributs calculés de vos profils clients.
### Caractéristiques des composants
+ Affichage des mesures calculées sous forme d’indicateurs à valeur unique
### Exemples de cas d’utilisation courants
+ Campagnes livrées
+ Cas ouverts
+ Temps d’appel moyen
+ Préférences de canal
### Configuration
Il vous suffit de sélectionner votre attribut calculé et de choisir votre format d’affichage préféré
**Note**
Les attributs calculés doivent être configurés dans votre domaine Profils des clients avant de pouvoir être utilisés dans ce widget.
**En savoir plus**
+ Indicateur clé
+ [Paramétrage des attributs calculés](customerprofiles-calculated-attributes-admin-website.md)
## Contacts
Construit à l’aide du composant Table JSON, le widget Contacts affiche vos données d’objets de contact Profils des clients dans un format tabulaire organisé. Ce widget se connecte automatiquement aux données CTR des Profils des clients, affichant les informations de contact clés et l’historique des interactions.
### Caractéristiques
+ Affichage de tous les événements de contact avec les clients
+ Tri et filtrage des enregistrements de contacts
+ Personnalisation des champs de contact affichés
+ Accès à des informations de contact détaillées
Pour plus d’informations sur les objets CTR Profils des clients, consultez [Modèles d’enregistrement des contacts dans Profils des clients Amazon Connect](ctr-contact-record-template.md)
## Cas
Construit à l’aide du composant Table JSON, le widget Cas affiche vos données d’objets de cas Profils des clients dans un format tabulaire organisé. Ce widget se connecte automatiquement aux données de cas des Profils des clients, affichant les interactions d’assistance et les détails de la gestion des cas.
### Caractéristiques
+ Affichage de tous les cas clients
+ Tri et filtrage des cas
+ Personnalisation des champs de cas affichés
+ Accès à des informations de cas détaillées
Pour plus d’informations sur les objets de cas Profils des clients, consultez [Mappage de type d’objet au cas standard dans les Profils de clients](object-type-mapping-standard-case.md).
## Commandes
Construit à l’aide du composant Table JSON, le widget Commandes affiche vos données d’objets de commandes Profils des clients dans un format tabulaire organisé. Ce widget se connecte automatiquement aux données de commande des Profils des clients, affichant l’historique des achats et les détails des transactions.
### Caractéristiques
+ Affichage de tous les événements liés aux commandes des clients
+ Tri et filtrage des enregistrements de commandes
+ Personnalisation des champs de commandes affichés
+ Accès à des informations de commandes détaillées
Pour plus d’informations sur les objets de commandes CTR Profils des clients, consultez [Mappage de type d’objet à la commande standard dans Profils des clients Amazon Connect](object-type-mapping-standard-order.md)
## Assets
Construit à l’aide du composant Table JSON, le widget Ressources affiche vos données d’objets de ressources Profils des clients dans un format tabulaire organisé. Ce widget se connecte automatiquement aux données des ressources des Profils des clients, indiquant les produits et services appartenant au client.
### Caractéristiques
+ Affichage de tous les cas relatifs aux ressources des clients
+ Tri et filtrage des données des ressources
+ Personnalisation des champs de ressources affichés
+ Accès à des informations de ressources détaillées
Pour plus d’informations sur les objets de ressources Profils des clients, consultez [Mappage des types d’objets pour la ressource standard dans Profils des clients](object-type-mapping-standard-asset.md).
# Widgets personnalisés
Créez des composants de tableau de bord personnalisés à partir de zéro pour répondre aux besoins spécifiques de votre entreprise. Les widgets personnalisés vous permettent de créer des visualisations uniques sans aucune donnée prédéfinie.
![\[Ajoutez des widgets clients dans la mise en page de l’Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/custom-widgets-1.png)
## Composants personnalisés disponibles
+ [Table](#table-widget)
+ [Paire clé-valeur](#key-value-pair)
+ [Indicateur clé](#key-metric)
+ [Graphique en anneau](#donut-chart)
## Création de widgets personnalisés
**Chaque widget personnalisé peut être configuré avec :**
+ Sources de données personnalisées
+ Affichages personnalisés
+ Champs personnalisés
+ Interactions personnalisées avec les objets
## Table
Le composant de tableau personnalisé fournit des options de configuration flexibles pour afficher vos données sous forme de tableau, avec des fonctionnalités avancées d’interaction et d’organisation.
### Caractéristiques
1. **Configurations de colonnes**
+ Définition d’en-têtes de colonne personnalisés
+ Spécification des données pour chaque colonne
+ Définition des options de formatage des données
+ Définition de la position des colonnes
1. **Filtrage**
+ Filtrez rapidement les éléments de votre tableau
1. **Liens**
+ Liens vers des ressources Connect
+ Navigation fluide vers :
+ Segments
+ Attributs calculés
+ Ouverture dans un nouvel onglet
+ **Liens URL externes**
+ Convertissez la valeur de l'élément de ligne en URLs celle que vous pouvez choisir
+ Ouverture dans un nouvel onglet
+ Génération dynamique de liens en fonction des données de rangée
+ Liens d’affichage via un tiroir
+ Ouverture des informations détaillées dans le tiroir latéral
+ Affichage de détails complets de l’enregistrement sans quitter la page
1. organisation des données
+ Regroupement
+ Regroupement de lignes selon des noms de champs spécifiques
+ Paramètres de groupes persistants
+ Tri
+ Tri selon n’importe quel champ de colonne
+ Organisation par ordre croissant
+ Paramètres de tri persistants
**Figure 1**
![\[Exemple d’édition de widget de tableau personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/table-features-1.png)
**Figure 2**
![\[Un autre exemple d’édition de widget de tableau personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/table-features-2.png)
### Exemple de configuration
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Header": "Table column header"
"Cell": {
"Content": {
"Props": {
"Variant": "Link",
"LinkOptions": {
"LinkType": "Drawer"
}
},
"Type": "TextContent",
"Children": ["string"]
}
},
}
]
}
}
```
## Paire clé-valeur
Le composant Paire clé-valeur vous permet de créer des affichages organisés de points de données connexes dans un format flexible et lisible.
### Présentation de
Créez des affichages de données dynamiques en définissant des relations clé-valeur personnalisées. Ce composant est particulièrement utile pour afficher des paires d’attributs telles que :
+ Informations relatives au client
+ Informations relatives au compte
### Caractéristiques
1. **Options de liens interactifs**
+ Liens vers des ressources Connect
+ Lien direct vers des ressources connexes
+ Navigation fluide vers :
+ Attributs calculés
+ Segments
+ Ouverture dans un nouvel onglet
+ Liens URL externes
+ Convertissez la valeur de l'article en URLs une valeur que vous pouvez choisir
+ Ouverture dans un nouvel onglet
+ Liens d’affichage via un tiroir
+ Ouverture des informations détaillées dans le tiroir latéral
+ Affichage de tous les détails sans quitter la page
1. Configuration de colonnes
+ Définition de 1 à 4 colonnes de paires clé-valeur
1. Organisation des paires en groupes logiques
**Figure 1**
![\[Exemple d’édition de widget de paire clé-valeur personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/key-value-pair-features-1.png)
**Figure 2**
![\[Un autre exemple d’édition de widget de paires clé-valeur personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/key-value-pair-features-2.png)
### Exemple de configuration
```
{
"Type": "KeyValuePair",
"Id": "UniqueId",
"Props": {
"Columns": 2,
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {
"FontWeight": "bold"
},
"Children": ["Profile id"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {},
"Children": ["[string]"]
}
}
}
]
}
}
```
**Note**
Ce composant ne prend actuellement pas en charge `ProfileObjects` dans le générateur d’interface utilisateur.
## Indicateur clé
Le composant Key Metric vous permet d'afficher de manière visible les indicateurs commerciaux critiques et les statistiques de l'état civil dans un format facile à digérer. KPIs
### Présentation de
Créez des affichages de mesures à haute visibilité qui mettent en évidence les points de données, les tendances ou les indicateurs de statut importants. Ce composant est idéal pour mettre en valeur :
+ Indicateurs de performance
+ Mesures critiques
+ Résumés du statut
+ Indicateurs de tendance
### Caractéristiques
1. **Grand texte d’affichage**
1. **Format métrique**
1. **Options de liens interactifs**
+ Liens vers des ressources Connect
+ Lien direct vers des ressources connexes
+ Navigation fluide vers :
+ Attributs calculés
+ Segments
+ Ouverture dans un nouvel onglet
+ Liens URL externes
+ Convertissez la valeur de l'article en URLs une valeur que vous pouvez choisir
+ Ouverture dans un nouvel onglet
+ Liens d’affichage via un tiroir
+ Ouverture des informations détaillées dans le tiroir latéral
+ Affichage de tous les détails sans quitter la page
1. **Organisation de la disposition des indicateurs**
**Figure 1**
![\[Exemple d’édition de widget métrique clé personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/key-metric-features-1.png)
**Figure 2**
![\[Un autre exemple d’édition de widget métrique clé personnalisé.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/key-metric-features-2.png)
### Exemple de configuration
```
{
"Type": "KeyMetrics",
"Props": {
"MetricDefinitions": [
{
"MetricLabel": "Total Revenue",
"MetricValue": {
"Content": {
"Type": "TextContent",
"Props": {
"Format": "USD",
"FontSize": "large",
"FontWeight": "bold"
},
"Children": ["[string]"]
}
},
"Columns": 1
}
]
}
}
```
**Note**
Ce composant ne prend actuellement pas en charge `ProfileObjects` dans le générateur d’interface utilisateur.
## Graphique en anneau
Le composant graphique en anneau permet de visualiser le score des sentiments par le biais d’un graphique en anneau circulaire.
### Présentation de
Créez des visualisations dynamiques des sentiments en définissant des critères de notation personnalisés. Ce composant est particulièrement utile pour afficher :
+ Indicateurs de réussite
+ Taux de réussite
+ Évaluation des risques
+ Indicateurs de performance
### Caractéristiques
1. Options d’analyse de sentiment
+ Sentiment positif
+ Commence à partir de zéro
+ Suit les résultats par rapport aux critères suivants :
+ Valeurs de points personnalisées
+ Segments codés par couleur
+ Gris pour les conditions non satisfaites
+ Affiche le pourcentage du taux de réussite
+ Sentiment négatif
+ Commence à partir de la valeur maximale
+ Suit les déductions :
+ Segments codés par couleur
+ Système de réduction de points
+ Vert pour la valeur restante
+ Affiche le score final
1. Valeur d’attribut calculée
1. Options pour les opérateurs
+ Égal à
+ Non égal à
+ Supérieur à
+ Inférieur à
1. Valeur de la condition
1. Points alloués par condition
**Figure 1 : Exemple de sentiment positif**
![\[Exemple d’édition d’un widget de sentiment positif.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/donut-chart-features-1.png)
**Figure 2 : Exemple de sentiment négatif**
![\[Exemple d’édition d’un widget de sentiment négatif.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/donut-chart-features-2.png)
### Exemple de configuration
```
{
"Type": "DonutChart",
"Props": {
"Variant": "PositiveSentiment",
"ConditionDefinitions": [
{
"Title": "Customer Satisfaction",
"Color": "#4CAF50",
"CalculatedAttribute": "satisfaction_score",
"Operator": "GREATER_THAN",
"ValueCondition": 8,
"Points": 10
}
]
}
}
```
**Note**
**Pour le moment, les anneaux ne prennent en charge que les attributs calculés en tant que source de données.**
**Toutes les définitions de conditions doivent inclure un titre, une couleur, un attribut calculé, un opérateur, une condition de valeur et une valeur en points.**
# Ajout de l’Explorateur de profils à l’espace de travail de l’agent
Par défaut, les utilisateurs disposant des [autorisations de profil de sécurité](enabling-profile-explorer.md) appropriées peuvent consulter l'explorateur de profils sur le site Web de l' Amazon Connect administrateur. Vous souhaiterez peut-être également que vos agents aient accès à l’Explorateur de profils dans leur espace de travail d’agent. Cette rubrique explique comment procéder.
L’image suivante montre un exemple de l’Explorateur de profils dans l’espace de travail de l’agent.
![\[L’espace de travail de l’agent, l’onglet Explorateur de profils.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
## Création de la mise en page de l’Explorateur de profils que vous souhaitez partager avec les agents
Voici un aperçu détaillé :
1. Assurez-vous de disposer des [autorisations de profil de sécurité](enabling-profile-explorer.md) pour créer une mise en page de l’Explorateur de profils.
1. Suivez les instructions dans [Premiers pas avec l’Explorateur de profils Profils des clients Amazon Connect](getting-started-profile-explorer.md) pour créer et enregistrer la mise en page que vous souhaitez partager avec les agents.
## Ajouter l'explorateur de profils à Amazon Connect en tant qu'intégration
1. Sur la console Amazon Connect, dans le volet de navigation de gauche, choisissez **Integrations**, comme illustré dans l'image suivante.
![\[La console Amazon Connect, l'élément de menu Intégrations.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/integrations.png)
1. Sur la page **Intégrations**, choisissez **Ajouter une intégration**.
1. Sur la page **Ajouter une intégration**, renseignez les champs suivants dans la section **Informations de base** :
1. **Nom d’affichage** : nom convivial pour l’application. **Ce nom est affiché à vos agents dans l’onglet de l’espace de travail de l’agent**. Il est également affiché sur les profils de sécurité. Vous pouvez revenir et modifier ce nom.
1. **Identifiant d'intégration** : nom officiel unique pour votre intégration. Si vous n'avez qu'une seule intégration par URL d'accès, nous vous recommandons d'utiliser l'origine de l'URL d'accès. Vous ne pouvez pas modifier ce nom.
1. **Description (facultatif)** : vous pouvez éventuellement fournir n’importe quelle description pour cette application. Cette description ne s’affiche pas pour les agents.
1. **Type d'intégration** : choisissez **Application standard**.
1. **Étendue du contact** : Choisissez **Par contact**. Il s’agit d’un paramètre obligatoire pour l’assistance pour les appels entrants.
1. **Délai d’initialisation** : durée maximale, en millisecondes, autorisée pour établir une connexion avec l’espace de travail.
L’image suivante présente la configuration de ces champs. Le délai d’initialisation est défini sur 5 secondes.
![\[La section Informations de base, configurée pour l’Explorateur de profils sur l’espace de travail de l’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/add-integration.png)
1. Dans la section **Accès**, renseignez les champs suivants :
1. **URL d’accès** : il s’agit de l’URL dans laquelle l’application est hébergée. L’URL doit être sécurisée, en commençant par https, sauf s’il s’agit d’un hôte local.
**Important**
L’URL doit contenir `?_appLayoutMode=embedded`. Par exemple :
`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
Si vous ne l'incluez pas`?_appLayoutMode=embedded`, la navigation de gauche depuis le site Web de l' Amazon Connect administrateur apparaît dans l'espace de travail de l'agent.
Pour plus de détails sur ce qui est autorisé pour ce champ, consultez [Intégrations](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Origines approuvées - facultatif** : liste d'autorisation URLs qui devrait être autorisée, si elle est différente de l'URL d'accès. L’URL doit être sécurisée, en commençant par https, sauf s’il s’agit d’un hôte local.
1. La saisie des deux sections suivantes (**Autorisations** et **configuration Iframe**) est facultative et n’est pas obligatoire pour ajouter l’Explorateur de profils à l’espace de travail de l’agent. Pour plus d’informations sur ces sections, consultez [Intégrations](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Association d’instance** : choisissez l’instance que vos agents utilisent.
Vous pouvez autoriser n'importe quelle instance de cette région de compte à accéder à cette intégration.
1. Choisissez **Ajouter une intégration**.
## Attribuer aux agents l’autorisation d’accéder au nouveau profil de sécurité
Au cours de cette étape, vous devez attribuer aux agents des autorisations d'accès à la nouvelle intégration ET des autorisations d'affichage à l'explorateur de profils.
1. Sur le site Web de l' Amazon Connect administrateur, accédez au profil de sécurité de l'**agent**.
1. Sur la page **Modifier le profil de sécurité**, attribuez les autorisations suivantes :
+ **Profils clients** - **Explorateur de profils** - **Afficher**
+ **Applications d'agent** - **nom de votre intégration** - **Access**
L'image suivante montre un exemple d'autorisations ajoutées pour une nouvelle intégration nommée **Profile Explorer**.
![\[Autorisations de profil de sécurité pour la nouvelle intégration.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/profile-explorer-securityperms.png)
## Demandez aux agents d’épingler la nouvelle application
En utilisant votre méthode de communication habituelle, demandez aux agents d’épingler la nouvelle application dans leur espace de travail d’agent. Cela leur permet d’accéder à l’Explorateur de profils sur toutes les instances de l’espace de travail.
+ Dans l’espace de travail de l’agent, choisissez l’icône Plus, puis choisissez l’**onglet Épingler**, comme le montre l’image suivante.
![\[L’espace de travail de l’agent, l’option d’onglet Épingler.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/pin-tab.png)
## Fonctionnalités prises en charge
Une fois que vous avez terminé les étapes ci-dessus, l’Explorateur de profils prend en charge les recherches des contacts entrants. Les encodages suivants sont pris en charge :
+ Téléphone et chat : support complet
+ Attributs de contact personnalisés : prise en charge complète des attributs définis par l’utilisateur que l’Explorateur de profils lit. Vous pouvez définir des attributs définis par l’utilisateur dans un flux pour répondre à tous les cas d’utilisation par les clients. Par exemple :
```
{
"profileSearchKey": "_phone",
"profileSearchValue": "" }
```
Pour de plus amples informations, veuillez consulter [Remplissage automatique des profils des clients](auto-pop-customer-profile.md).
# Predictive Insights (version préliminaire)
*Predictive Insights* (version préliminaire) est une fonctionnalité d'Amazon Connect Customer Profiles qui utilise l'intelligence artificielle pour générer des recommandations de produits et de contenus personnalisées pour vos clients. En analysant les données d'interaction avec les clients, Predictive Insights vous aide à proposer des expériences plus pertinentes sur tous les points de contact avec les clients.
## Comment fonctionne Predictive Insights
Predictive Insights (version préliminaire) utilise des modèles d'IA pour analyser les modèles de comportement des clients et générer des recommandations en temps réel. Le service traite les données d'interaction avec vos clients, telles que l'historique des achats et l'activité de navigation, afin d'identifier les modèles et les préférences.
+ **Étape 1 :** Ajoutez des données d'interaction aux profils à l'aide des connecteurs de données existants pour former des modèles d'IA avec les données d'interaction avec vos clients
+ **Étape 2 :** Ajoutez le catalogue d'articles à S3 pour permettre aux profils clients d'accéder aux données de vos articles via AWS Management Console
+ **Étape 3 :** créer des recommandations en définissant des types de recommandations (articles similaires, articles fréquemment associés, articles populaires)
+ **Étape 4 :** appliquer les recommandations à l'ensemble de l'écosystème Amazon Connect, y compris les agents Agent Workspace, Flows et Connect AI
## Conditions préalables
+ **Activer le stockage des données dans les profils clients**
Pour entraîner des modèles d'IA à l'aide de vos profils clients, vous devez activer le stockage des données. Pour en savoir plus, reportez-vous à la section Customer Profile Data Store pour en savoir plus.
+ **KMS**
Vous avez configuré les profils clients pour chiffrer vos données sous un AWS KMS key.
+ **Profils de sécurité**
Vous avez configuré les profils de sécurité pour prendre en charge les autorisations Afficher (répertorier et afficher les informations prédictives), Créer (créer des recommandations), Supprimer (supprimer des recommandations) et Modifier (mettre à jour les recommandations) lorsque les informations prédictives sont activées.
## Avantages de l'utilisation de Predictive Insights
L'utilisation de Predictive Insights présente plusieurs avantages clés :
+ Améliorez l'expérience client grâce à des recommandations personnalisées
+ Augmentez les opportunités de vente grâce à des suggestions de produits pertinentes
+ Gagnez du temps aux agents en faisant apparaître automatiquement les recommandations pertinentes
+ Fournir des recommandations cohérentes sur tous les points de contact avec les clients
+ Mettez à jour les suggestions en temps réel à mesure que le comportement des clients change
# Commencez avec Predictive Insights
Pour commencer à utiliser Predictive Insights, procédez comme suit :
**Topics**
+ [Étape 1 : ajout de données d'interaction dans les profils clients](#add-interaction-data)
+ [Étape 2 : ajout des données du catalogue d'articles](#add-item-catalog-data)
+ [Étape 3 : Création d'informations prédictives](#create-predictive-insights)
+ [Étape 4 : Utilisation de Predictive Insights sur les canaux d'engagement client](#use-across-customer-engagement-channels)
## Étape 1 : ajout de données d'interaction dans les profils clients
Vous pouvez tirer parti des connecteurs de données existants dans les profils clients pour mapper les données d'interactions dans un objet d'analyse Web standard.
Pour de plus amples informations, veuillez consulter [Mappage du type d'objet pour Web Analytics Object](standard-loyalty-promotion-object-mapping-web-analytics.md).
## Étape 2 : ajout des données du catalogue d'articles
Vous pouvez représenter les produits individuels de votre catalogue au sein du domaine à l'aide des données du catalogue standard. Les données de ce catalogue existent au niveau du domaine et ne sont liées à aucun profil client spécifique. Il s'agit d'une représentation structurée de vos produits qui peut être exploitée pour des fonctionnalités de personnalisation. Vous pouvez importer les informations de votre produit ou article sous forme d'objets de domaine dans les profils clients à l'aide de connecteurs de données qui fournissent des options flexibles pour l'ingestion et la gestion des informations de votre catalogue, garantissant ainsi que les données de vos produits restent à jour et accessibles dans le système.
Pour de plus amples informations, veuillez consulter [Cartographie des types d'objets pour le catalogue d'articles](standard-loyalty-promotion-object-mapping-item-catalog.md).
## Étape 3 : Création d'informations prédictives
Amazon Connect vous permet de créer et de déployer des modèles d'IA spécialisés adaptés à vos besoins spécifiques en matière de recommandation de produits. Ces modèles peuvent être configurés via l'interface utilisateur Web Connect ou par programmation APIs pour correspondre à vos scénarios commerciaux uniques. Predictive Insights propose plusieurs types de recommandations :
1. **Recommandé pour vous** : fournit des recommandations personnalisées adaptées à un utilisateur spécifique. Les recommandations sont basées sur le comportement passé de l'utilisateur, tel que les événements liés au flux de clics, les événements d'achat, le contenu consommé, etc.
1. **Articles similaires** : utilise l'IA générative pour trouver des articles thématiquement similaires à un article existant dans le catalogue. Il est idéal pour les cas d'utilisation liés à la vente incitative ou à la substitution lorsque les clients souhaitent proposer des recommandations d'articles alternatifs à leurs utilisateurs.
1. **Articles fréquemment associés** : recommande des articles qui interagissent fréquemment avec un article existant dans le catalogue. Il est idéal pour les cas d'utilisation liés à la vente croisée ou à la recommandation d'articles complémentaires.
1. **Articles populaires** : conçus pour recommander les éléments avec lesquels les utilisateurs interagissent le plus souvent.
1. **Tendance actuelle** : recommande les articles ayant connu la plus forte augmentation de la vitesse d'engagement au cours de la période récente. Il est conçu pour faire apparaître des éléments présentant une viralité lors des interactions avec les utilisateurs.
**Note**
L'activation des modèles d'IA avec Predictive Insights est disponible en version préliminaire. Des prix supplémentaires peuvent s'appliquer à l'avenir.
**Limites d'articles par type de recommandation**
Le tableau suivant décrit le nombre maximum d'éléments pris en compte pour la génération de recommandations, en fonction du type de recommandation utilisé.
| **Type de recommandation** | **Description** | **Limite** |
| --- | --- | --- |
| Recommandé pour vous | Nombre maximum d'éléments pris en compte pour les informations prédictives | 40 millions |
| Objets similaires | Nombre maximum d'éléments pris en compte pour les informations prédictives | 10 millions |
| Tous les autres scénarios commerciaux | Nombre maximum d'éléments pris en compte pour les informations prédictives | 750 000 |
## Étape 4 : Utilisation de Predictive Insights sur les canaux d'engagement client
### Utilisation des recommandations relatives au profil client dans Connect Flows
Cette section décrit comment vous pouvez utiliser le bloc de flux Profils clients Obtenir des recommandations de profil pour enrichir l'expérience utilisateur lors d'un contact en générant des recommandations basées sur l'IA pour un profil en temps réel.
**Propriétés du bloc de flux**
Le bloc de flux **Get profile recommendations** possède les propriétés suivantes à configurer :
1. **ID de profil (obligatoire) :**
Un identifiant de profil est requis pour que ce bloc fonctionne. Le bloc de flux **Obtenir des recommandations de profil** génère des recommandations pour l'ID de profil fourni ici. Vous avez la possibilité de saisir manuellement l'ID du profil ou d'utiliser une valeur prédéfinie stockée dans un attribut. Si vous utilisez une valeur prédéfinie, assurez-vous de fournir l'ID du profil en utilisant le bloc **Get profile** précédent. Utilisez le bloc **Get profile** pour identifier le profil spécifique avant de générer des recommandations dans le bloc suivant.
1. **Nom du recommandant (obligatoire) :**
Un nom de recommandation est requis pour que ce bloc fonctionne. Il s'agit du nom du recommandeur que vous souhaitez utiliser pour générer des recommandations pour l'ID de profil donné. Vous ne pouvez utiliser que des recommandateurs actifs pour générer des recommandations.
1. **Nombre maximum de résultats (obligatoire) :**
Le nombre maximum de recommandations à générer pour l'ID de profil donné. Cela peut aller de 1 à 3 recommandations.
1. **Attributs de recommandation (obligatoires) :**
Définissez les attributs de la réponse aux recommandations qui doivent être conservés dans l'attribut contact.
1. **Identifiant de l'article :**
Il s'agit de l'ID d'élément fourni comme contexte supplémentaire pour générer des recommandations pour l'ID de profil donné. L'identifiant de l'article n'est requis que si vous utilisez un type de recommandation « *Articles similaires »* ou « *Articles fréquemment jumelés ».* Vous avez la possibilité de saisir manuellement l'ID du profil ou d'utiliser une valeur prédéfinie stockée dans un attribut. Si vous utilisez une valeur prédéfinie, assurez-vous de fournir l'ID de l'article en utilisant le bloc **Obtenir les attributs calculés** précédent. Utilisez le bloc **Obtenir les attributs calculés** pour identifier l'ID d'article spécifique avant de générer des recommandations dans le bloc suivant.
**Branches Flow Block**
Le bloc de flux **Obtenir des recommandations de profil** peut acheminer les contacts vers les branches suivantes :
1. **Succès :**
Les recommandations ont été générées avec succès pour l'ID de profil fourni. Les attributs de recommandation sélectionnés ont été conservés dans l'attribut de contact \$1.Customer.Recommendations.
1. **Erreur :**
Une erreur s'est produite lors de la tentative de génération de recommandations. Cela peut être dû à une erreur système ou à la configuration du bloc **Get profile recommendations**.
1. **Aucune n'a été trouvée :**
Aucune recommandation n'a pu être générée.
**Utilisation des recommandations du bloc**
La réponse aux recommandations est conservée dans l'attribut de contact \$1.Customer.Recommendations JSONPath sous forme de liste JSON d'objets de recommandation. Chaque objet de recommandation contiendra les **attributs de recommandation** sélectionnés.
L'exemple d'extrait de code Python suivant issu d'une fonction Lambda montre comment il peut être utilisé pour transformer les recommandations du bloc **Get profile recommendations** et les conserver dans d'autres attributs de contact afin que les recommandations puissent être utilisées dans les blocs suivants.
```
import boto3
import json
# Handle lambda request
def lambda_handler(event, context):
print("Contact flow data: ", event)
# Transform recommendations
recommendations = event['Details']['Parameters']['Recommendations']
contact_attributes = {}
for i, rec in enumerate(recommendations):
contact_attributes.update(flatten(rec, i))
# Set contact attributes using each recommendation attribute value
print("Setting contact attributes: ", contact_attributes)
try:
client = boto3.client('connect', region_name="us-west-2")
client.update_contact_attributes(
InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1],
InitialContactId=event['Details']['ContactData']['InitialContactId'],
Attributes=contact_attributes
)
print("Contact attributes set successfully.")
except Exception as e:
print("Error setting contact attributes: ", e)
# Success response
return {
'statusCode': 200,
'body': json.dumps('Success')
}
# Flatten a nested object into a simple string:string object
def flatten(recommendation, index):
flat = {}
for key, value in recommendation.items():
if isinstance(value, dict):
flat.update(flatten(value, index))
else:
flat[f"Rec{index}_{key}"] = str(value)
return flat
```
Une fois que vous avez configuré votre flux avec le bloc **Obtenir des recommandations de profil**, vous pouvez commencer à l'utiliser pour générer des recommandations pour vos clients lors de leurs contacts.
### Utilisation des recommandations relatives au profil client dans les campagnes sortantes
Vous pouvez intégrer Predictive Insights aux campagnes sortantes Amazon Connect afin de fournir des recommandations personnalisées par e-mail et SMS. Lorsque vous créez une campagne déclenchée par un événement, vous pouvez configurer la section Recommandations pour générer automatiquement des recommandations basées sur l'IA pour les profils clients associés à la campagne.
Cette intégration utilise le mappage d'objets Web Analytics comme catégorie d'événements pour capturer les données d'interaction avec les clients, ce qui permet au moteur de recommandation de fournir des suggestions pertinentes et ciblées en fonction du comportement du client.
Pour step-by-step obtenir des instructions sur la configuration des recommandations dans le cadre de campagnes déclenchées par des événements, consultez. [Création d’une campagne sortante à l’aide de déclencheurs d’événements](how-to-create-campaigns-using-event-triggers.md)
### Configuration des agents Connect AI pour les recommandations commerciales
Amazon Q in Connect améliore les capacités des agents grâce à son nouveau type d'agent « d'orchestration ». Cette fonctionnalité est particulièrement utile pour créer un agent commercial basé sur l'intelligence artificielle capable de fournir des recommandations d'articles, particulièrement utiles dans les scénarios de vente incitative et de vente croisée.
**Prise en main**
Pour commencer la mise en œuvre, accédez au AWS Management Console et naviguez jusqu'à Amazon Connect. Après vous être connecté à votre instance Connect via l'URL d'accès, recherchez Amazon Q dans le menu de gauche et sélectionnez AI agents. Vous trouverez un agent AI préconfiguré de type Orchestration (SalesAgent) à l'état de brouillon sur la page QiC sous Agents IA. Ce modèle est fourni avec toutes les configurations nécessaires pour les outils 1P et des exemples d'instructions pour les recommandations.
**Création de votre agent personnalisé**
Pour créer un agent commercial personnalisé, commencez par créer un nouvel agent AI de type orchestration et copiez-le à partir du SalesAgent modèle existant. Ce processus transfère tous les outils et configurations du modèle à votre nouvel agent.
**Personnalisation de l'agent**
Lorsqu'il s'agit de mettre à jour l'invite de l'agent, les administrateurs disposent de deux options principales. Ils peuvent soit ajouter leur invite d'agent existante à l'invite d'agent commercial et ajouter des instructions d'identification de vente incitative, soit repartir à zéro en supprimant l' SalesAgent invite et en créant une nouvelle invite d'orchestration basée sur leur agent publié actuel et en y ajoutant l'invite de l'agent commercial. Cette flexibilité permet de proposer des solutions sur mesure qui répondent aux besoins spécifiques de l'entreprise et aux exigences du domaine.
**Configuration et intégration des flux**
Après avoir finalisé la configuration de l'agent et l'avoir publiée, l'étape suivante consiste à créer un bot Amazon Lex sous Flows. Le flux entrant doit être mis à jour pour inclure le GetCustomerInput bloc avec le bot Lex créé, et le nouveau SalesAgent doit être sélectionné dans les options supplémentaires. Vous devrez ajouter à la fois le bloc de flux Customer Profile pour la récupération de l'ID de profil et le bloc de flux Set-Contact Attributes, en définissant CustomerId comme clé pour l'ID de profil et la valeur comme \$1Customer. ProfileId.
L'implémentation prend en charge à la fois les contacts par chat et les appels vocaux, les informations du client étant transmises facilement à l'agent QIC sur le robot Lex. Cette configuration complète permet des recommandations commerciales basées sur l'IA et des opportunités de ventes incitatives au sein de votre environnement Amazon Connect. La flexibilité du système permet une personnalisation en fonction des besoins spécifiques du secteur tout en conservant les fonctionnalités de base de l'assistance commerciale intelligente. Cette solution fournit un cadre permettant d'améliorer les interactions avec les clients grâce à des recommandations basées sur l'IA, afin de soutenir des opérations de vente et de service client plus efficaces. Les administrateurs peuvent affiner davantage la mise en œuvre en ajoutant des instructions spécifiques au domaine et en personnalisant les types de recommandations en fonction de leurs besoins commerciaux.
### Configuration SalesAgent à utiliser pour l'assistance des agents
Vous pouvez configurer le SalesAgent à utiliser dans le widget de chat Q in connect dans Agent Workspace. Pour ce faire, vous devez modifier 2 éléments principaux.
1. Mettez à jour l' AIAgent invite avec des instructions pour accéder à la transcription du contact.
1. Ouvrez l'invite associée à l'éditeur SalesAgent in Prompt et mettez-la à jour pour ajouter des instructions permettant d'accéder à la transcription du contact accessible par ` {{$.transcript}} `
1. Vous trouverez ci-dessous un exemple d'invite que vous pouvez ajouter à l' SalesAgentinvite.
```
**IMPORTANT**
**Guide on how to process requests and information:**
- The messages section contains YOUR conversation with the customer service agent
- Respond to the agent's questions/requests in the messages section
- The transcript below is background information about the agent's conversation with their customer
- Do not respond directly to the customer - you are helping the AGENT
Background context from agent-customer conversation.
The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do.
IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..."
{{$.transcript}}
```
1. Mettez à jour le AIAgent avec la nouvelle version d'invite et mettez à jour le cas d'utilisation de la configuration par défaut → Assistance de l'agent avec cet agent.
**Note**
Il est recommandé d'utiliser deux scénarios d'utilisation différents AIAGent pour la vente en libre-service et l'assistance aux agents, car les deux cas nécessitent des modifications mineures de l'invite. Pour ce faire, il suffit de cloner l'agent, de modifier simplement la version demandée et de mettre à jour la configuration par défaut pour qu'elle pointe vers les agents AI appropriés pour chaque cas d'utilisation.
1. Mettez à jour le flux de contacts entrants.
1. Supprimez le GetCustomerInput bloc et ajoutez le bloc de flux de l'assistant Connect à la place
1. Renseignez la configuration du bloc de flux avec l' AIAssistant ARN et sélectionnez le paramètre approprié AIAGent.
Vous pouvez désormais utiliser ce flux comme flux entrant habituel et le widget de chat Q in connect devrait être en mesure de fournir des recommandations pour aider à répondre à la demande de l'utilisateur.
## Considérations relatives aux données
Les sections suivantes fournissent des conseils sur la manière de faire correspondre les cas d'utilisation et d'évaluer l'état de préparation des données pour Predictive Insights.
### Avez-vous adapté vos cas d'utilisation à Predictive Insights ?
Les types de personnalisation de Predictive Insights peuvent répondre aux cas d'utilisation suivants :
+ Génération de recommandations personnalisées pour un utilisateur
+ Recommander des articles similaires ou connexes
+ Recommander des articles tendance ou populaires
+ Réorganisation des articles par ordre de pertinence
### Disposez-vous de suffisamment de données sur les interactions entre les articles ?
Pour tous les cas d'utilisation et types de personnalisation, vous devez avoir au moins 1 000 interactions avec des éléments pour 25 utilisateurs uniques avec au moins deux interactions chacun. Pour des recommandations de qualité, nous vous recommandons d'avoir au moins 50 000 interactions entre articles provenant d'au moins 1 000 utilisateurs, avec au moins deux interactions avec des articles chacun.
### Disposez-vous d'une architecture de diffusion d'événements en temps réel ?
Si vous avez la possibilité de diffuser des événements en temps réel sur Connect Customer Profiles, vous pourrez profiter de la personnalisation en temps réel. Avec certains types de personnalisation, Predictive Insights peut tirer des leçons de l'activité la plus récente de vos utilisateurs et mettre à jour les recommandations lorsqu'ils utilisent votre application.
### Vos données sont-elles optimisées pour Predictive Insights ?
Nous vous recommandons de vérifier les informations suivantes dans vos données :
+ Vérifiez les valeurs manquantes. Nous recommandons qu'au moins 70 % de vos enregistrements contiennent des données pour chaque attribut. Nous recommandons que les colonnes qui autorisent les valeurs nulles soient remplies à au moins 70 %.
+ Corrigez les inexactitudes ou les problèmes liés à vos données, tels que des conventions de dénomination incohérentes, des catégories dupliquées pour un élément, des incohérences IDs entre les ensembles de données ou des doublons. IDs Ces problèmes peuvent avoir un impact négatif sur les recommandations ou entraîner des comportements inattendus. Par exemple, vous pourriez avoir les deux « N/A” and “Not Applicable” in your data, but filter out recommendations based on only “N/A ». Les éléments marqués « Non applicable » ne seraient pas supprimés par le filtre.
+ Si un élément, un utilisateur ou une action peut comporter plusieurs catégories, comme un film comportant plusieurs genres, combinez les valeurs catégorielles dans un seul attribut et séparez chaque valeur par l'opérateur \$1. Par exemple, les données GENRES d'un film peuvent être Action \$1 Aventure \$1 Thriller.
+ Évitez d'avoir plus de 1 000 catégories possibles pour une colonne (sauf si la colonne contient des données uniquement à des fins de filtrage).
# Utilisez l’API Profils des clients Amazon Connect
Pour plus d’informations sur la gestion programmatique des domaines et des profils, consultez la [Référence des API Profils des clients Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
L' ListObjectTypeAttributeValues API donne accès aux valeurs distinctes les plus récentes pour tout attribut spécifié, ce qui la rend utile pour la validation des données en temps réel et les contrôles de cohérence au sein de vos types d'objets. Cette API fonctionne dans tous les domaines et prend en charge les types d'objets personnalisés et standard. L'API accepte le nom du type d'objet, le nom de l'attribut et le nom de domaine comme paramètres d'entrée et renvoie des valeurs allant jusqu'à la limite de stockage d'environ 350 Ko.
**Remarque :**
+ Nous stockons jusqu'à 350 Ko de valeurs d'attributs par champ, en priorisant d'abord les valeurs les plus récentes. Une fois cette limite atteinte, les anciennes valeurs seront automatiquement supprimées pour laisser de la place aux nouvelles entrées.
## GetObjectTypeAttributeValues API
L' GetObjectTypeAttributeValues API fournit des informations statistiques sur les attributs d'un type d'objet spécifique, mais elle est exclusivement disponible pour les domaines dans lesquels le magasin de données est activé. Cette API effectue des calculs quotidiens pour fournir des informations statistiques sur les valeurs de vos attributs, afin de vous aider à comprendre les modèles et les tendances de vos données. Les calculs statistiques sont effectués une fois par jour, fournissant un aperçu cohérent des caractéristiques de vos données attributaires.
**Remarque :**
+ Vous recevrez des valeurs nulles dans deux scénarios :
+ Au cours de la première période suivant l'activation du coffre-fort de données (sauf si un cycle de calcul se produit, qui a lieu une fois par jour).
+ Pour les attributs qui ne contiennent pas de valeurs numériques.
Nous vous recommandons d'utiliser la bibliothèque open source CustomerProfile JS lors de l'intégration des profils clients dans votre propre application d'agent. Pour plus d'informations, consultez le dépôt CustomerProfiles JS sur [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Pour plus d’informations sur l’intégration de vos applications existantes à Amazon Connect, utilisez [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams). Vous pouvez intégrer les composants du Panneau de configuration des contacts dans votre application.
# Comprendre IPv6 le support dans les profils clients Amazon Connect
## Connectivité publique
Tous les profils clients Amazon Connect APIs sont entièrement pris en charge IPv4 et IPv6 appels téléphoniques.
```
profile.Region.api.aws
```
**Par exemple :**
```
profile.us-east-1.api.aws
```
Pour la CLI AWS, vous devez utiliser ces points de terminaison de manière explicite :
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Les anciens APIs sont toujours disponibles en rétrocompatibilité. Ils ne prennent en charge que IPv4 les appels.
```
profile.Region.amazonaws.com
```
**Par exemple :**
```
profile.us-east-1.amazonaws.com
```
## Connectivité privée
Vous pouvez créer un point de terminaison d’un VPC pour le service Profils des clients Amazon Connect à l’aide de la console Amazon VPC ou de l’interface de la ligne de commande AWS (AWS CLI). Pour plus d'informations, consultez la section [Création d'un point de terminaison d'interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) dans le PrivateLink guide AWS.
Pour créer un point de terminaison d’un VPC pour Profils des clients Amazon Connect, utilisez le nom de service suivant :
```
com.amazonaws.Region.profile
```
**Par exemple :**
```
com.amazonaws.us-east-1.profile
```
Si vous activez le DNS privé pour le point de terminaison, vous pouvez envoyer des demandes d'API aux profils clients Amazon Connect en utilisant son nom DNS IPv4 et le nom DNS IPv6 pris en charge pour la région, par exemple profile.us-east-1.api.aws.
Sinon, l'ancien nom DNS de la région est également pris en charge en tant que IPv4 seul.
**Par exemple :**
```
profile.us-east-1.amazonaws.com
```
# Exemple : intégration par programmation de S3 aux Profils des clients Amazon Connect
À l'aide de l'[PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API Customer Profiles, vous pouvez créer par programmation des intégrations pour S3, Salesforce, Marketo, etc.
Dans cette rubrique, nous expliquons comment créer une intégration à S3 avec un intervalle de synchronisation de 15 minutes, la valeur minimale actuellement prise en charge.
## Étape 1 : créer un fichier JSON
Créez un fichier JSON avec le contenu suivant :
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
Pour personnaliser le fichier JSON avec vos propres valeurs, suivez les instructions suivantes :
+ `FlowName` : peut être STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime` : défini sur la `DateTime` actuelle, plus 5 minutes dans l’heure d’époque.
+ `FirstExecutionFrom` : accédez à S3, examinez la date du fichier et utilisez une date antérieure à la date la plus ancienne.
+ `Tasks` : définissez `TaskType`. Dans le champ `Sourcefields`, vous devez fournir TOUTES les colonnes que vous avez dans votre CSV dans ce tableau. Ensuite, pour chacun des éléments de ce tableau, vous devez spécifier l’`ConnectorOperator`. Cet exemple concerne un document CSV comportant deux colonnes : `colA` et `colB`.
## Étape 2 : appeler l' PutIntegration API
Après avoir créé et personnalisé le fichier JSON avec vos valeurs, appelez l'[PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, comme indiqué dans l'exemple suivant :
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
La réponse de `PutIntegration` renvoie un URI de flux. Par exemple :
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## Étape 3 : appelez l' AppFlow StartFlow API Amazon
Utilisez l'URI du flux pour appeler l' AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API Amazon. Par exemple :
```
aws appflow start-flow —flow-name uri --region us-west-2
```