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