

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.

# Exportez les données de votre profil client unifié
<a name="set-up-real-time-export"></a>

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
<a name="enable-real-time-export"></a>

**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
<a name="disable-real-time-export"></a>

**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
<a name="real-time-export-kinesis-payload"></a>

**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
<a name="real-time-export-troubleshooting"></a>

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
<a name="real-time-export-kinesis-not-active"></a>

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
<a name="real-time-export-kinesis-not-found"></a>

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
<a name="real-time-export-kinesis-throttling"></a>

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
<a name="real-time-export-kms-throttling"></a>

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
<a name="real-time-export-kms-error"></a>

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.