

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

# Ricerca di contatti completati e in corso in Amazon Connect
<a name="contact-search"></a>

**Nota**  
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html). 

Questo argomento è destinato agli amministratori e ai responsabili dei contact center che devono cercare contatti utilizzando il sito Web di Amazon Connect amministrazione. Per chi cerca APIs contatti a livello di codice, consulta. [APIs per cercare contatti](#apis-search-contacts) 

**Topics**
+ [Informazioni importanti](#important-contact-search)
+ [Principali funzionalità di ricerca](#key-search-features)
+ [Gestire chi può cercare contatti e accedere a informazioni dettagliate](#required-permissions-search-contacts)
+ [Come cercare un contatto](#how-to-search-contacts)
+ [Campi aggiuntivi: aggiunta di colonne ai risultati della ricerca](#additional-fields)
+ [Download dei risultati di ricerca](#download-search-results)
+ [APIs per cercare contatti](#apis-search-contacts)
+ [Ricerca di contatti in corso in Amazon Connect](search-in-progress-contacts.md)
+ [Ricerca di contatti in Amazon Connect in base agli attributi di contatto personalizzati o agli attributi del segmento di contatto](search-custom-attributes.md)

## Informazioni importanti
<a name="important-contact-search"></a>
+ Puoi cercare i contatti nei due anni precedenti.
+ Puoi cercare contatti sia completati che in corso. Per i contatti gestiti dagli agenti, un contatto viene contrassegnato come completato solo dopo che l'agente ha completato After Contact Work (ACW).
+ La possibilità di cercare contatti in corso varia in base al canale (consulta [Modello di dati degli eventi di contatto](contact-events.md#contact-events-data-model) per riferimento):
  + **Voce**
    + È possibile cercare le chiamate in coda in corso dopo che sono state messe in coda, collegate a un agente o disconnesse.
    + Per gli altri contatti vocali, puoi cercarli solo dopo che sono collegati a un agente o sono stati disconnessi. **I contatti vocali in coda in corso (ad eccezione delle richiamate) non vengono visualizzati nella pagina di ricerca dei contatti.**
  + **Chat**: puoi cercare i contatti dopo che sono connessi al sistema, messi in coda, connessi a un agente o disconnessi.
  + **Attività** ed **e-mail**: puoi cercare tutte le attività ed e-mail in corso dopo che sono state avviate.
+ I risultati della ricerca per una determinata query sono limitati ai primi 10.000 risultati restituiti.
+ Non è possibile cercare più contatti IDs contemporaneamente.

## Principali funzionalità di ricerca
<a name="key-search-features"></a>
+ [Ricerca in base ad attributi di contatto personalizzati](search-custom-attributes.md) (attributi definiti dall'utente).
+ [Ricerca di contatti in corso](search-in-progress-contacts.md) o completati utilizzando il filtro **Stato del contatto**.
+ Ricerca in un intervallo di tempo massimo di 8 settimane. Nel filtro relativo all'intervallo di tempo puoi specificare il **Tipo di timestamp**. Questo ti consente di specificare l'intervallo di tempo. Puoi scegliere tra timestamp Avviato, Connesso ad un agente, Disconnesso e Pianificato.
**Importante**  
Per impostazione predefinita, il filtro dell'intervallo di tempo nella ricerca dei contatti ha il tipo di timestamp impostato su "Avviato". Prima che venisse introdotta la possibilità di selezionarlo, il tipo di timestamp utilizzato dal filtro Intervallo di tempo era "Disconnesso".
Le ricerche salvate in Ricerca contatti create prima del lancio della funzionalità di ricerca dei contatti in corso, avvenuto a settembre 2023, sono state aggiornate con i filtri Stato del contatto = "Completato" e Tipo di timestamp = "Disconnesso". Queste selezioni erano implicite prima del lancio dell'opzione relativa ai contatti in corso.
+ Filtri a selezione multipla per i nomi degli agenti, le code di contatti e il nome del flusso iniziale per il contatto.
+ Filtro per la gerarchia degli agenti. È possibile applicare progressivamente filtri per eseguire il drill-down nei livelli della gerarchia degli agenti. 
**Nota**  
Quando si selezionano più valori in qualsiasi livello della gerarchia, non è possibile filtrare in base ai livelli gerarchici successivi.
+ Filtro dei contatti per canale e sottotipo di canale, ad esempio SMS.
+ Filtro per la ricerca di contatti e-mail utilizzando l’indirizzo e-mail (A, Da e Cc) e l’oggetto del messaggio. La ricerca in base all’oggetto dell’e-mail non fa distinzione tra maiuscole e minuscole. Inoltre, la ricerca di un sottoinsieme di parole all’interno di un oggetto e-mail fornisce risultati di ricerca. Ad esempio, se inserisci **richiesta**, Amazon Connect restituisce le e-mail con l’oggetto **Richiesta clienti**.
+ Filtri per l'[analisi delle conversazioni](analyze-conversations.md). Puoi cercare i contatti per cui è abilitata l'analisi conversazionale, ad esempio Analisi **conversazionale: l'interazione voce-agente restituisce i contatti in cui l'interazione** dell'agente è stata analizzata mediante analisi conversazionale. È possibile specificando il nome completo della [search for Contact categories](search-conversations.md#contact-category-search)categoria. Scegli di effettuare la ricerca con **Abbina qualsiasi** o **Abbina tutto** o **Nessuna corrispondenza**. Ad esempio, puoi cercare contatti sia con «categoria A» che con «categoria B» o con una delle due categorie. 

   Puoi fare riferimento all'elenco completo dei filtri di analisi conversazionale. [here](search-conversations.md) Puoi applicare questi filtri solo se la tua organizzazione ha abilitato Contact Lens. 

  Nella casella a discesa **Aggiungi filtro**, accanto ai filtri di Contact Lens è presente **CL**. Puoi applicare questi filtri solo se la tua organizzazione ha abilitato Contact Lens.   
![\[La pagina di ricerca contatti, la sezione dei filtri, il menu a discesa dei filtri.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-lens-search-contact-category-1.png)

  Se vuoi rimuovere i filtri di Contact Lens dall’elenco a discesa di un utente, rimuovi le seguenti autorizzazioni dal suo profilo di sicurezza: 
  + **Ricerca contatti per conversazione**: controlla l'accesso ai punteggi di valutazione, al tempo di non conversazione e alle ricerche per categoria.
  +  **Ricerca contatti per parole chiave**: controlla l'accesso alla ricerca per parole chiave.
  +  **Contact Lens - Analisi delle conversazioni**: nella pagina **Dettagli contatto** vengono visualizzati grafici di riepilogo dell’analisi delle conversazioni.
+ Filtri per le registrazioni. Utilizzando il filtro di **registrazione**, è possibile filtrare i contatti con una registrazione dello schermo (video) o una registrazione audio (voce). 
+ Filtro per regione attiva. Cerca i contatti in base alla regione AWS in cui sono stati gestiti. Questo filtro è disponibile per le istanze Amazon Connect che utilizzano la resilienza globale, in cui i contatti possono essere gestiti in una regione AWS diversa da quella in cui hai effettuato l'accesso.
**Importante**  
Alcune funzionalità di Amazon Connect potrebbero non essere disponibili quando si accede ai dati di contatto tra regioni. Per i dettagli completi, consulta il[Configurazione di Amazon Connect Global Resiliency](setup-connect-global-resiliency.md).
+ Filtri per [Voice ID](voice-id.md). Puoi cercare lo stato di autenticazione e lo stato di rilevamento delle frodi dei contatti di Voice ID, se la tua organizzazione ha abilitato Voice ID. Per accedere a questa funzionalità, devi disporre dell'autorizzazione **Analisi e ottimizzazione**, **ID voce - Attributi e ricerca** - **Visualizzazione** nel tuo profilo di sicurezza.

  L'immagine seguente mostra i filtri disponibili per la ricerca in Voice ID: **Risultato dell'autenticazione**, **Risultato del rilevamento delle frodi** e **Operazioni della persona che parla**.  
![\[Il menu a discesa dei filtri, filtri per Voice ID.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-search-filters.png)

## Gestire chi può cercare contatti e accedere a informazioni dettagliate
<a name="required-permissions-search-contacts"></a>

Prima che gli utenti possano cercare contatti in Amazon Connect o accedere a informazioni di contatto dettagliate, devono essere assegnati al profilo di **CallCenterManager**sicurezza o disporre delle seguenti autorizzazioni di **analisi e ottimizzazione**:
+ Per visualizzare i contatti nelle pagine **Ricerca contatti** e **Dettagli di contatto**, è necessaria almeno una delle seguenti autorizzazioni:
  + **Ricerca contatti - Visualizzazione**: consente a un utente di accedere a tutti i contatti nelle pagine **Ricerca contatti** e **Dettagli di contatto**.
  + **Visualizza i miei contatti - Visualizzazione**: nelle pagine **Ricerca contatti** e **Dettagli di contatto** consente agli agenti di visualizzare solo i contatti che hanno gestito.
+ **Limita l'accesso ai contatti** (facoltativa): consente di gestire l'accesso di un utente ai risultati nella pagina **Ricerca contatti** in base al gruppo gerarchico di agenti. Esempio:
  + Gli agenti assegnati a AgentGroup -1 possono visualizzare solo i record di contatto dei contatti gestiti dagli agenti in quel gruppo gerarchico e da tutti i gruppi sottostanti. Se dispongono delle autorizzazioni per **Conversazioni registrate**, possono anche ascoltare le registrazioni delle chiamate e visualizzare le trascrizioni.
  + Gli agenti assegnati a AgentGroup -2 possono accedere solo ai record dei contatti gestiti dal loro gruppo e dai gruppi sottostanti. 
  + I manager e gli altri che fanno parte di gruppi di livello superiore possono visualizzare i record di contatto relativi ai contatti gestiti da tutti i gruppi sottostanti, ad esempio AgentGroup -1 e 2.

  Per questa autorizzazione, **Tutti** = **Visualizza**, in quanto **Visualizza** è l'unica azione consentita.

  Per ulteriori informazioni sui gruppi gerarchici, consulta [Organizzare gli agenti in team e gruppi per la creazione di report e l’accesso mediante gerarchie](agent-hierarchy.md).
**Importante**  
L'eliminazione di un livello gerarchico interrompe il collegamento con i contatti esistenti. Questa azione non può essere annullata.
Quando modifichi il gruppo gerarchico di un utente, possono essere necessari un paio di minuti prima che i risultati della ricerca dei contatti riflettano le nuove autorizzazioni.

  La tabella seguente elenca le autorizzazioni tipiche e i contatti che è possibile visualizzare nelle pagine **Ricerca contatti** e **Dettagli di contatto**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/contact-search.html)
**Importante**  
Si sconsiglia di assegnare le autorizzazioni in combinazioni diverse da quelle mostrate nella tabella precedente.
+ **Contact Lens - Analisi delle conversazioni**: nella pagina **Dettagli di contatto** per un contatto vengono visualizzati grafici di riepilogo dell’analisi delle conversazioni: tendenza della valutazione dei clienti, sentiment e tempo di assenza di conversazione. 
+ **Registrazioni delle chiamate (redatte) - Accesso**: se l’organizzazione utilizza Contact Lens, puoi assegnare questa autorizzazione per consentire agli agenti di accedere solo alle registrazioni delle chiamate degli agenti in cui i dati sensibili sono stati oscurati.
+ **Trascrizioni dei contatti (redatte) - Accesso**: se l’organizzazione utilizza Contact Lens, puoi assegnare questa autorizzazione per consentire agli agenti di accedere solo alle trascrizioni dei contatti in cui i dati sensibili sono stati oscurati.
+ **Registrazioni delle chiamate (non redatte) - Accesso**: utilizza questa autorizzazione per gestire chi può accedere alle registrazioni nelle pagine **Ricerca contatti** e **Dettagli di contatto**. Se lo desideri, puoi utilizzare **Limita l'accesso ai contatti** per assicurarti che abbiano accesso solo alle informazioni dettagliate per i contatti gestiti dal loro gruppo gerarchico.
+ **Trascrizioni dei contatti (non redatte) - Accesso**: utilizza questa autorizzazione per gestire chi può visualizzare le conversazioni tramite chat ed e-mail e le trascrizioni vocali non redatte prodotte da Contact Lens sulle pagine **Ricerca contatti** e **Dettagli di contatto**. Se lo desideri, puoi utilizzare **Limita l'accesso ai contatti** per assicurarti che abbiano accesso solo alle informazioni dettagliate per i contatti gestiti dal loro gruppo gerarchico.
+ **Moduli di valutazione: esegui valutazioni**: consente agli utenti di [cercare](search-evaluations.md) valutazioni in base a modulo di valutazione, punteggio, data/intervallo dell'ultimo aggiornamento, valutatore e stato. 
+ **ID voce - Attributi e ricerca**: se l'organizzazione utilizza Voice ID, gli utenti con questa autorizzazione possono cercare e visualizzare i risultati di Voice ID nella pagina **Dettagli di contatto**. 
+ **Utenti - Visualizzazione**: è necessario disporre di questa autorizzazione per utilizzare il filtro **Agente** nella pagina **Ricerca contatti**.

Per impostazione predefinita, i profili di **amministrazione** e **CallCenterManager**sicurezza di Amazon Connect dispongono di queste autorizzazioni.

Per informazioni su come aggiungere altre autorizzazioni a un profilo di sicurezza esistente, consulta [Aggiornare i profili di sicurezza in Amazon Connect](update-security-profiles.md).

## Come cercare un contatto
<a name="how-to-search-contacts"></a>

1. Accedi ad Amazon Connect con un account utente che dispone delle [autorizzazioni per accedere alle registrazioni](#required-permissions-search-contacts).

1. In Amazon Connect scegli **Analisi e ottimizzazione** e quindi **Ricerca contatti**.

1. Utilizzare i filtri nella pagina per restringere la ricerca. Per data, puoi cercare fino a 8 settimane alla volta.

**Suggerimento**  
Per vedere se una conversazione è stata registrata, occorre che sia stato assegnato un profilo che dispone delle autorizzazioni **Manager monitor (Gestione monitoraggio)**. Se una conversazione è stata registrata, questo verrà indicato nel risultato della ricerca per impostazione predefinita con un'icona nella colonna **Recording (Registrazione)**. Questa icona non verrà visualizzata se non si dispone dell'autorizzazione per rivedere le registrazioni.

## Campi aggiuntivi: aggiunta di colonne ai risultati della ricerca
<a name="additional-fields"></a>

Utilizza le opzioni in **Campi aggiuntivi** per aggiungere colonne nei risultati della ricerca. Queste opzioni non vengono utilizzate per filtrare la ricerca.

Ad esempio, se vuoi includere le colonne per **Nome agente** e **Profilo di routing** nell'output della ricerca, scegli le colonne corrispondenti.

**Suggerimento**  
L'opzione **È trasferito in uscita** indica se il contatto è stato trasferito a un numero esterno. Per la data e l'ora (nel fuso orario UTC) in cui il trasferimento è stato collegato, consulta `TransferCompletedTimestamp` in [ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord). 

## Download dei risultati di ricerca
<a name="download-search-results"></a>

Puoi scaricare fino a 3.000 risultati di ricerca simultaneamente. 

## APIs per cercare contatti
<a name="apis-search-contacts"></a>

Usa quanto segue APIs per cercare i contatti a livello di codice:
+ [SearchContacts](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html)
+ [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)
+ [DescribeContactEvaluation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContactEvaluation.html)

# Ricerca di contatti in corso in Amazon Connect
<a name="search-in-progress-contacts"></a>

Un contatto gestito da un agente è considerato **In corso** fino a quando l'agente non completa le attività successive al contatto. Un contatto non gestito da un agente è considerato **in corso** finché non viene disconnesso.

**Topics**
+ [Autorizzazioni necessarie per cercare contatti in corso](#permissions-inprogress)
+ [Stati dei contatti supportati dalla ricerca di contatti](#contactstates-inprogress)
+ [Come cercare contatti in corso](#howto-search-inprogress)
+ [Filtro dei contatti con i tipi di timestamp](#filter-by-timestamp)
+ [Visualizzazione dei contatti in corso](#view-inprogress-contacts)
+ [Analisi delle trascrizioni in tempo reale](#review-realtime-transcripts)

## Autorizzazioni necessarie per cercare contatti in corso
<a name="permissions-inprogress"></a>

Le autorizzazioni necessarie per la ricerca di contatti in corso sono le stesse di quelle per la ricerca di contatti completati. Per ulteriori informazioni, consulta [Gestire chi può cercare contatti e accedere a informazioni dettagliate](contact-search.md#required-permissions-search-contacts).

## Stati dei contatti supportati dalla ricerca di contatti
<a name="contactstates-inprogress"></a>

La possibilità di cercare contatti in corso varia in base al canale (consulta [Modello di dati degli eventi di contatto](contact-events.md#contact-events-data-model) per riferimento):
+ **Voce**
  + È possibile cercare i callback in coda in corso dopo che sono stati messi in coda, collegati a un agente o disconnessi.
  + Per gli altri contatti vocali, puoi cercarli solo dopo che sono collegati a un agente o sono stati disconnessi. **I contatti vocali in coda in corso (ad eccezione delle richiamate) non vengono visualizzati nella pagina di ricerca dei contatti.**
+ **Chat**: puoi cercare i contatti dopo che sono connessi al sistema, messi in coda, connessi a un agente o disconnessi.
+ **Attività** ed **e-mail**: puoi cercare tutte le attività ed e-mail in corso dopo che sono state avviate.

## Come cercare contatti in corso
<a name="howto-search-inprogress"></a>

1. Accedi ad Amazon Connect con un account utente che dispone delle [autorizzazioni per accedere alle registrazioni](contact-search.md#required-permissions-search-contacts).

1. In Amazon Connect scegli **Analisi e ottimizzazione** e quindi **Ricerca contatti**.

1. Seleziona il filtro **Stato del contatto** e modifica il valore selezionato in **In corso**. Lo stato predefinito del contatto è **Completato**.  
![\[Il filtro In corso.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-in-progress-filter.png)

## Filtro dei contatti con i tipi di timestamp
<a name="filter-by-timestamp"></a>

Puoi cercare i contatti in un particolare stato utilizzando **Tipo di timestamp** all'interno del filtro **Intervallo di tempo**. Ad esempio, puoi cercare i contatti attività programmati per il giorno successivo selezionando **Stato del contatto = In corso**, **Tipo di timestamp = Pianificato** e la data appropriata in **Intervallo di tempo**.

Sono supportati i seguenti tipi di timestamp: Avviato, Connesso (ad un agente), Disconnesso e Pianificato. Quando cerchi contatti utilizzando un determinato **Tipo di timestamp**, i risultati della ricerca non contengono i contatti per i quali quel timestamp non è popolato. Ad esempio, se cerchi un contatto con **Tipo di timestamp = Disconnesso** e **Stato del contatto = In corso**, verranno visualizzati solo i contatti che si trovano nello stato Attività successive al contatto.

**Importante**  
Per impostazione predefinita, il filtro **Intervallo di tempo** nella pagina **Ricerca contatti** ha il **Tipo di timestamp** impostato su **Avviato**. Prima che venisse introdotta la possibilità di selezionarlo, il tipo di timestamp utilizzato dal filtro **Intervallo di tempo** era **Disconnesso**.
Le ricerche salvate in **Ricerca contatti** create prima del lancio della funzionalità di ricerca dei contatti in corso, avvenuto a settembre 2023, sono state aggiornate con i filtri **Stato del contatto = "Completato"** e **Tipo di timestamp = "Disconnesso"**. Queste selezioni erano implicite prima del lancio dell'opzione relativa ai contatti in corso.

## Visualizzazione dei contatti in corso
<a name="view-inprogress-contacts"></a>

Puoi fare clic su un ID contatto nei risultati di **Ricerca contatti** per visualizzare i dettagli di un contatto in corso. 

![\[Visualizza un contatto in corso.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-in-progress-view.png)


### Informazioni importanti
<a name="important-view-inprogress-contacts"></a>
+ La pagina **Dettagli di contatto** per un contatto in corso mostra i dati disponibili al momento dell'apertura della pagina **Dettagli di contatto**. Non si aggiorna automaticamente man mano che il contatto avanza. È necessario aggiornare manualmente la pagina utilizzando il browser.
+ Le informazioni presenti in alcuni campi di **Ricerca contatti** e **** potrebbero essere incomplete o incoerenti mentre il contatto è in corso. Al termine del contatto, le informazioni vengono rese coerenti con il record di contatto sottostante, dopo l'aggiornamento manuale della pagina. 
+ Potrebbe verificarsi un ritardo tra il **completamento** del contatto e il momento in cui il contatto viene contrassegnato come **Completato** nel record del contatto.

## Analisi delle trascrizioni in tempo reale
<a name="review-realtime-transcripts"></a>

Per i contatti vocali, quando è abilitata l’analisi delle chiamate in tempo reale, puoi visualizzare le trascrizioni di un contatto in tempo reale nella pagina **Dettagli di contatto** se disponi dell’autorizzazione del profilo di sicurezza **Trascrizioni dei contatti (non redatte) - Accesso**. 

**Nota**  
L’oscuramento non è supportato per i contatti vocali in corso. Gli utenti che dispongono dell’autorizzazione **Trascrizioni dei contatti (non redatte) - Accesso** non possono visualizzare i contatti vocali in corso.

Nella parte inferiore della trascrizione scegli l’icona di aggiornamento per visualizzare gli ultimi turni disponibili della conversazione. L’immagine seguente mostra la posizione dell’icona di aggiornamento nella pagina.

![\[Una trascrizione, l’icona di aggiornamento nella parte inferiore della pagina.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-real-time-transcripts.png)


# Ricerca di contatti in Amazon Connect in base agli attributi di contatto personalizzati o agli attributi del segmento di contatto
<a name="search-custom-attributes"></a>

È possibile creare filtri di ricerca in base agli attributi di contatto personalizzati (detti anche [attributi di contatto definiti dall’utente](connect-attrib-list.md#user-defined-attributes)) o agli attributi del segmento di contatto. 

Ad esempio, se aggiungi `AgentLocation` e `InsurancePlanType` ai tuoi record di contatto come attributi personalizzati, puoi cercare contatti con valori specifici in questi attributi, come le chiamate gestite da agenti che si trovano a Seattle o le chiamate effettuate da clienti che hanno acquistato un'assicurazione sulla casa.

**Topics**
+ [Autorizzazioni necessarie per configurare attributi di contatto ricercabili](#permissions-search-custom-attributes)
+ [Configurazione degli attributi di contatto personalizzati ricercabili](#configure-search-custom-attributes)
+ [Modifica, aggiunta o rimozione di attributi dei contatti](#edit-add-remove-attribute-keys)
+ [Filtrare i risultati della ricerca di contatti in base agli attributi di contatto](#howto-search-for-custom-attributes)
+ [Filtrare i risultati della ricerca di contatti in base agli attributi del segmento di contatto](#filter-contact-search-segment)

## Autorizzazioni necessarie per configurare attributi di contatto ricercabili
<a name="permissions-search-custom-attributes"></a>

Per impostazione predefinita, un attributo personalizzato non viene indicizzato finché qualcuno con le autorizzazioni appropriate, ad esempio un amministratore o un manager, non specifica che deve essere ricercabile. È necessario che determinati utenti dispongano delle autorizzazioni per configurare gli attributi di contatto personalizzati che possono essere aggiunti come filtro di ricerca. 

Assegna le seguenti autorizzazioni al loro profilo di sicurezza: 
+ Abilita una delle seguenti autorizzazioni per accedere alla pagina **Ricerca contatti**:
  + **Ricerca contatti**. Consente di cercare tutti i contatti.
  + **Visualizza i miei contatti**: consente agli agenti di visualizzare solo i contatti che hanno gestito.
+ **Attributi di contatto**: consente agli utenti di visualizzare gli attributi dei contatti. Controlla anche l'accesso ai filtri di ricerca in base agli attributi di contatti.
+ **Configura gli attributi di contatto ricercabili** - **Tutti**: le persone che dispongono di questa autorizzazione stabiliscono quali dati personalizzati saranno ricercabili (dalle persone che dispongono dell'autorizzazione **Attributi di contatto**). Consente di accedere alla seguente pagina di configurazione:   
![\[La pagina di ricerca degli attributi di contatto del cliente.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-custom-attributes-configuration-page.png)

## Configurazione degli attributi di contatto personalizzati ricercabili
<a name="configure-search-custom-attributes"></a>

1. Nella pagina **Ricerca contatti**, scegli **Aggiungi filtro**, **Attributo di contatto personalizzato**. Questa opzione è disponibile solo per le persone che dispongono delle autorizzazioni **Configura gli attributi di contatto ricercabili** nel proprio profilo di sicurezza.  
![\[La pagina di ricerca dei contatti, il menu a discesa dei filtri, l'opzione degli attributi di contatto del cliente.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-custom-attributes-specify1.png)

1. La prima volta che scegli **Attributo di contatto personalizzato**, viene visualizzata la seguente casella, che indica che nessun attributo è stato configurato per questa istanza Amazon Connect. Scegli **Specifica le chiavi di attributo ricercabili**.  
![\[L'opzione di aggiunta del filtro, un messaggio che indica che non sono state specificate chiavi per la ricerca.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-custom-attributes-specify2.png)

1. Nella casella **Chiave di attributo**, digita il nome dell'attributo personalizzato, quindi scegli **Aggiungi chiave**.
**Importante**  
È necessario digitare il nome esatto della chiave. Applica la distinzione tra lettere maiuscole e minuscole.

1. Al termine, scegli **Save** (Salva).

Gli utenti saranno in grado di cercare contatti futuri in base a queste chiavi.

## Modifica, aggiunta o rimozione di attributi dei contatti
<a name="edit-add-remove-attribute-keys"></a>

Per modificare, aggiungere o rimuovere chiavi, scegli **Attributo**, **Impostazioni**. Se l'opzione **Impostazioni** non è visibile, non disponi delle autorizzazioni necessarie.

![\[La scheda Aggiungi filtro, l'ingranaggio delle impostazioni nell'angolo in alto a destra della pagina.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-search-custom-attributes-settings.png)


## Filtrare i risultati della ricerca di contatti in base agli attributi di contatto
<a name="howto-search-for-custom-attributes"></a>

Gli utenti che dispongono dell'autorizzazione **Attributi di contatto** nel proprio profilo di sicurezza possono trovare i contatti utilizzando i filtri degli attributi di contatto.

1. Nella pagina **Ricerca contatti**, scegli **Aggiungi filtro**, **Attributo di contatto personalizzato**, quindi scegli **Specifica le chiavi di attributo ricercabili**.

1. Nella pagina **Attributi di contatto ricercabili**, inserisci la chiave di attributo nella casella **Chiave di attributo** e scegli **\$1Aggiungi chiave**, quindi scegli **Salva**.

1. Torna alla pagina **Ricerca contatti**. Usa **Aggiungi filtro** per selezionare nel menu a discesa l'attributo che hai appena aggiunto. Nella casella **Valore attributo**, inserisci il valore che vuoi trovare. 

## Filtrare i risultati della ricerca di contatti in base agli attributi del segmento di contatto
<a name="filter-contact-search-segment"></a>

Dopo aver creato gli attributi predefiniti e averli associati a un segmento di contatto (spiegato in [Utilizzare gli attributi del segmento di contatto](use-contact-segment-attributes.md)), puoi filtrare i risultati della ricerca di contatti in base ai valori degli attributi del segmento. 

L’immagine seguente mostra la pagina **Ricerca contatti** e l’opzione per filtrare i risultati della ricerca di contatti in base ai valori degli attributi di segmento personalizzati. 

![\[La pagina Ricerca contatti, il filtro Attributi segmento.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/attribute-management-4.png)


1. Nella pagina **Ricerca contatti**, nel menu a discesa **Aggiungi filtro**, seleziona **Attributi personalizzati del segmento di contatto**.

1. Seleziona l’attributo predefinito da applicare ai criteri di filtro. **Ad esempio, le immagini precedenti vengono visualizzate Business-unit-name come nome dell'attributo.**

1. Se l’attributo predefinito selezionato ha dei valori prestabiliti, questi vengono elencati in **Valore/i di attributo** come scelta multipla. Ad esempio, l’immagine precedente mostra le opzioni Account, Fatturazione, Servizio Clienti e Marketing.

1. Scegli **Applica**. 