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à.
# Integrazione delle applicazioni esterne con Amazon Connect Customer Profiles
Amazon Connect offre una serie di integrazioni predefinite basate su Amazon e AppFlow Amazon. EventBridge Dopo aver abilitato i Profili cliente Amazon Connect, è possibile utilizzare queste integrazioni per combinare informazioni provenienti da applicazioni esterne come Salesforce o Zendesk, con la cronologia dei contatti di Amazon Connect. Questo crea un profilo cliente che contiene tutte le informazioni di cui gli agenti hanno bisogno durante le interazioni con i clienti in un unico posto.
Puoi anche utilizzare i profili cliente in Amazon AppFlow. Amazon AppFlow supporta `CustomerProfiles` come destinazione. Puoi utilizzare Amazon AppFlow APIs per inviare dati ai profili dei clienti utilizzando `CustomerProfiles` come nome di destinazione.
Prima di iniziare, assicurati di utilizzare una chiave gestita dal cliente. Per ulteriori informazioni sulla configurazione di chiavi KMS, consulta [Creazione di una chiave KMS da utilizzare da Profili cliente per crittografare i dati (obbligatorio)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey).
## Configurazione di integrazioni
Puoi configurare un'integrazione utilizzando applicazioni in evidenza in Amazon Connect o applicazioni esterne utilizzando Amazon AppFlow scegliendo il metodo più adatto al tuo caso d'uso di seguito. Per informazioni più dettagliate sull'integrazione di ServiceNow e Slack, consulta il post del blog [Combina dati da più fonti utilizzando Amazon AppFlow e crea un profilo cliente Amazon Connect unificato per gli agenti dei contact center](https://aws.amazon.com/blogs/contact-center/unified-customer-data/).
**Topics**
+ [Configurazione di integrazioni](#setup-integrations-title-menu)
+ [Configurazione dell'integrazione per le applicazioni in evidenza in Amazon Connect](integrate-customer-profiles-appflow.md)
+ [Configura l'integrazione per applicazioni esterne utilizzando Amazon AppFlow](integrate-external-applications-appflow.md)
+ [Come eliminare Profili dei clienti o interrompere le integrazioni](delete-customer-profile-connection.md)
# Configurazione dell'integrazione per le applicazioni in evidenza in Amazon Connect
Queste integrazioni utilizzano le applicazioni in evidenza di Amazon Connect per fornire aggiornamenti periodici ai Profili cliente Amazon Connect.
## Prima di iniziare
### Inserimento di dati in blocco
Quando viene configurata l'integrazione, viene richiesto di inserire una data da cui desideri iniziare a inserire i dati. Se scegli una data che risale a più di due mesi fa, Profili cliente abilita automaticamente l'importazione in blocco creando più flussi. In questo modo non è necessario calcolare quanti flussi sono necessari per importare i dati.
Quando l'inserimento automatico in blocco è abilitato, Profili cliente esegue le seguenti operazioni:
+ Imposta la dimensione del batch su due mesi.
+ In caso di errori temporanei, riprova fino a tre volte prima di fallire.
Puoi utilizzare l'[CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API per richiamare la dimensione del tuo batch.
### Perché mi viene chiesto di selezionare o creare un ruolo IAM?
Per Salesforce, Marketo e ServiceNow Customer Profiles aiuta a migliorare l'acquisizione storica di queste fonti utilizzando il tuo ruolo IAM per creare diversi flussi di lavoro per inserire i tuoi dati in modo rapido ed efficiente.
Per queste origini, se selezioni più di 60 giorni indietro nel selettore della **data di importazione dei record**, verrà richiesto di creare un nuovo ruolo IAM o di selezionarne uno esistente. Questo ruolo consente a Profili cliente di gestire l'integrazione. Fornisce a Profili cliente le autorizzazioni necessarie per aggiornare e creare un flusso di lavoro per l'importazione dei dati. Una volta completato il flusso di lavoro, Profili cliente crea un'integrazione standard e continua che inserisce i nuovi dati man mano che vengono aggiornati nella fonte.
Il ruolo creato nella console è utilizzabile solo dal dominio in cui è stato creato. Questo perché Amazon Connect limita l'accesso del ruolo solo alla chiave KMS utilizzata dal dominio.
Per ulteriori informazioni, consulta [Garantisci l'accesso con privilegio minimo per il ruolo Profili cliente di esecuzione](#grant-least-privilege-cp).
## Garantisci l'accesso con privilegio minimo per il ruolo Profili cliente di esecuzione
Se desideri creare il ruolo IAM, si consiglia di utilizzare le autorizzazioni mostrate nel codice seguente per limitare il ruolo al minimo necessario. Usa lo snippet qui sotto per creare il ruolo manualmente. Usa la chiave KMS e specifica la regione dove necessario.
------
#### [ 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"
}
]
}
```
------
## Monitoraggio delle integrazioni di Profili cliente
Una volta stabilita la connessione, se smette di funzionare, elimina l'integrazione e ristabiliscila.
## Cosa fare se gli oggetti non vengono inviati
Se un oggetto non viene inviato, scegli **Dettagli del flusso** per saperne di più sul problema.
Potrebbe essere necessario eliminare la configurazione e riconnettersi all'applicazione esterna.
# Configurazione dell’integrazione per Amazon Connect Cases
Per aggiornare i dati dei tuoi Amazon Connect casi nei profili dei clienti di Amazon Connect e utilizzare funzionalità come gli attributi calcolati, puoi effettuare l'integrazione utilizzando Amazon AppIntegrations. Inizia configurando un flusso di eventi Cases per inviare i campi di sistema a un EventBridge bus, quindi usa Amazon AppIntegrations per inoltrare questi eventi ai profili dei clienti.
## Come trasmettere dati da Amazon Connect Cases a Event Bridge
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[L’alias dell’istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. Nel riquadro di navigazione, scegli **Casi** e annota l’ID di dominio Cases nella sezione **Dettagli del dominio**.
![\[Pagina Casi, sezione Dettagli dominio, freccia che indica l’ID del dominio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. Utilizzando AWS CLI, crea una configurazione di eventi Case per inviare Amazon Connect Cases Events al bus Event Bridge predefinito Account AWS del tuo.
```
// 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. Apri la console Event Bridge per la tua AWS regione. Ad esempio, [https://us-west-2.console.aws.amazon.com/events/a casa? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Scegliere **Create event bus (Crea bus di eventi)**.
![\[La pagina Event bus nella EventBridge console Amazon, il pulsante Crea bus di eventi.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Crea un router di eventi con il nome `connect-cases-to-customer-profiles`.
![\[La pagina Crea router di eventi, la casella Nome.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Torna al tuo **router di eventi predefinito** e crea una regola con un nome `connect-cases-to-customer-profiles-rule`.
![\[Il router di eventi predefinito, il pulsante Crea regola.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[La fase Crea un modello di evento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Frammento di un modello di evento:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[La sezione Metodo di creazione, l’opzione Modello personalizzato (editor JSON), il codice del Modello di evento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Scegli **Salta a revisione e crea**, quindi **Crea regola**.
![\[Il pulsante Vai alla revisione e alla creazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Inserisci i dati dei casi di Event Bridge nei profili dei clienti utilizzando AppIntegrations
1. Utilizzando AWS CLI, crea un'integrazione di eventi con AppIntegrations e registra l'output ARN. Rappresenta una fonte di dati che può essere utilizzata da un’istanza Amazon Connect.
```
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. Utilizzando AWS CLI, crea un'integrazione con i profili dei clienti utilizzando l'API put-integration. In questo modo verrà avviato il flusso di dati verso Profili dei clienti, sostituendo i valori segnaposto con l’ARN di integrazione eventi e il nome di dominio del Profilo cliente.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Verifica l’integrazione con Casi
1. Creazione di un caso in Amazon Connect Cases.
1. La consegna dell’evento dovrebbe essere quasi istantanea, ma occorre attendere un minuto per la consegna e l’associazione con il profilo cliente.
1. Usando AWS CLI, trova l'oggetto Connect-case sotto il profilo, sostituendo i segnaposto con i valori corretti.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Se non trovi un elemento nella risposta alla chiamata API precedente, è presente un problema con l’integrazione. Per risolvere i problemi:
1. Vai alla EventBridge console Amazon.
1. Verifica se EventSource è attivo e se la corrispondenza EventBus esiste ed è in esecuzione.
1. Verifica se la configurazione dell’evento del caso è configurata correttamente.
1. Se funzionano, contatta Supporto per ricevere assistenza per risolvere il problema.
# Configura l'integrazione di Amazon Connect con Salesforce ServiceNow, Marketo o Zendesk
Per fornire aggiornamenti periodici ai profili dei clienti Amazon Connect, puoi effettuare l'integrazione con Salesforce ServiceNow, Marketo o Zendesk utilizzando Amazon. AppFlow Per prima cosa configura la connessione in Amazon Connect e l'applicazione prescelta, quindi verifica l'integrazione.
## Configura la connessione in Amazon Connect e Salesforce ServiceNow, Marketo o Zendesk
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione, scegli **Profili dei clienti**.
1. Nella pagina **Configurazione dei profili dei clienti**, scegli **Aggiungi integrazione**, come mostrato nell'immagine seguente.
![\[La pagina di configurazione di Profili dei clienti, il pulsante Aggiungi integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Nella pagina **Seleziona origine dati**, scegli da quale applicazione esterna desideri ottenere i dati dei profili dei clienti. È possibile visualizzare i [requisiti di integrazione](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) per comprendere meglio i requisiti di connessione necessari per l'applicazione.
![\[La pagina Seleziona origine dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. Nella pagina **Stabilisci connessione**, scegli una delle opzioni seguenti:
+ **Usa una connessione esistente**: ciò ti consente di riutilizzare AppFlow le risorse Amazon esistenti che potresti aver creato nel tuo account AWS.
+ **Crea nuova connessione**: inserisci le informazioni richieste dall'applicazione esterna.
![\[La pagina Stabilisci connessione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. Nella pagina **Opzioni di integrazione**, scegli gli oggetti di origine che desideri importare e seleziona il relativo tipo di oggetto.
I tipi di oggetti archiviano i dati importati. Definiscono inoltre il modo in cui gli oggetti delle integrazioni vengono mappati sui profili quando vengono inseriti. Profili cliente fornisce modelli di tipi di oggetto predefiniti che è possibile utilizzare per definire il modo in cui gli attributi degli oggetti di origine vengono mappati agli oggetti standard nei profili dei clienti. Puoi anche utilizzare le mappature degli oggetti che hai creato da. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Quando aggiungi o crei l'integrazione Salesforce per la mappatura dei dati creata dall'utente, è necessario specificare la mappatura dei dati specifica, altrimenti verrà scelta la mappatura dei dati predefinita di Salesforce per il tipo di oggetto. È possibile creare la mappatura dei dati e utilizzarla quando viene configurato un connettore dati in evidenza.
![\[La pagina delle opzioni di integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Per la **Data di inizio importazione**, Profili cliente inizia a importare i record creati dopo questa data. Per impostazione predefinita, la data di importazione dei record è impostata su 30 giorni prima.
1. Nella pagina **Esamina e integra**, verifica che lo **Stato della connessione** sia **Connesso**, quindi scegli **Crea integrazione**.
![\[La pagina Esamina e integra.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Dopo aver configurato l'integrazione, torna alla pagina **Configurazione dei profili dei clienti**, scegli **Visualizza oggetti** per vedere quali dati vengono raggruppati e inviati. Attualmente, questo processo inserisce i record creati o modificati negli ultimi 30 giorni.
![\[La pagina Configurazione dei profili dei clienti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Configura l’integrazione per segmento al fine di fornire aggiornamenti periodici ad Amazon Connect Customer Profiles
Per fornire aggiornamenti periodici ai profili dei clienti di Amazon Connect, puoi effettuare l'integrazione con Segment utilizzando Amazon AppFlow. Per prima cosa configura la connessione in Amazon Connect e Segment, quindi verifica l'integrazione del segmento.
## Configurazione della connessione in Amazon Connect e Segment
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione, scegli **Profili dei clienti**.
1. Nella pagina **Configurazione dei profili dei clienti**, scegli **Aggiungi integrazione**.
![\[Nella pagina Configurazione dei profili dei clienti, pulsante Aggiungi integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Nella pagina **Seleziona origine dati**, scegli **Segmento**. Esamina i requisiti dell'applicazione elencati nella pagina **Seleziona applicazione**.
![\[La pagina Seleziona origine dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. Nella pagina **Stabilisci connessione**, scegli una delle opzioni seguenti:
+ **Usa la connessione esistente**: ciò ti consente di riutilizzare EventBridge le risorse Amazon esistenti che potresti aver creato nel tuo Account AWS.
+ **Crea nuova connessione**: inserisci le informazioni richieste dall'applicazione esterna.
![\[La pagina Stabilisci connessione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nome connessione**: specifica un nome per la connessione. Al nome della connessione fanno riferimento le integrazioni che utilizzano questa connessione.
+ **URL di connessione**: inserisci l'URL di connessione dell'applicazione. Questo URL viene utilizzato per il collegamento diretto agli oggetti creati nell'applicazione esterna. L'URL di connessione è l'URL del workspace Segment disponibile sul sito web dell'applicazione.
Per trovare l'URL del workspace:
1. Accedi all'account segment.com.
1. Vai a **Impostazioni**, **Impostazioni generali**.
1. Copia l'URL dal browser.
1. Customer Profiles utilizza Amazon EventBridge per le integrazioni con Segment. Nella pagina di **configurazione del codice sorgente**, copia il tuo Account AWS ID negli appunti, quindi scegli **Accedi al segmento per** configurare Amazon. EventBridge
1. Utilizza le seguenti istruzioni per configurare Segment:
1. Accedi a Segment.
1. Nella tua applicazione, seleziona una fonte per configurare la destinazione su Amazon EventBridge.
1. Incolla il tuo Account AWS ID e seleziona la tua AWS regione.
1. Attiva **ON** per attivare l'origine dell'evento partner.
1. Vai a **Tester evento** e invia un evento di prova per completare l'attivazione dell'origine dell'evento partner.
1. **ID client**: si tratta di una stringa che distingue in modo univoco il client nell'applicazione esterna. Questo ID client è il nome di origine disponibile sul sito web dell'applicazione. Utilizza l'ID specificato per identificare il client da cui desideri che Profili cliente importi oggetti.
Per trovare l'ID di origine:
1. Vai a **Origini** e scegli un'origine.
1. Vai a **Impostazioni**, **Chiavi API**.
1. Copia l'**ID origine**.
Dopo aver impostato la destinazione dell'origine dell'evento, torna alla console Profili cliente e incolla l'ID client.
1. Verrà visualizzato un avviso che indica che Amazon Connect si è connesso con successo a Segment.
1. Nella pagina **Opzioni di integrazione**, scegli gli oggetti di origine che desideri importare e seleziona il relativo tipo di oggetto.
I tipi di oggetti archiviano i dati importati. Definiscono inoltre il modo in cui gli oggetti delle integrazioni vengono mappati sui profili quando vengono inseriti. Profili cliente fornisce modelli di tipi di oggetto predefiniti che è possibile utilizzare per definire il modo in cui gli attributi degli oggetti di origine vengono mappati agli oggetti standard nei profili dei clienti. Puoi anche utilizzare le mappature degli oggetti che hai creato da. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[La pagina Opzioni di integrazione, la sezione Tipo di oggetto.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Per la **data di inizio dell'integrazione**, Profili cliente inizia a importare i record creati dopo l'aggiunta dell'integrazione.
**Nota**
Se hai bisogno di record storici, puoi [utilizzare Amazon S3 come fonte di integrazione per importarli](customer-profiles-object-type-mappings.md).
1. Nella pagina **Esamina e integra**, verifica che lo **Stato della connessione** sia **Connesso**, quindi scegli **Aggiungi integrazione**.
1. Dopo aver configurato l'integrazione, torna alla pagina **Configurazione dei profili dei clienti**, la pagina **Integrazioni** mostra le integrazioni attualmente configurate. **Ultima esecuzione** e **Stato dell'integrazione** non sono attualmente disponibili per questo tipo di integrazione.
![\[La pagina Configurazione dei profili dei clienti, la sezione Integrazioni.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Per vedere quali dati vengono inviati, scegli l'integrazione, quindi scegli **Visualizza oggetti**.
## Verifica l'integrazione del segmento
Per eseguire questa operazione sono necessari i seguenti prerequisiti:
+ Accedi al workspace Segment.
+ [Accesso al Pannello di controllo dei contatti di Amazon Connect](amazon-connect-contact-control-panel.md).
**Come verificare l'integrazione Segment**
1. Vai alla dashboard del workspace Segment e scegli **Destinazioni**.
![\[La pagina di panoramica dei segmenti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Verrà visualizzato un elenco di destinazioni a cui quel segmento invia dati. Scegli la EventBridge destinazione per i profili dei clienti.
![\[La pagina dell'elenco delle destinazioni.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Scegli la scheda **Tester evento**. Da questa pagina l'utente invia un evento di prova a Profili cliente. L'evento viene importato e trasformato in un profilo cliente che è visualizzabile nell'applicazione per agenti Amazon Connect.
![\[La scheda Tester evento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Seleziona **Identifica** come tipo di evento e seleziona **Event Builder** come metodo di input.
1. È possibile specificare un **ID utente** e alcune caratteristiche. Gli agenti possono cercare queste caratteristiche nell'applicazione dell'agente.
1. Scegli **Invia evento**.
1. La consegna dell'evento dovrebbe essere quasi istantanea, ma attendi un minuto per la consegna e crea un profilo cliente.
1. Apri l'applicazione agente Amazon Connect. Cerca l'ID utente che hai inserito in **Event Builder**. Dovresti visualizzare il profilo del cliente con l'ID utente e le caratteristiche che hai inserito.
1. Se il profilo del cliente non è visualizzabile, è presente un problema con l'integrazione. Per risolvere i problemi:
1. Vai alla EventBridge console Amazon.
1. Verifica se EventSource è attivo e se la corrispondenza EventBus esiste ed è in esecuzione.
Se funzionano, contatta Supporto per ricevere assistenza per risolvere il problema.
## Monitoraggio delle integrazioni di Profili cliente
Una volta stabilita la connessione, se smette di funzionare, elimina l'integrazione e ristabiliscila.
## Cosa fare se gli oggetti non vengono inviati
Se un oggetto non viene inviato, scegli **Dettagli del flusso** per saperne di più sul problema.
Potrebbe essere necessario eliminare la configurazione e riconnettersi all'applicazione esterna.
# Configura l’integrazione per Shopify per fornire aggiornamenti periodici aa Amazon Connect Customer Profiles
Per fornire aggiornamenti periodici ai profili cliente di Amazon Connect, puoi effettuare l'integrazione con Shopify utilizzando Amazon. AppIntegrations È necessario prima configurare la connessione in Amazon Connect e Shopify, quindi verificare l'integrazione con Shopify.
## Configurazione della connessione in Amazon Connect e Shopify
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione, scegli **Profili dei clienti**.
1. Nella pagina **Configurazione dei profili dei clienti**, scegli **Aggiungi integrazione**.
![\[La pagina di configurazione di Profili dei clienti, il pulsante Aggiungi integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. Nella pagina **Seleziona origine**, scegli **Shopify**. Esamina i requisiti dell'applicazione elencati nella pagina **Seleziona applicazione**.
![\[La pagina di selezione dell'origine.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. Nella pagina **Stabilisci connessione**, scegli una delle opzioni seguenti:
+ **Usa la connessione esistente**: ciò ti consente di riutilizzare EventBridge le risorse Amazon esistenti che potresti aver creato nel tuo Account AWS.
+ **Crea nuova connessione**: inserisci le informazioni richieste dall'applicazione esterna.
![\[La pagina Stabilisci connessione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nome connessione**: specifica un nome per la connessione. Al nome della connessione fanno riferimento le integrazioni che utilizzano questa connessione.
+ **URL di connessione**: inserisci l'URL di connessione dell'applicazione. Questo URL viene utilizzato per il collegamento diretto agli oggetti creati nell'applicazione esterna. L'URL di connessione è l'URL dell'app Shopify Partner disponibile sul sito web dell'applicazione.
Per trovare l'URL dell'app Shopify Partner:
+ Accedi all'account partners.shopify.com.
+ Vai all'app.
+ Copia l'URL dal browser.
+ **ID cliente**: immetti l'ID del client dell'applicazione. Questa è una stringa che distingue in modo univoco il client nell'applicazione esterna. Questo ID client è il nome di origine disponibile sul sito web dell'applicazione. Utilizza l'ID che specifichi qui per identificare il client da cui desideri che Profili cliente acquisisca gli oggetti. L'ID cliente potrebbe essere disponibile dopo aver seguito i passaggi di configurazione del codice sorgente.
Per trovare il nome dell'origine:
+ Accedi all'account partners.shopify.com.
+ Vai all'app.
+ Copia il nome della fonte dalla fonte del tuo EventBridge evento Amazon.
1. Nella pagina di **configurazione del codice sorgente**, copia il tuo Account AWS ID negli appunti, quindi scegli **Accedi a** Shopify.
1. Utilizza le seguenti istruzioni per configurare Shopify:
1. Accedi a partners.shopify.com.
1. In Amazon EventBridge, scegli **Crea sorgente**.
1. Incolla il tuo Account AWS ID e seleziona la tua AWS regione.
1. Dopo aver impostato la destinazione di origine dell'evento, torna a Profili cliente. Verrà visualizzato un avviso che indica che Amazon Connect si è connesso con successo a Shopify.
1. Nella pagina **Opzioni di integrazione**, scegli gli oggetti di origine che desideri importare e seleziona il relativo tipo di oggetto.
I tipi di oggetti archiviano i dati importati. Definiscono inoltre il modo in cui gli oggetti delle integrazioni vengono mappati sui profili quando vengono inseriti. Profili cliente fornisce modelli di tipi di oggetto predefiniti che è possibile utilizzare per definire il modo in cui gli attributi degli oggetti di origine vengono mappati agli oggetti standard nei profili dei clienti. Puoi anche utilizzare le mappature degli oggetti che hai creato da. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[La pagina delle opzioni di integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Per la **data di inizio dell'integrazione**, Profili cliente inizia a importare i record creati dopo l'aggiunta dell'integrazione.
**Nota**
Se hai bisogno di record storici, puoi [utilizzare Amazon S3 come fonte di integrazione per importarli](customer-profiles-object-type-mappings.md).
1. Nella pagina **Esamina e integra**, verifica che lo **Stato della connessione** sia **Connesso**, quindi scegli **Aggiungi integrazione**.
**Nota**
Dopo aver aggiunto questa integrazione, è necessario [configurare gli abbonamenti webhook](#shopify-webhook-subscriptions) per consentire agli eventi di iniziare a fluire in questa integrazione.
![\[La pagina Esamina e integra.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Dopo aver configurato l'integrazione, torna alla pagina **Configurazione dei profili dei clienti**, la sezione **Integrazioni** mostra le integrazioni attualmente configurate. **Ultima esecuzione** e **Stato dell'integrazione** non sono attualmente disponibili per questo tipo di integrazione.
![\[La sezione Integrazioni.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Per vedere quali dati vengono inviati, scegli l'integrazione, quindi scegli **Visualizza oggetti**.
1. Vai al passaggio successivo per utilizzare l'API per configurare gli **abbonamenti ai webhook** in modo che gli eventi possano iniziare a confluire in questa integrazione.
## Configurazione degli abbonamenti webhook
1. Utilizza il seguente URL per assicurarti che l'app disponga delle autorizzazioni richieste:
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Dove:
+ `shop` è il nome del negozio Shopify.
+ `api_key` è la chiave API dell'app Shopify. Puoi trovarla nella pagina dei dettagli dell'**app** Shopify.
+ `scopes` dovrebbe avere il valore `read_customers,read_orders,read_draft_orders`.
+ `redirect_uri` è l'URI di reindirizzamento che hai specificato per l'app al momento della creazione. Per i nostri scopi può essere qualsiasi URL valido.
+ `nonce` può essere qualsiasi valore univoco per identificare una determinata richiesta di autorizzazione da parte di altri. Si consiglia di utilizzare un timestamp.
Dopo aver creato l'URL, incollalo nel browser. Viene visualizzata una installation/authorization pagina simile all'immagine seguente, che chiede al proprietario del negozio di concedere le autorizzazioni per l'ambito definito.
![\[Un esempio di pagina Shopify per l’installazione e l’autorizzazione dell’app.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Scegli **Installa app non in elenco** per installare e autorizzare l'app per conto del tuo negozio.
Verrai indirizzato all'URI di reindirizzamento che hai inserito con un codice di autorizzazione aggiunto all'URI di reindirizzamento come parametro di query. Esempio:
```
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. Copia il `authorization_code` da questo URI. Lo utilizzerai per ottenere un token di accesso permanente nei passaggi successivi.
1. Usa lo strumento che usi per effettuare chiamate API. Ad esempio, [CURL](https://curl.se/) o [POSTMAN](https://www.postman.com/).
1. Per ottenere un token di accesso permanente, effettua una richiesta POST all'API `Admin` di Shopify su questo endpoint:
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
con il corpo della richiesta seguente:
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Questa richiesta restituisce la risposta seguente:
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Prendi nota di `access_token`. Si tratta di un token permanente che rientra nell'ambito fornito in un passaggio precedente. A questo punto è possibile creare abbonamenti webhook.
1. Per le seguenti chiamate API, assicurati di impostare la chiave di intestazione HTTP `X-Shopify-Access-Token` su quel `access_token` ricevuto dalla risposta della chiamata precedente.
1. Per configurare gli abbonamenti ai webhook, effettua la seguente richiesta POST per ciascuno dei valori `topic` elencati nel passaggio successivo:
Endpoint: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Corpo della richiesta:
```
{
"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. Per ogni abbonamento sostituisci il valore per `topic` con i seguenti valori:
+ `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`
Ora sei pronto per ricevere eventi dal negozio Shopify. Successivamente, verifica l'integrazione con Shopify.
## Verifica dell'integrazione con Shopify
1. Accedi come amministratore del negozio Shopify.
1. Dal menu di navigazione a sinistra, scegli **Utenti**.
1. Seleziona **Aggiungi cliente**.
1. Inserisci i dati del cliente. Assicurati di inserire un numero di telefono e un indirizzo e-mail. Non devono necessariamente appartenere a un cliente reale. Elimina questa voce relativa al cliente dopo aver verificato l'integrazione.
1. Salva l'oggetto del cliente.
1. La consegna dell'evento dovrebbe essere quasi istantanea, ma occorre attendere un minuto per la consegna e la creazione di un profilo cliente.
1. Apri l'esperienza agente Amazon Connect e cerca l'utente tramite l'e-mail o il numero di telefono che hai inserito nel negozio di Shopify. Dovresti visualizzare il profilo del cliente con lo stesso indirizzo e-mail o lo stesso numero di telefono.
1. Se il profilo del cliente non è visualizzabile, è presente un problema con l'integrazione. Per risolvere i problemi:
1. Vai alla EventBridge console Amazon.
1. Verifica se EventSource è attivo e se la corrispondenza EventBus esiste ed è in esecuzione.
Se funzionano, contatta Supporto per ricevere assistenza per risolvere il problema.
## Monitoraggio delle integrazioni di Profili cliente
Una volta stabilita la connessione, se smette di funzionare, elimina l'integrazione e ristabiliscila.
## Cosa fare se gli oggetti non vengono inviati
Se un oggetto non viene inviato, scegli **Dettagli del flusso** per saperne di più sul problema.
Potrebbe essere necessario eliminare la configurazione e riconnettersi all'applicazione esterna.
# Configura l'integrazione per applicazioni esterne utilizzando Amazon AppFlow
Queste integrazioni utilizzano Amazon AppFlow per fornire aggiornamenti periodici ai profili dei clienti Amazon Connect. I passaggi seguenti forniscono indicazioni sulla configurazione di un connettore di tua scelta tramite Amazon AppFlow, sulla configurazione delle mappature dei dati e sulla configurazione delle integrazioni per importare i dati dei tuoi clienti.
Per ulteriori informazioni sui AppFlow prezzi di Amazon, consulta la pagina AppFlow [dei prezzi](https://aws.amazon.com/appflow/pricing/) di Amazon.
Per ulteriori informazioni sui connettori AppFlow supportati da Amazon, consulta [Applicazioni di origine e destinazione supportate](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
## Prima di iniziare
Quando abiliti i Profili cliente Amazon Connect, crei un dominio Profili cliente, un container per tutti i dati, come i profili dei clienti, i tipi di oggetti, le chiavi del profilo e le chiavi di crittografia. Di seguito sono riportate le linee guida per la creazione di domini Profili cliente:
+ Ogni istanza Amazon Connect può essere associata a un solo dominio.
+ È possibile creare più domini, ma questi non condividono integrazioni di applicazioni esterne o dati dei clienti tra loro.
+ Tutte le integrazioni di applicazioni esterne vengono create a livello di dominio. Tutte le istanze Amazon Connect associate a un dominio ereditano le integrazioni del dominio.
**Prerequisito: abilitare i profili cliente nell'istanza Amazon Connect**
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
1. Nel riquadro di navigazione, scegli **Profili dei clienti**.
1. Scegli Abilita Profili cliente
Nel modulo, ti verrà richiesto di completare tutti i campi obbligatori per creare un dominio Profili cliente seguendo i passaggi seguenti:
1. **Configurazione del dominio**. È possibile creare un nuovo dominio e fornire un nome.
1. **Crittografia**. In Specifica chiave KMS, è possibile abilitare la crittografia selezionando una chiave AWS KMS esistente, creando una nuova chiave AWS KMS oppure scegliere **Seleziona dominio esistente.**
1. **Report degli errori**. È possibile fornire una coda DLQ, ovvero una coda SQS per gestire gli errori del profilo del cliente
1. Scegli **Invia** e verrà creato Profili cliente utilizzando le informazioni sulla cronologia dei contatti dell'istanza.
### Configura un'applicazione esterna tramite Amazon AppFlow
Puoi aggiungere un'integrazione di applicazioni esterne a un dominio Amazon Connect Customer Profiles utilizzando Amazon AppFlow seguendo i passaggi seguenti. Devi creare un flusso per la tua origine dati nella AppFlow console Amazon e impostare i profili cliente Amazon Connect come destinazione prima di continuare nella console Customer Profiles. Se un flusso è stato creato più di 14 giorni fa, è scaduto ed è necessario creare un nuovo flusso per l'integrazione.
Facoltativamente, puoi eseguire trasformazioni di dati come`Arithmetic`,`Filter`,,`Map`, `Map_all` `Mask` `Merge``Truncate`, e `Validate` quando utilizzi la CloudFormation `AWS::AppFlow::Flow Task` risorsa prima dell'ingestione.
1. Accedi alla tua console di AWS gestione, seleziona Amazon AppFlow e scegli **Create flow**.
![\[La AppFlow pagina Amazon.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. Inserisci il nome del flusso e una descrizione del flusso facoltativa.
![\[La pagina Dettagli del flusso.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. Puoi lasciare la sezione **Crittografia dei dati** così com'è poiché il tuo dominio Amazon Connect Customer Profiles ha già una AWS KMS chiave esistente che verrà utilizzata per questo flusso. Facoltativamente, è possibile creare tag e quindi scegliere **Avanti**.
![\[La sezione sulla crittografia dei dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. Seleziona un'applicazione esterna a tua scelta nel menu a discesa **Nome origine**, quindi seleziona il campo successivo pertinente. Ad esempio, se desideri configurare Slack, seleziona Slack dal menu a discesa Nome **Nome origine**. È possibile selezionare un flusso Slack esistente o creare una nuova connessione.
![\[La pagina di configurazione del flusso.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. Se hai scelto di creare una nuova connessione, è possibile quindi inserire i dettagli dell'applicazione esterna come nome utente, password e sottodominio. Puoi anche selezionare la AWS KMS chiave per la crittografia dei dati e inserire il nome della connessione per identificare questa connessione.
![\[La pagina di connessione a Slack.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. Se scegli di utilizzare una connessione esistente, è possibile selezionare l'oggetto specifico dell'applicazione esterna dal menu a discesa. Ad esempio, se scegli una connessione Slack esistente, è possibile selezionare **Conversazioni** come oggetto e quindi scegliere il canale Slack specifico che verrà utilizzato.
![\[La pagina dei dettagli dell'origine.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. Nella sezione **Dettagli della destinazione**, seleziona Amazon Connect come nome di destinazione nel menu a discesa e seleziona il dominio del profilo del cliente creato nel passaggio precedente relativo ai prerequisiti.
![\[La sezione Dettagli della destinazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. Seleziona un trigger di flusso scegliendo **Esegui su richiesta** o **Esegui flusso in base alla pianificazione**. Scegli **Next (Successivo)**.
+ **Esegui su richiesta** esegue il flusso solo quando lo attivi.
+ **Esegui il flusso pianificato** esegue il flusso in un momento specifico utilizzando una pianificazione. La frequenza di pianificazione è limitata a 5 minuti, 15 minuti o 1 ora.
![\[La sezione del trigger di flusso.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. Scegli **Mappa manualmente i campi** in **Metodo di mappatura**. Scegli i campi di origine dall'applicazione esterna, quindi scegli **Mappa direttamente i campi**.
![\[La sezione relativa al metodo di mappatura.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. Rivedi e scegli **Crea flusso**.
Per ulteriori informazioni sulla creazione di flussi nella AppFlow console Amazon, consulta [Creazione di flussi in Amazon AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html).
Per ulteriori informazioni sulla configurazione dell'applicazione esterna e di molte altre applicazioni supportate in Amazon AppFlow, consulta [Applicazioni di AppFlow origine e destinazione Amazon supportate](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
### Impostazione delle mappature dei dati per definire in che modo i dati delle applicazioni esterne vengono mappati su un profilo cliente
Una volta configurata AppFlow l'integrazione con Amazon, devi configurare le mappature dei dati nei profili dei clienti per definire in che modo i dati dell'applicazione esterna verranno mappati al profilo del cliente. Ciò consente di personalizzare i dati che desideri utilizzare per creare il profilo cliente unificato. Scegli la mappatura con attenzione, poiché non è possibile scegliere una mappatura diversa dopo aver creato l'integrazione.
Per informazioni più dettagliate sulle mappature dei dati, consulta [Mappatura dei tipi di oggetti.](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html)
1. Accedi alla tua console di AWS gestione, seleziona **Amazon Connect** e scegli Customer Profiles sotto l'alias dell'istanza di connessione.
![\[La pagina Profili cliente Amazon Connect.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. Scegli **Mappature dei dati**, quindi scegli **Crea mappatura dei dati**. Fornisci un nome e una descrizione per la mappatura dei dati.
![\[La scheda di mappatura dei dati, il pulsante di creazione della mappatura dei dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[La pagina di mappatura dei dati impostata.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. In **Opzioni di mappatura**, è possibile scegliere **Origine dati** come applicazione esterna, il **Nome del flusso** creato nella sezione precedente e il **Metodo di definizione dei dati** come *Destinazione di mappatura*. In **Mappatura della destinazione** è possibile scegliere i tipi di dati dei clienti che desideri definire per i profili cliente unificati. Scegli **Next (Successivo)**.
![\[La sezione delle opzioni di mappatura.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. Aggiungi gli attributi del cliente, del prodotto, del caso e dell'ordine con origine, destinazione e tipo di contenuto, quindi scegli **Avanti**.
![\[La pagina degli attributi di ordinamento della mappa.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. In **Specifica identificatori**, è possibile selezionare vari attributi dall'oggetto dell'origine dati che aiutano a distinguere i dati dagli altri oggetti dell'origine dati. È possibile selezionare gli attributi tra identificatori univoci, del cliente, del prodotto, del caso e dell'ordine. Per ulteriori informazioni sugli identificatori, consulta [Identificatori standard per l’impostazione degli attributi sulla chiave in Profili dei clienti](standard-identifiers.md).
![\[La pagina degli identificatori standard.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. Esamina e scegli **Crea mappatura dei dati**. Lo stato della mappatura dei dati verrà visualizzato come *Attivo*.
![\[Identificatori nel Passaggio 6: Specifica gli identificatori.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### Configurazione delle integrazioni per importare i dati dei clienti da un'applicazione esterna
Una volta completata la configurazione della mappatura dei dati per un'applicazione esterna, è necessario configurare l'integrazione dell'origine dati per importare i dati dei clienti.
1. Accedi alla Console di gestione AWS, seleziona **Amazon Connect** e scegli Profili cliente sotto l'alias dell'istanza di connessione.
1. Nella sezione **Integrazioni dell'origine dati** scegli **Aggiungi integrazione dell'origine dati**.
![\[Scheda Integrazioni dell'origine dati, pulsante Aggiungi integrazione dell'origine dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. Nel menu a discesa **Origine dati**, seleziona l'applicazione esterna e scegli **Avanti.** Hai anche la possibilità di scegliere **Crea nuovo flusso** che aprirà la AppFlow console Amazon in una nuova scheda.
![\[Sezione dell'origine dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. Nel menu a discesa **Nome flusso**, seleziona il flusso che desideri utilizzare dall'origine dati e scegli **Avanti**.
![\[Selezione del nome del flusso per stabilire una connessione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. Nel menu a discesa **Mappatura dei dati**, seleziona la mappatura dei dati dell'applicazione esterna per l'oggetto per definire in che modo l'origine dati viene mappata ai profili. Scegli **Next (Successivo)**.
![\[Seleziona la pagina di mappatura dei dati, la casella a discesa di mappatura.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. Esamina e scegli **Aggiungi integrazione dell'origine dati**. L'integrazione dell'origine dati dell'applicazione esterna verrà inizialmente mostrata come in sospeso prima di passare allo stato attivo.
![\[Pagina Esamina e integra, il pulsante Aggiungi integrazione dell'origine dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### Visualizzazione del profilo cliente unificato in CCP agenti di Profili cliente Amazon Connect
Gli agenti sono quindi in grado di visualizzare i dati dei clienti che sono stati importati da un'applicazione esterna accedendo a CCP agenti di Amazon Connect. Per ulteriori informazioni sulla connessione al CCP agenti di Amazon Connect, consulta [Applicazione agenti: tutto in un luogo](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application).
L’agente deve disporre delle autorizzazioni appropriate per il profilo di sicurezza per visualizzare Profili dei clienti e sarà in grado di eseguire ricerche utilizzando un nome e un valore chiave nella barra di ricerca dei profili.
Per ulteriori informazioni sulle autorizzazioni dei profili di sicurezza, consulta [Profili di sicurezza](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html).
Gli utenti esperti che desiderano creare la propria applicazione agente personalizzata e profili cliente incorporati possono utilizzare [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles), che fornisce una maggiore personalizzazione rispetto all’applicazione agente.
# Come eliminare Profili dei clienti o interrompere le integrazioni
**Nota**
L'eliminazione delle mappature eliminerà solo gli oggetti e i dati associati a quella mappatura specifica. Se a un profilo sono associati più oggetti, l'eliminazione di una mappatura specifica potrebbe non cancellare i dati del profilo. Se si desidera eliminare dati specifici, è necessario eliminare la mappatura, ma i profili potrebbero ancora esistere se contengono dati di altre mappature. Ciò potrebbe comportare costi aggiuntivi per i profili esistenti. Puoi eliminare un dominio e tutti i dati dai profili dei clienti, inclusi tutti i profili, utilizzando la [Amazon Connect console](delete-customer-profiles-domain.md) o l'[DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API.
**Metodo della console**
+ **Se in qualsiasi momento desideri interrompere l'acquisizione dei dati del profilo cliente, scegli integration/mapping e quindi scegli Elimina.**
+ Per eliminare le integrazioni, i profili cliente e tutti i dati del profilo cliente, puoi eliminare il dominio dei profili cliente nella console. Amazon Connect Per ulteriori informazioni, consulta [Eliminazione di un dominio di Amazon Connect Customer Profiles](delete-customer-profiles-domain.md).
**Metodo API**
+ Per eliminare i dati dei profili dei clienti per un'integrazione specifica, utilizza l'API `DeleteProfileObjectType`.
+ Per eliminare le integrazioni, i profili cliente e tutti i dati del profilo cliente, utilizza l'API `DeleteDomain`.
Per riabilitare l'inserimento dei dati del profilo cliente, esegui nuovamente i passaggi di configurazione.