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à.
# Blocco di flusso in Amazon Connect: Profili dei clienti
Questo argomento definisce il blocco di flusso per il recupero, la creazione e l’aggiornamento di un profilo cliente.
## Description
+ Consente di recuperare, creare e aggiornare un profilo cliente.
+ Puoi configurare il blocco per recuperare i profili utilizzando fino a cinque identificatori di ricerca di tua scelta.
+ Consente di recuperare l'oggetto e gli attributi calcolati di un profilo del cliente.
+ Puoi configurare il blocco per recuperare gli oggetti utilizzando un identificatore di ricerca di tua scelta.
+ Devi fornire un ID profilo in questo blocco. Puoi fornire un **profileID** manualmente o utilizzare il **profileID** salvato nello spazio dei nomi Customer dopo aver trovato un profilo utilizzando l'azione **Ricevi profilo**.
+ Consente di associare il contatto, ad esempio voce, chat e attività, a un profilo del cliente esistente.
+ Quando vengono recuperati di dati del profilo cliente, i **Campi di risposta** vengono archiviati negli [attributi del contatto per tale cliente](connect-attrib-list.md#customer-profiles-attributes) consentendone l'utilizzo nei blocchi successivi.
+ È inoltre possibile fare riferimento ai **campi di risposta** utilizzando quanto segue JSONPath: `$.Customer.` Ad esempio, e. `$.Customer.City` `$.Customer.Asset.Status`
+ Gli esempi seguenti mostrano come utilizzare questo blocco:
+ Utilizza un blocco [Riproduci comando](play.md) dopo aver recuperato un profilo per fornire un'esperienza di chiamata o chat personalizzata facendo riferimento ai campi del profilo supportati.
+ Utilizza un blocco [Verifica attributi contatto](check-contact-attributes.md) dopo aver recuperato i dati del profilo per instradare un contatto dipendente dal valore.
+ Per ulteriori dettagli, consulta [Come mantenere i campi durante tutto il flusso](#customer-profiles-block-persist-fields).
## Canali supportati
La tabella seguente elenca il modo in cui questo blocco instrada un contatto che utilizza il canale specificato.
| Canale | Supportato? |
| --- | --- |
| Voce | Sì |
| Chat | Sì |
| Operazione | Sì |
| Email | Sì |
## Tipi di flusso
È possibile utilizzare questo blocco nei seguenti [tipi di flusso](create-contact-flow.md#contact-flow-types):
+ Tutti i tipi di flusso
## Consigli per la configurazione
+ Prima di utilizzare questo blocco, assicurati che Profili dei clienti sia abilitato per l'istanza Amazon Connect. Per istruzioni, consulta [Utilizzo dell’API di Amazon Connect Customer Profiles](customer-profiles.md).
+ Un contatto viene instradato lungo il ramo **Errore** nelle seguenti situazioni:
+ Profili dei clienti non è abilitato per l'istanza Amazon Connect.
+ I valori dei dati della richiesta non sono validi. I valori della richiesta non possono superare i 255 caratteri.
+ La richiesta API Profili dei clienti è stata limitata.
+ Profili dei clienti presenta problemi di disponibilità.
+ La dimensione totale degli [attributi Customer Profiles del contatto](connect-attrib-list.md#customer-profiles-attributes) è limitata a 14.000 caratteri (56 attributi ipotizzando una dimensione massima di 255 ciascuno) per l'intero flusso. Ciò include tutti i valori mantenuti come **Campi di risposta** nei blocchi Profili cliente durante il flusso.
## Properties
I seguenti tipi di proprietà sono disponibili nel blocco di flusso Profili cliente:
+ **[Ricevi profilo](#customer-profiles-block-properties-get-profile)**
+ **[Crea profilo](#customer-profiles-block-properties-create-profile)**
+ **[Aggiorna profilo](#customer-profiles-block-properties-update-profile)**
+ **[Ottieni oggetto profilo](#customer-profiles-block-properties-get-profile-object)**
+ **[Ottieni attributi calcolati](#customer-profiles-block-properties-get-calculated-attributes)**
+ **[Associa il contatto al profilo](#customer-profiles-block-properties-associate.title)**
## Proprietà: Ricevi profilo
Durante la configurazione delle proprietà su **Ricevi profilo**, considera quanto segue:
+ È necessario fornire almeno un identificatore di ricerca, fino a un totale di cinque.
+ Se vengono forniti più identificatori di ricerca, è necessario fornire un operatore logico, **AND** o **OR**. L’operatore logico viene applicato a tutti gli identificatori di ricerca, come una delle espressioni seguenti:
+ (a **AND** b **AND** c)
+ (x **OR** y **OR** z)
+ Definisci gli attributi in modo che vengano mantenuti nei blocchi successivi, archiviandoli negli attributi del contatto in **Campi di risposta**.
+ I contatti possono essere instradati lungo le seguenti ramificazioni
+ **Operazione riuscita:** è stato trovato un profilo. I campi di risposta vengono archiviati negli attributi del contatto
+ **Errore:** si è verificato un errore durante la ricerca del profilo. Ciò può essere dovuto a un errore di sistema o al modo in cui si configura **Ricevi profilo**.
+ **Trovato più volte:** sono stati trovati più profili.
+ **Nessuno trovato:** non è stato trovato alcun profilo.
Nell'immagine seguente viene mostrato un esempio di pagina delle **proprietà** dei Profili cliente configurata per l'azione **Ricevi profilo**.
L’esempio visualizzato è configurato per cercare profili che corrispondono al numero di **telefono** del chiamante o condividono lo stesso numero **account** archiviato nell’attributo definito dall’utente denominato “Account”. Quando viene individuato un profilo, i seguenti campi vengono memorizzati negli attributi di contatto per quel cliente specifico: **campi di risposta** - **AccountNumber**, **FirstName**LastName**PhoneNumber******, e **Attributi. LoyaltyPoints**.
![\[La pagina delle proprietà del GetProfile blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile.png)
## Proprietà: Crea profilo
Durante la configurazione delle proprietà per **Crea profilo**, considera quanto segue:
+ Specifica gli attributi che intendi compilare durante la creazione del profilo nei **Campi di richiesta**
+ Definisci gli attributi in modo che vengano mantenuti nei blocchi successivi, archiviandoli negli attributi del contatto in **Campi di risposta**.
I contatti possono essere instradati lungo i seguenti rami:
+ **Operazione riuscita:** un profilo è stato correttamente creato e i **Campi di risposta** vengono archiviati negli attributi del contatto.
+ **Errore:** si è verificato un errore durante il processo di creazione del profilo, probabilmente a causa di un errore di sistema o di una configurazione errata dell'azione **Crea profilo**.
Il seguente blocco di esempio è configurato per creare un profilo con un **PhoneNumber**attributo personalizzato denominato «Lingua». Dopo la creazione del profilo, il campo di risposta **Attributes.Language** viene archiviato negli attributi del contatto, rendendolo disponibile per l'utilizzo nei blocchi successivi.
![\[La pagina delle proprietà del CreateProfile blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-create-profile.png)
## Proprietà: Aggiorna profilo
Durante la configurazione delle proprietà per **Aggiorna profilo**, considera quanto segue:
+ Prima di utilizzare un blocco **Aggiorna profilo**, utilizza il blocco **Ricevi profilo**, come mostrato nell’immagine seguente. Utilizza il blocco **Ricevi profilo** per individuare il profilo specifico che intendi aggiornare.
![\[La pagina delle proprietà del UpdateProfile blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-update-profile-1.png)
+ Fornisci gli attributi e i valori per cui desideri aggiornare il profilo con i **Campi di richiesta** e i **Valori dei campi di richiesta**.
+ Definisci gli attributi in modo che vengano mantenuti nei blocchi successivi, archiviandoli negli attributi del contatto in **Campi di risposta**.
I contatti possono essere instradati lungo i seguenti rami:
+ **Operazione riuscita:** il profilo è stato correttamente aggiornato e i **Campi di risposta** vengono archiviati negli attributi del contatto.
+ **Errore:** si è verificato un errore durante il tentativo di aggiornamento del profilo. Ciò può essere riconducibile a un errore di sistema o ad una configurazione errata dell'azione **Aggiorna profilo**.
Il blocco visualizzato di seguito è configurato per aggiornare un profilo con **MailingAddress1** con l'input dell'utente come valore. Quando un profilo viene aggiornato, il campo di risposta **MailingAddress1** viene memorizzato negli attributi di contatto, rendendolo disponibile per l'uso nei blocchi successivi.
![\[La pagina delle proprietà del UpdateProfiles blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-update-profile-2.png)
## Proprietà: Verifica l’appartenenza al segmento
**Importante**
Per utilizzare questa azione, la tua istanza Amazon Connect deve disporre dell'autorizzazione per quanto segue APIs: ListSegmentDefinitions GetSegmentMembership BatchGetProfile,, e BatchGetCalculatedAttributeForProfile in una delle seguenti politiche: **AmazonConnectServiceLinkedRolePolicy**o **AmazonConnectServiceCustomerProfileAccess**.
**Importante**
Se stai controllando l'appartenenza a un segmento basato su Spark SQL, il segmento controllato è l'ultimo segmento creato e non aggiornato in tempo reale. Gli attributi lastComputedAt API indicano l'ultima volta in cui è stata creata l'istantanea del segmento. È possibile eseguire una nuova istantanea del segmento per aggiornare il segmento. Se ricevete un errore 4XX, assicuratevi di aver creato un'istantanea del segmento.
Quando configuri le proprietà per **verificare l’appartenenza al segmento**, tieni presente quanto segue:
+ **ID profilo obbligatorio:** un ID profilo è richiesto per il funzionamento di questo blocco. L'azione **Ottieni oggetto profilo** recupera un oggetto associato al **ProfileID** fornito. Assicurati di fornire il **ProfileID** utilizzando un blocco **Ricevi profilo** precedente. Utilizza il blocco **Ricevi profilo** per individuare il profilo specifico prima di procedere e recuperare l’oggetto del profilo nel blocco successivo.
+ È possibile inserire manualmente l’ID profilo o utilizzare un valore predefinito archiviato in un attributo predefinito o utente.
L’immagine seguente mostra un esempio di flusso configurato per ottenere il profilo e quindi controllare l’appartenenza al segmento.
![\[Un flusso con un’azione Ottieni profilo e quindi un’azione Verifica l’appartenenza al segmento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-1.png)
+ È necessario fornire un valore per il segmento. È possibile selezionare manualmente il segmento o impostarlo dinamicamente utilizzando un valore predefinito archiviato in un attributo predefinito o utente.
+ Quando imposti un segmento dinamicamente, fornisci un attributo che si riferisce all’identificativo del segmento di clienti. Puoi trovare l'identificatore nella pagina **Visualizza i dettagli del segmento** o, come SegmentDefinitionName nell'[ListSegmentDefinitions](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListSegmentDefinitions.html)operazione, nell'API Customer Profiles.
L’immagine seguente mostra la posizione dell’**ID del segmento** nella pagina **Visualizza i dettagli del segmento**.
![\[La sezione dei dettagli del segmento, l’ID del segmento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-2.png)
+ L’immagine seguente mostra un esempio di verifica dell’appartenenza ai segmenti. L’**ID profilo** è impostato per essere controllato dinamicamente e **Segmenta** manualmente.
![\[Il blocco Profili dei clienti è configurato per verificare l’appartenenza al segmento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-3.png)
**I contatti possono essere instradati lungo le seguenti ramificazioni**
+ **Nel segmento**: il profilo appartiene al segmento dei clienti.
+ **Non nel segmento**: il profilo non appartiene al segmento dei clienti.
+ **Errore**: si è verificato un errore durante il tentativo di verificare l’appartenenza al segmento. Ciò può essere dovuto a un errore di sistema o a una configurazione errata dell’azione **Verifica l’appartenenza al segmento**. Per ulteriori informazioni sulla registrazione di log, consulta [Abilita i log di flusso di Amazon Connect in un gruppo di CloudWatch log Amazon](contact-flow-logs.md).
## Proprietà: Ottieni oggetto profilo
Durante la configurazione delle proprietà per **Ottieni oggetto profilo**, considera quanto segue:
+ **ID profilo obbligatorio:** un ID profilo è richiesto per il funzionamento di questo blocco. L'azione **Ottieni oggetto profilo** recupera un oggetto associato al **ProfileID** fornito. Assicurati di fornire il **ProfileID** utilizzando un blocco **Ricevi profilo** precedente, come illustrato nell'immagine seguente. Utilizza il blocco **Ricevi profilo** per individuare il profilo specifico prima di procedere e recuperare l'oggetto del profilo nel blocco successivo.
+ È possibile inserire manualmente l’ID profilo o utilizzare un valore predefinito archiviato in un attributo predefinito o utente.
![\[La pagina delle proprietà del GetProfileOject blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile-object-1.png)
+ È necessario indicare il tipo di oggetto da cui si intende recuperare le informazioni.
+ Per il recupero di oggetti, è necessario scegliere una delle seguenti opzioni:
+ **Utilizza l'oggetto profilo più recente:** questa opzione recupera costantemente l'oggetto più recente.
+ **Utilizza l'identificatore di ricerca:** questa opzione implica la ricerca e il recupero dell'oggetto utilizzando l'identificatore di ricerca fornito.
+ Definisci gli attributi in modo che vengano mantenuti nei blocchi successivi, archiviandoli negli attributi del contatto in **Campi di risposta**.
I contatti possono essere instradati lungo i seguenti rami:
+ **Operazione riuscita:** l'oggetto del profilo è stato correttamente localizzato e i **Campi di risposta** vengono archiviati negli attributi del contatto.
+ **Errore:** si è verificato un errore durante il tentativo di recuperare l'oggetto del profilo. Ciò può essere dovuto a un errore di sistema o a una configurazione errata dell'azione **Ricevi profilo**.
+ **Nessuno trovato:** non è stato trovato alcun oggetto.
Il blocco visualizzato di seguito è configurato per recuperare un oggetto di profilo di tipo «Asset» associato a quello **ProfileId**salvato nello spazio dei nomi «Cliente». In questo scenario specifico, il blocco cercherà un Asset utilizzando l'ID asset. **Dopo aver individuato l'Asset, Asset.Price e **Asset**. PurchaseDate**vengono memorizzati negli attributi dei contatti, rendendoli disponibili per i blocchi successivi.
![\[La pagina delle proprietà del GetProfileObject blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile-object-2.png)
## Proprietà: Ottieni attributi calcolati
**Importante**
Per utilizzare questa azione, la tua istanza Amazon Connect deve disporre dell'autorizzazione per quanto segue APIs: `ListCalculatedAttributeDefinitions` e `GetCalculatedAttributeForProfile` in una delle seguenti politiche: **AmazonConnectServiceLinkedRolePolicy**o **AmazonConnectServiceCustomerProfileAccess**.
Durante la configurazione delle proprietà per **Ottieni attributi calcolati**, considera quanto segue:
+ **ID profilo obbligatorio:** un ID profilo è richiesto per il funzionamento di questo blocco. L'azione **Ottieni attributi calcolati** recupera un oggetto associato al **ProfileID** fornito. Assicurati di fornire il **ProfileID** utilizzando un blocco **Ricevi profilo** precedente, come illustrato nell'immagine seguente. Utilizza il blocco **Ricevi profilo** per individuare il profilo specifico prima di procedere per recuperare gli attributi calcolati del profilo nel blocco successivo.
+ È possibile inserire manualmente l’ID profilo o utilizzare un valore predefinito archiviato in un attributo predefinito o utente.
![\[La pagina delle proprietà del GetCalculatedAttributes blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-get-calculated-attributes-1.png)
+ Definisci gli attributi in modo che vengano mantenuti nei blocchi successivi, archiviandoli negli attributi del contatto in **Campi di risposta**.
+ Le opzioni nei **Campi di risposta** sono le definizioni degli attributi calcolati definite per il dominio Profili cliente
+ Se la definizione degli attributi calcolati utilizza una soglia, il valore dell'attributo calcolato deve essere un booleano e restituire Vero/Falso. In caso contrario, verrà restituito un valore numerico o stringa. Il valore restituito dell’attributo calcolato può essere utilizzato per scopi di ramificazione in un blocco **Verifica attributi contatti** utilizzando condizioni quali **Uguale,** **Maggiore di**, **Minore di** e **Contiene**.
I contatti possono essere instradati lungo i seguenti rami:
+ **Operazione riuscita:** viene trovato un attributo calcolato e i campi di risposta vengono archiviati negli attributi del contatto.
+ **Errore:** si è verificato un errore durante il tentativo di recuperare l'attributo calcolato. Ciò può essere dovuto a un errore di sistema o a una configurazione errata dell'azione **Ottieni attributo calcolato**.
+ **Nessuno trovato:** non è stato trovato alcun attributo calcolato.
Il blocco visualizzato di seguito è configurato per ottenere attributi calcolati appartenenti agli attributi forniti **ProfileId**in contact. I seguenti **Campi di risposta** verranno recuperati e archiviati negli attributi del contatto: **Durata chiamata media** e **Chiamante frequente**.
![\[La pagina delle proprietà del GetCalculatedAttributes blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-get-calculated-attributes-2.png)
## Proprietà: Associa il contatto al profilo
**Importante**
Per utilizzare questa azione, la tua istanza Amazon Connect deve disporre dell'autorizzazione per quanto segue APIs: `ListCalculatedAttributeDefinitions` e `GetCalculatedAttributeForProfile` in una delle seguenti politiche: **AmazonConnectServiceLinkedRolePolicy**o **AmazonConnectServiceCustomerProfileAccess**.
Per utilizzare questa azione, è necessario anche abilitare l'autorizzazione Profili cliente - Visualizza nel profilo di sicurezza.
Durante la configurazione delle proprietà per **Associa il contatto al profilo**, considera quanto segue:
+ Aggiungi un blocco **Ricevi profilo** prima di **Associa il contatto al profilo**, come mostrato nell'immagine seguente. Utilizza il blocco **Ricevi profilo** per trovare prima il profilo, quindi associa il contatto e il profilo nel blocco successivo.
+ **ID profilo obbligatorio:** un ID profilo è richiesto per il funzionamento di questo blocco. Assicurati di fornire il **ProfileID** utilizzando un blocco **Ricevi profilo** precedente, come illustrato nell'immagine seguente. Utilizza il blocco **Ricevi profilo** per individuare il profilo specifico a cui desideri associare il contatto nel blocco successivo.
+ È possibile inserire manualmente l’ID profilo o utilizzare un valore predefinito archiviato in un attributo predefinito o utente.
![\[La pagina delle proprietà del AssociateContactToProfile blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-associate-1.png)
+ È necessario fornire un valore per ID contatto.
I contatti possono essere instradati lungo i seguenti rami:
+ **Operazione riuscita:** il contatto è stato associato al profilo.
+ **Errore:** si è verificato un errore durante il tentativo di associare il contatto al profilo. Ciò può essere dovuto a un errore di sistema o a una configurazione errata dell'azione **Associa il contatto al profilo**.
Il blocco seguente è configurato per associare il profilo con **ID profilo** archiviato negli attributi del contatto all’ID contatto corrente archiviato negli attributi del contatto.
![\[La pagina delle proprietà del AssociateContactToProfile blocco Customer Profiles.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-properties-associate-2.png)
## Proprietà: ottieni consigli sui profili
**Importante**
Per utilizzare questa azione, la tua istanza Amazon Connect deve disporre dell'autorizzazione per la seguente API: `GetProfileRecommendations` in una delle seguenti politiche: **AmazonConnectServiceLinkedRolePolicy**o **AmazonConnectServiceCustomerProfileAccess**.
Per maggiori dettagli su come configurare e utilizzare il blocco **Ottieni consigli sul profilo**, consulta[Fase 4: Utilizzo di Predictive Insights nei canali di coinvolgimento dei clienti](predictive-insights-get-started.md#use-across-customer-engagement-channels).
## Come mantenere i campi durante tutto il flusso
Si supponga che i clienti debbano poter interagire con il contact center e apprendere lo stato dell'ordine di consegna senza comunicare direttamente con un agente. Inoltre, si supponga di voler assegnare una priorità maggiore alle chiamate in entrata da clienti che hanno subito ritardi superiori a 10 minuti in passato.
In questi scenari, l'IVR deve recuperare le informazioni pertinenti sul cliente. Ciò si ottiene tramite il blocco Profili del cliente. In secondo luogo, l'IVR deve utilizzare questi dati dei clienti in altri blocchi di flusso per personalizzare l'esperienza e fornire assistenza al cliente in maniera proattiva.
1. Utilizza **Riproduci prompt** per personalizzare l'esperienza salutando il cliente per nome e informandolo del relativo stato.
![\[Utilizza Riproduci prompt per personalizzare l'esperienza salutando il cliente per nome e informandolo del relativo stato.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-persist-fields-1.png)
1. Utilizza **Verifica attributi contatti** per instradare i clienti in modo condizionale in base al tempo di attesa medio rispetto alle interazioni precedenti
![\[Utilizza Verifica attributi contatti per instradare i clienti in modo condizionale in base al tempo di attesa medio rispetto alle interazioni precedenti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-persist-fields-2.png)
## Blocco configurato
L'immagine seguente mostra un esempio dell'aspetto del blocco quando viene configurato. Mostra quattro rami: **Successo**, **Errore**, **Trovato più volte** e **Nessuno trovato**.
![\[Un blocco Profili dei clienti configurato.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-block-configured.png)