Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo dell’API di Amazon Connect Customer Profiles
Per informazioni su come gestire in modo programmatico domini e profili, consulta la [Documentazione di riferimento su Profili cliente Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
L' ListObjectTypeAttributeValues API fornisce l'accesso ai valori distinti più recenti per qualsiasi attributo specificato, il che la rende utile per la convalida dei dati in tempo reale e i controlli di coerenza all'interno dei tipi di oggetto. Questa API funziona su tutti i domini e supporta tipi di oggetti personalizzati e standard. L'API accetta il nome del tipo di oggetto, il nome dell'attributo e il nome di dominio come parametri di input e restituisce valori fino al limite di archiviazione di circa 350 KB.
**Nota:**
+ Archiviamo fino a 350 KB di valori di attributo per campo, dando priorità ai valori più recenti per primi. Una volta raggiunto questo limite, i valori precedenti verranno rimossi automaticamente per fare spazio a nuove immissioni.
## GetObjectTypeAttributeValues API
L' GetObjectTypeAttributeValues API fornisce informazioni statistiche sugli attributi all'interno di un tipo di oggetto specifico, ma è disponibile esclusivamente per i domini con Data Store abilitato. Questa API esegue calcoli giornalieri per fornire informazioni statistiche sui valori degli attributi, aiutandoti a comprendere modelli e tendenze dei tuoi dati. I calcoli statistici vengono eseguiti una volta al giorno, fornendo un'istantanea coerente delle caratteristiche dei dati degli attributi.
**Nota:**
+ Riceverai valori nulli in due scenari:
+ Durante il primo periodo dopo l'attivazione del data vault (a meno che non si verifichi un ciclo di calcolo, che avviene una volta al giorno).
+ Per gli attributi che non contengono valori numerici.
Ti consigliamo di utilizzare la libreria open source CustomerProfile JS per integrare i profili dei clienti nella tua applicazione agente. [Per ulteriori informazioni, consulta il repository CustomerProfiles JS su Github.](https://github.com/amazon-connect/amazon-connect-customer-profiles)
Per ulteriori informazioni su come integrare le app esistenti con Amazon Connect, utilizza [Flussi Amazon Connect](https://github.com/aws/amazon-connect-streams). Puoi incorporare i componenti del Pannello di controllo dei contatti (CCP) nell'app.
# Comprendere IPv6 il supporto nei profili dei clienti di Amazon Connect
## Connettività pubblica
Supporto IPv4 e IPv6 chiamate APIs completi per tutti i profili cliente Amazon Connect.
```
profile.Region.api.aws
```
**Ad esempio**:
```
profile.us-east-1.api.aws
```
Per la AWS CLI, è necessario utilizzare questi endpoint in modo esplicito:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
I vecchi APIs sono ancora disponibili come compatibilità con le versioni precedenti. Supportano solo IPv4 le chiamate.
```
profile.Region.amazonaws.com
```
**Ad esempio**:
```
profile.us-east-1.amazonaws.com
```
## Connettività privata
È possibile creare un endpoint VPC per il servizio Amazon Connect Customer Profiles utilizzando la console Amazon VPC o l’interfaccia della linea di comando AWS (AWS CLI). Per ulteriori informazioni, consulta [Creating an interface endpoint](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) nella AWS PrivateLink Guide.
Crea un endpoint VPC per Amazon Connect Customer Profiles utilizzando il seguente nome di servizio:
```
com.amazonaws.Region.profile
```
**Ad esempio**:
```
com.amazonaws.us-east-1.profile
```
Se abiliti il DNS privato per l'endpoint, puoi effettuare richieste API ai profili dei clienti di Amazon Connect utilizzando il nome DNS corrispondente IPv4 e IPv6 supportato per la regione, ad esempio profile.us-east-1.api.aws.
In alternativa, anche il vecchio nome DNS della regione è supportato come unico nome. IPv4
**Ad esempio**:
```
profile.us-east-1.amazonaws.com
```
# Esempio: integrazione programmatica di S3 con Amazon Connect Customer Profiles
Utilizzando l'[PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API Customer Profiles, puoi creare in modo programmatico integrazioni per S3, Salesforce, Marketo e altro.
In questo argomento viene mostrato come creare un'integrazione S3 con un intervallo di sincronizzazione di 15 minuti, il valore minimo attualmente supportato.
## Passaggio 1: Creazione di un file JSON
Crea un file JSON con i seguenti contenuti:
```
{
"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"}
]
}
}
```
Per personalizzare il JSON con valori, seguire le linee guida riportate di seguito:
+ `FlowName`: Può essere STRING [a-zA-Z0-9] [\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`: Imposta sull'attuale valore di `DateTime` \$1 5 minuti nell'ora dell'epoca.
+ `FirstExecutionFrom`: Vai su S3, controlla la data del file e usa una data precedente alla data più vecchia.
+ `Tasks`: Definisci `TaskType`. Nel campo `Sourcefields` fornisci TUTTE le colonne presenti nel file CSV in quell'array. Quindi, per ciascuno degli elementi di quell'array, specifica i l`ConnectorOperator`. Questo esempio riguarda un documento CSV con due colonne: `colA` e `colB`.
## Fase 2: Chiama l'API PutIntegration
Dopo aver creato e personalizzato il file JSON con i tuoi valori, chiama l'[PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, come mostrato nell'esempio seguente:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
La risposta da `PutIntegration` restituisce un URI di flusso. Esempio:
```
{
"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": {}
}
```
## Fase 3: Chiama l' AppFlow StartFlow API Amazon
Usa l'URI del flusso per chiamare l' AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API Amazon. Esempio:
```
aws appflow start-flow —flow-name uri --region us-west-2
```