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