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à.
# Esportazione dei dati unificati del profilo cliente
Amazon Connect Customer Profiles fornisce l'esportazione di dati in tempo reale di profili cliente unificati in un Amazon Kinesis Data Stream. È possibile abilitare il flusso di dati e ricevere automaticamente i dati per nuovi profili e aggiornamenti dei profili esistenti nel flusso di dati Amazon Kinesis.
Puoi conservare i dati dei tuoi sistemi di origine, come CRMs gli strumenti di automazione del marketing, up-to-date con le informazioni più recenti provenienti dai profili Amazon Connect dei clienti. Ad esempio, quando un cliente chiama il contact center per aggiornare il proprio indirizzo, un agente può apportare la modifica per aggiungere il nuovo indirizzo del cliente e le informazioni aggiornate sul profilo vengono inviate a un flusso di dati Kinesis in tempo reale.
Per configurarlo, è necessario abilitare **Esportazione dei dati** nella console Profili cliente.
## Abilita esportazione in tempo reale
**Per abilitare il flusso di dati per il dominio**
1. Apri la console Amazon Connect Customer Profiles.
1. Seleziona la scheda **Esportazione dei dati** e scegli **Abilita flusso di dati**
![\[L'esportazione dei dati in tempo reale abilita il flusso di dati Kinesis.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. Scegli **Abilita flusso di dati** e seleziona un flusso di dati Kinesis esistente dal menu a discesa, oppure scegli **crea un nuovo flusso di dati Kinesis** per aprire la console Kinesis e creare il flusso. Per ulteriori informazioni, consulta [Creazione e gestione di flussi](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
![\[L'esportazione dei dati in tempo reale abilita il flusso di dati Kinesis.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. Scegli il pulsante **Abilita il flusso di dati** per salvare le impostazioni.
## Disabilita l’esportazione in tempo reale
**Per disabilitare il flusso di dati per il dominio**
1. Apri la console Amazon Connect Customer Profiles.
1. Seleziona la scheda **Esportazione di dati** e scegli **Disabilita il flusso di dati**.
![\[L'esportazione dei dati in tempo reale disabilita il flusso di dati Kinesis.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/disable-real-time-export-1.png)
## Payload Kinesis di esportazione in tempo reale
**Esempio di evento di output in 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 versione attuale dello schema.
**EventId**
L'ID univoco dell'evento.
**EventTimestamp**
Timestamp dell'evento utilizzando lo ISO8601 standard.
**EventType**
Il tipo di evento esportato.
Valori: CREATED, UPDATED, HEALTH\$1CHECK
+ CREATO: L'evento di esportazione era destinato a. CreateProfile
+ AGGIORNATO: L'evento di esportazione era per un UpdateProfile.
+ HEALTH\$1CHECK: L'evento di esportazione era destinato a HealthCheck garantire che i profili dei clienti potessero funzionare correttamente in `putEvent` Kinesis Stream.
**DomainName**
Il dominio a cui appartiene l'evento. `/Domain` dell'evento
**ObjectTypeName**
Tipo di oggetto dell'evento
Valori: `_profile`, `_asset`, `_order`, `_case`. È inoltre possibile utilizzare un nome di modello predefinito, ad esempio `Salesforce-Account` un nome di oggetto personalizzato che è possibile creare utilizzando l'API. [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
**AssociatedProfileId**
ID del profilo standard a cui è associato l'oggetto. È presente solo se il tipo di oggetto non è `_profile`
**ProfileObjectUniqueKey**
L'identificatore univoco del ProfileObject generato dal servizio.
Tipo: String
**Object**
Il profilo standard o oggetto del profilo standard stesso.
**IsMessageRealTime**
Contrassegna per informare se il messaggio è in tempo reale o se è stato reindirizzato.
**Esempio di payload in 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
}
```
# Risolvi i problemi relativi all’esportazione di eventi in tempo reale sul flusso di dati di Kinesis
Potrebbe verificarsi un ritardo durante la prima esportazione degli eventi nel flusso di dati Kinesis. Questo fatto è dovuto al tempo necessario per propagare le autorizzazioni IAM per il ruolo collegato al servizio. Quando si verifica un problema effettivo, lo stato dello streaming può riscontrare uno stato di errore.
![\[Gli eventi non sono in grado di raggiungere il flusso di dati Kinesis di destinazione, poiché si riscontra uno stato di errore.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
Le seguenti sezioni mostrano i possibili messaggi di errore che potresti riscontrare. Fornisce inoltre la causa e la risoluzione di ogni problema.
## Errore: il flusso di dati Kinesis non è attivo. Controlla la configurazione e ricrea il flusso di eventi in un secondo momento
Il flusso di dati Kinesis di destinazione non è in stato `ACTIVE`. Questo può accadere quando il flusso di dati Kinesis viene creato o eliminato. Per risolvere l'errore, assicurati che il flusso di dati Kinesis sia in stato ACTIVE e riattivi l'impostazione del flusso di dati.
## Errore: il flusso di dati Kinesis non esiste. Ricrea il flusso di eventi con una destinazione flusso di dati Kinesis valida
Il flusso di dati Kinesis di destinazione viene eliminato. Per risolvere l'errore, riattiva il flusso di dati con un flusso di dati Kinesis esistente come destinazione.
## Errore: Il flusso di dati Kinesis viene limitato. Prendi in considerazione la possibilità di fornire una velocità di trasmissione effettiva di Kinesis più elevata in modo appropriato
Il flusso di dati Kinesis di destinazione è limitato (il provisioning è insufficiente). Per risolvere l'errore, assicurati che il flusso di dati Kinesis di destinazione abbia un numero sufficiente di partizioni, quindi riattiva il flusso di dati.
## Errore: la chiave KMS utilizzata per crittografare il flusso di dati Kinesis viene limitata. Valuta la possibilità di aumentare la quota di richieste KMS in modo appropriato
La chiave KMS utilizzata dal flusso di dati Kinesis viene limitata. Per risolvere l'errore, riattiva il flusso di dati.
## Errore: verifica la configurazione della chiave KMS del flusso di dati Kinesis
Profili cliente non riesce ad accedere alla chiave KMS utilizzata dal flusso di dati Kinesis. Ciò può accadere quando la chiave KMS ha una policy della chiave che nega l'accesso dal ruolo collegato al servizio Profili cliente o la chiave non è nello stato Abilitato. Per risolvere l'errore, assicurati che la policy delle chiavi KMS non neghi l'accesso dal ruolo collegato al servizio Profili cliente e che la chiave sia nello stato Abilitato. Riattiva il flusso di dati per risolvere l'errore.