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