

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

# Eventi di contatto di Amazon Connect
<a name="contact-events"></a>

Amazon Connect ti consente di abbonarti a un flusso quasi in tempo reale di eventi di contatto (chiamate vocali, chat, attività ed e-mail) (ad esempio, la chiamata è in coda) nel tuo contact center Amazon Connect.

Gli eventi di contatto possono essere utilizzati per creare pannelli di controllo di analisi per monitorare e tracciare l'attività dei contatti, integrarli nelle soluzioni di gestione del personale (WFM, workforce management) per comprendere meglio le prestazioni dei contact center o integrare applicazioni che reagiscono agli eventi (ad esempio, chiamata disconnessa) in tempo reale.

**Nota**  
Man mano che aggiungiamo nuove funzionalità e tipi di eventi, aggiorniamo il modello di dati degli eventi di contatto con nuovi campi. Tutte le modifiche al modello di dati mantengono la compatibilità con le versioni precedenti.  
Quando sviluppi applicazioni, progettale in modo da gestire correttamente nuovi tipi di eventi e campi. Le applicazioni devono:  
Ignorare i campi appena aggiunti per i quali non sono state progettate.
Continuare a funzionare quando vengono introdotti nuovi tipi di eventi.
Questo approccio aiuta a garantire che le applicazioni rimangano stabili man mano che il servizio si evolve.

**Topics**
+ [Modello di dati degli eventi di contatto](#contact-events-data-model)
+ [Timestamp del contatto](#contact-timestamps)
+ [Iscrizione agli eventi di contatto di Amazon Connect](#subscribe-contact-events)
+ [Esempio per l'interruzione dello streaming di un tipo di evento](#stop-streaming-event)
+ [Evento di contatto di esempio per la riuscita connessione di una chiamata vocale a un agente](#sample-contact-event)
+ [Evento di contatto di esempio per la riuscita disconnessione di una chiamata vocale](#sample-contact-event-call-disconnected)
+ [Evento di esempio per l'aggiornamento delle proprietà dei contatti](#sample-updated-event)
+ [Evento di contatto di esempio relativo alla connessione di una chiamata vocale a un agente utilizzando i criteri di instradamento](#sample-routing-criteria-event-connected)
+ [Esempio di evento relativo alla scadenza del passaggio di instradamento su un contatto](#sample-routing-step-expires)
+ [Evento di contatto di esempio relativo alla connessione di una chiamata vocale a un agente fornito dal cliente utilizzando i criteri di routing](#sample-contact-event-voice-call-routing-criteria)

## Modello di dati degli eventi di contatto
<a name="contact-events-data-model"></a>

Gli eventi di contatto vengono generati in JSON. Per ogni tipo di evento, viene inviato un blob JSON alla destinazione di tua scelta, come configurato nella regola. Sono disponibili i seguenti eventi di contatto: 
+ AMD\$1DISABLED: il rilevamento della segreteria telefonica è disabilitato.
+ AVVIATO: viene avviata o trasferita una chiamata vocale, una chat, un'attività o un'e-mail. 
+ CONNECTED\$1TO\$1SYSTEM: il contatto ha stabilito una connessione multimediale (ad esempio, ha ricevuto risposta da una persona o tramite segreteria vocale). Questo evento viene generato per uno qualsiasi dei codici [AnsweringMachineDetectionStatus](#AnsweringMachineDetectionStatus).
**Nota**  
Questo evento viene generato per le chiamate in uscita (incluse le [campagne Amazon Connect in uscita](how-to-create-campaigns.md)), le attività e le chat.
+ CONTACT\$1DATA\$1UPDATED - Una o più delle seguenti proprietà di contatto sono state aggiornate durante una chiamata vocale, una chat, un'attività o un'e-mail: timestamp pianificato (solo attività), timestamp accettato dall'agente (contatto vocale per la campagna in uscita solo in modalità di anteprima), attributi e tag definiti dall'utente, criteri di routing aggiornati o il passaggio è scaduto e se Contact Lens è abilitato per un determinato contatto.
+ IN CODA: una chiamata vocale, una chat, un'attività o un'e-mail viene messa in coda per essere assegnata a un agente.
+ CONNECTED\$1TO\$1AGENT: una chiamata vocale, una chat, un'attività o un'e-mail è collegata a un agente.
+ COMPLETATO: l’evento COMPLETATO indica quando un contatto è terminato completamente, incluse le attività successive al contatto (After Contact Work, ACW), se applicabile.
  + Per i contatti con ACW:

    Quando un agente completa l'ACW per una chiamata vocale, una chat, un'attività o un'e-mail, vengono compilati i seguenti campi:
    + AgentInfo.afterContactWorkStartTimestamp
    + Informazioni sull'agente. afterContactWorkEndTimestamp
    + Informazioni sull'agente. afterContactWorkDurata
  + Per contatti senza ACW:

    Questi campi non vengono compilati quando
    + Nessun agente era presente nel contatto.
    + L’agente non è entrato in ACW.

    In questi casi, l’evento COMPLETED viene pubblicato immediatamente dopo l’evento DISCONNECT con gli stessi dati.
**Nota**  
Per i contatti in chat, se un agente passa allo stato offline senza cancellare correttamente il contatto nel Pannello di controllo dei contatti (CCP), possono verificarsi i seguenti problemi:  
L’evento COMPLETED potrebbe non essere consegnato.
 AfterContactWorkEndTimestamp Potrebbero mostrare discrepanze.
+ DISCONNESSA: una chiamata vocale, una chat, un'attività o un'e-mail viene disconnessa. Per le chiamate in uscita, si intende quando il tentativo di chiamata non ha esito positivo, il tentativo di connessione riesce ma la chiamata non ha risposta oppure il tentativo genera un [tono SIT](https://en.wikipedia.org/wiki/Special_information_tone). 

  Un evento di disconnessione si verifica quando:
  + Una chat o un'attività viene disconnessa.
  + Un'attività viene disconnessa a seguito di un'azione di flusso.
  + Un'attività scade. L’attività viene disconnessa automaticamente al termine del timer di scadenza. L’impostazione predefinita è 7 giorni e la scadenza dell’attività è configurabile fino a 90 giorni. 
+ PAUSED: un contatto dell'attività attivo è stato sospeso.
+ RESUMED: un contatto dell'attività in pausa è stato ripristinato.
+ WEBRTC\$1API: il contatto ha utilizzato il widget di comunicazione per effettuare una chiamata in-app a un agente. voice/video 

**Topics**
+ [AgentInfo](#AgentInfo)
+ [AttributeCondition](#AttributeCondition)
+ [Campagna](#Campaign-ces)
+ [Evento di contatto](#ContactEvent)
+ [CustomerVoiceActivity](#CustomerVoiceActivity)
+ [Expiry](#Expiry)
+ [Expression](#Expression)
+ [GlobalResiliencyMetadata](#GlobalResiliencyMetadata)
+ [QueueInfo](#QueueInfo)
+ [RoutingCriteria](#RoutingCriteria)
+ [Steps](#Steps)
+ [SystemEndpoint](#SystemEndpoint)
+ [Endpoint](#Endpoint)
+ [Recordings](#Recordings)
+ [RecordingsInfo](#RecordingsInfo)
+ [ContactDetails](#ContactDetails)
+ [ContactEvaluations](#ContactEvaluations)
+ [ContactEvaluation](#ContactEvaluation)
+ [StateTransitions](#StateTransitions)
+ [StateTransition](#StateTransition)
+ [OutboundStrategy](#OutboundStrategy)

### AgentInfo
<a name="AgentInfo"></a>

L'oggetto `AgentInfo` ha le seguenti proprietà:

**AgentArn**  
L'Amazon Resource Name (ARN) per l'account dell'agente.  
Tipo: ARN

**AgentInitiatedHoldDuration**  
La durata di attesa totale in secondi avviata dall’agente.  
Tipo: numero intero

**AfterContactWorkStartTimestamp**  
Data e ora in cui l'agente ha iniziato a eseguire le attività successive al contatto per il contatto, in orario UTC.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

**AfterContactWorkEndTimestamp**  
Data e ora in cui l’agente ha terminato le attività successive al contatto per il contatto, in orario UTC. Nei casi in cui l'agente finisce di utilizzare i contatti della chat e passa lo stato della propria attività a offline o a uno stato equivalente senza cancellare il contatto in CCP, è possibile che si verifichino delle discrepanze. AfterContactWork `AfterContactWorkEndTimestamp`  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

**AfterContactWorkDuration**  
La differenza di tempo, in secondi, tra `AfterContactWorkStartTimestamp` e `AfterContactWorkEndTimestamp`.  
Tipo: numero intero

**AcceptedByAgentTimestamp**  
La data e l’ora in cui il contatto vocale della campagna in uscita in modalità di anteprima di chiamata è stato accettato dall’agente, in orario UTC.  
Tipo: String (Thh:mm:SSZ) yyyy-mm-dd

**PreviewEndTimestamp**  
La data e l’ora in cui l’agente ha terminato la visualizzazione in anteprima del contatto vocale delle campagne in uscita in modalità di anteprima di chiamata, in orario UTC.  
Tipo: String (Thh:mm:SSZ) yyyy-mm-dd

**HierarchyGroups**  
I gruppi gerarchici degli agenti per l'agente.  
Tipo: ARN

### AttributeCondition
<a name="AttributeCondition"></a>

Un oggetto per specificare la condizione predefinita dell'attributo.

**Name**  
Il nome dell'attributo predefinito.  
Tipo: String  
Lunghezza: 1-64

**Value**  
Il valore dell'attributo predefinito.  
Tipo: String  
Lunghezza: 1-64

**ComparisonOperator**  
L’operatore di confronto della condizione.  
Tipo: String  
Valori validi:, Match, Range NumberGreaterOrEqualTo

**ProficiencyLevel**  
Il livello di competenza della condizione.  
Tipo: Float  
Valori validi: 1,0, 2,0, 3,0, 4,0 e 5,0

**Range**  
Un oggetto per definire il livello di competenza minimo e massimo.  
Tipo: Range object

**MatchCriteria**  
Un oggetto da definire AgentsCriteria.  
Tipo: oggetto MatchCriteria

**AgentsCriteria**  
Un oggetto per definire gli agentIds.  
Tipo: oggetto AgentsCriteria

**AgentIds**  
Un oggetto per specificare un elenco di agenti, in base all’ID agente.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256

### Campagna
<a name="Campaign-ces"></a>

Informazioni associate a una campagna.

Tipo: oggetto [Campaign](https://docs.aws.amazon.com/connect/latest/APIReference/API_Campaign.html)

### Evento di contatto
<a name="ContactEvent"></a>

L'oggetto `Contact` ha le seguenti proprietà:

**ContactId**  
L'identificatore del contatto.  
Tipo: String  
Lunghezza: 1-256

**InitialContactId**  
L'identificatore del contatto iniziale.  
Tipo: String  
Lunghezza: 1-256

**RelatedContactId**  
Il contactId correlato a [questo](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_Item.html) contatto.  
Tipo: String  
Lunghezza: minimo 1, massimo 256.

**PreviousContactId**  
L'identificatore originale del contatto che è stato trasferito.  
Tipo: String  
Lunghezza: 1-256

**Canale**  
Il tipo di canale.  
Tipo: `VOICE``CHAT`,`TASK`, o `EMAIL`

**InstanceArn**  
Il nome della risorsa Amazon (ARN) per l'istanza Amazon Connect in cui viene creato l'account utente dell'agente.  
Tipo: ARN

**InitiationMethod**  
Indica la modalità di avvio iniziale del contatto.  
Valori validi:  
+ IN ENTRATA: il cliente ha avviato un contatto vocale (telefonico) o e-mail con il tuo contact center.
+ IN USCITA: rappresenta una chiamata vocale o un'e-mail in uscita avviata da un agente dal Pannello di controllo dei contatti (CCP). 
+ TRANSFER: il contatto viene trasferito da un agente a un altro agente o a una coda, utilizzando le connessioni rapide nel CCP. Ciò comporta la creazione di un nuovo record di contatto.
+ CALLBACK: il cliente è stato contattato come parte di un flusso di callback. Per ulteriori informazioni su questo scenario, vedere. InitiationMethod [Callback in coda nei parametri in tempo reale in Amazon Connect](about-queued-callbacks.md) 
+ API: il contatto è stato avviato con Amazon Connect tramite API. Potrebbe trattarsi di un contatto in uscita creato e messo in coda a un agente utilizzando l'[StartOutboundVoiceContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundVoiceContact.html)API, di una live chat avviata dal cliente con il centro assistenza, in cui è stata chiamata l'API, di un'attività avviata dal cliente chiamando l'[StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, di un'attività avviata dal cliente chiamando l'[StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html)API o di un'e-mail avviata dal cliente chiamando l'API. [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html) 
+ QUEUE\$1TRANSFER: mentre il contatto è in una coda e viene poi trasferito in un'altra coda utilizzando un blocco di flusso.
+ EXTERNAL\$1OUTBOUND: un agente ha avviato un contatto vocale (telefonico) con un partecipante esterno al contact center utilizzando la connessione rapida nel CCP o un blocco di flusso. 
+ MONITOR: un supervisore ha avviato il monitoraggio di un agente. Il supervisore può monitorare silenziosamente l'agente e il cliente o inserirsi nella conversazione.
+ DISCONNECT: quando viene attivato un blocco [Set Disconnect Flow (Imposta flusso di disconnessione)](set-disconnect-flow.md), specifica quale flusso eseguire dopo un evento di disconnessione. 

  Un evento di disconnessione si verifica quando:
  + Una chat o un'attività viene disconnessa.
  + Un'attività viene disconnessa a seguito di un'azione di flusso.
  + Un'attività scade. L’attività viene disconnessa automaticamente al termine del timer di scadenza. L’impostazione predefinita è 7 giorni e la scadenza dell’attività è configurabile fino a 90 giorni. 

  Quando si verifica l'evento di disconnessione, viene eseguito il flusso di contenuto corrispondente. Se viene creato un nuovo contatto durante l'esecuzione di un flusso di disconnessione, il metodo di avvio per quel nuovo contatto è DISCONNECT.
+ AGENT\$1REPLY: rappresenta un contatto e-mail di risposta dell'agente corrispondente al contatto e-mail in entrata accettato da un agente.
+ FLOW: rappresenta un contatto e-mail automatizzato (avviato dal flusso).
+ CAMPAIGN\$1PREVIEW: il contatto è stato avviato da una campagna in uscita che utilizza la modalità di chiamata in anteprima. L'agente visualizza in anteprima le informazioni sui clienti prima di effettuare la chiamata.

**DisconnectReason codice**  
Indica come è stato terminato il contatto. È disponibile per i contatti delle campagne in uscita in cui la connessione multimediale non è riuscita.  
Valori validi:  
+ OUTBOUND\$1DESTINATION\$1ENDPOINT\$1ERROR: le configurazioni attuali non consentono di chiamare questa destinazione (ad esempio, chiamare una destinazione endpoint da un'istanza non idonea).
+ OUTBOUND\$1RESOURCE\$1ERROR: l'istanza non dispone delle autorizzazioni necessarie per effettuare chiamate in uscita o le risorse necessarie non sono state trovate.
+ OUTBOUND\$1ATTEMPT\$1FAILED: si è verificato un errore sconosciuto, un parametro non è valido o le autorizzazioni non sono sufficienti per chiamare l'API.
+ OUTBUND\$1PREVIEW\$1DISCARDED: nessun contatto effettuato; destinatario rimosso dall’elenco; non verranno effettuati ulteriori tentativi.
+ EXPIRED: gli agenti disponibili non sono sufficienti o la capacità di telecomunicazione non è sufficiente per tali chiamate. 
+ IGNORATO: indica che un agente ha scartato un contatto e-mail.

**AnsweringMachineDetectionStatus**  
Indica in che modo viene effettivamente [gestita una chiamata in uscita da una campagna](how-to-create-campaigns.md) se il contatto è connesso a. Amazon Connect  
Tipo: String  
Valori validi:  
+ `HUMAN_ANSWERED`: al numero chiamato ha risposto una persona.
+ `VOICEMAIL_BEEP`: al numero chiamato ha risposto la segreteria vocale con un segnale acustico.
+ `VOICEMAIL_NO_BEEP`: al numero chiamato ha risposto la segreteria vocale senza un segnale acustico.
+ `AMD_UNANSWERED`: il numero chiamato ha continuato a squillare, ma la chiamata non ha ricevuto risposta.
+ `AMD_UNRESOLVED`: il numero chiamato era connesso ma il rilevamento della segreteria telefonica non è riuscito a determinare se la chiamata ha ricevuto risposta da parte di una persona o un messaggio vocale.
+ `AMD_UNRESOLVED_SILENCE`: il numero selezionato era connesso, ma il rilevamento della segreteria telefonica ha rilevato il silenzio.
+ `AMD_NOT_APPLICABLE`: la chiamata è stata disconnessa prima dello squillo e non sono state rilevate connessioni multimediali.
+ `SIT_TONE_BUSY`: il numero chiamato era occupato.
+ `SIT_TONE_INVALID_NUMBER`: il numero chiamato non è un numero valido.
+ `SIT_TONE_DETECTED`: è stato rilevato un tono informativo speciale (SIT).
+ `FAX_MACHINE_DETECTED`: è stato rilevato un fax.
+ `AMD_ERROR`: il numero selezionato era connesso, ma si è verificato un errore nel rilevamento della segreteria telefonica.

**EventType**  
Il tipo di evento pubblicato.  
Tipo: String  
Valori validi: INITIATED, CONNECTED\$1TO\$1SYSTEM, CONTACT\$1DATA\$1UPDATED, QUEUED, CONNECTED\$1TO\$1AGENT, DISCONNECTED, PAUSED, RESUMED, COMPLETED

**UpdatedProperties**  
Il tipo di proprietà aggiornato.  
Tipo: String  
Valori validi: ScheduledTimestamp,, UserDefinedAttributes. ContactLens ConversationalAnalytics.Configurazione, attributi del segmento, tag, GlobalResiliencyMetadata

**AgentInfo**  
L'agente a cui è stato assegnato il contatto.  
Tipo: oggetto `AgentInfo` 

**QueueInfo**  
La coda in cui è stato posizionato il contatto.  
Tipo: oggetto `QueueInfo` 

**ContactLens**  
Informazioni su Contact Lens se Contact Lens è abilitato nel flusso.  
Tipo: per ulteriori informazioni sull’oggetto `ContactLens`, consulta [ContactLens](ctr-data-model.md#ctr-ContactLens). 

**SegmentAttributes**  
Un set di coppie chiave-valore definite dal sistema archiviate su singoli segmenti di contatto utilizzando una mappa di attributi. Gli attributi sono Amazon Connect attributi standard e sono accessibili nei flussi. Le chiavi di attributo possono includere solo caratteri alfanumerici, - e \$1.  
Questo campo può essere usato per mostrare il sottotipo di canale. Ad esempio `connect:Guide` o `connect:SMS`.  
Tipo: SegmentAttributes   
Membri: SegmentAttributeName, SegmentAttributeValue

**Tags**  
I [tag](granular-billing.md) associati al contatto. Contiene tag AWS generati e definiti dall'utente.   
Tipo: mappatura stringa a stringa

**CustomerId**  
Il numero identificativo del cliente. Ad esempio, CustomerId può essere un numero cliente del tuo CRM. Puoi creare una funzione Lambda per estrarre l'ID cliente univoco del chiamante dal sistema CRM. Se abiliti la funzionalità Amazon Connect Voice ID, questo attributo viene compilato con il nome CustomerSpeakerId del chiamante.  
Tipo: String 

**ChatMetrics**  
Informazioni su come agente, bot e cliente interagiscono in un contatto di chat.     
**ChatContactMetrics**  
Informazioni sulle interazioni complessive dei partecipanti a livello di contatto.  
Tipo: oggetto [ChatContactMetrics](#chat-contact-metrics)  
**CustomerMetrics**  
Informazioni sulle interazioni con i clienti in un contatto.  
Tipo: oggetto [ParticipantMetrics](#participantmetrics)  
**AgentMetrics**  
Informazioni sulle interazioni tra agenti in un contatto.  
Tipo: oggetto [ParticipantMetrics](#participantmetrics)

**GlobalResiliencyMetadata**  
Informazioni sulla configurazione di resilienza globale per il contatto, inclusi i dettagli sulla distribuzione del traffico.  
Tipo: oggetto [GlobalResiliencyMetadata](#GlobalResiliencyMetadata)

### CustomerVoiceActivity
<a name="CustomerVoiceActivity"></a>

L'oggetto `CustomerVoiceActivity` ha le seguenti proprietà:

**GreetingStartTimestamp**  
La data e l'ora di misurazione dell'inizio del saluto del cliente da una chiamata vocale in uscita, in orario UTC.   
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**GreetingEndTimestamp**  
La data e l'ora di misurazione della fine del saluto del cliente da una chiamata vocale in uscita, in orario UTC.   
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

### Expiry
<a name="Expiry"></a>

Un oggetto per specificare la scadenza di un passaggio di instradamento.

**DurationInSeconds**  
Il numero di secondi di attesa prima della scadenza del passaggio di instradamento.  
Tipo: Integer  
Valore minimo: 0

**ExpiryTimestamp**  
Il timestamp che indica la scadenza del passaggio di instradamento.  
Tipo: String (yyyy-mm-ddThh:mm:ssZ)

### Expression
<a name="Expression"></a>

Un'unione con tag per specificare l'espressione per un passaggio di instradamento.

**AndExpression**  
Elenco di espressioni di instradamento che verranno combinate insieme con un operatore logico AND.  
Tipo: Expression  
Valore minimo: 0

**OrExpression**  
Elenco di espressioni di instradamento che verranno combinate insieme con un operatore logico OR.  
Tipo: Expression

**AttributeCondition**  
Un oggetto per specificare la condizione predefinita dell'attributo.  
Tipo: AttributeCondition

**NotAttributeCondition**  
Un oggetto per specificare la condizione predefinita dell’attributo al fine di escludere gli agenti con determinate competenze.  
Tipo: AttributeCondition

### GlobalResiliencyMetadata
<a name="GlobalResiliencyMetadata"></a>

Informazioni sulla configurazione di resilienza globale per il contatto, inclusi i dettagli sulla distribuzione del traffico.

**ActiveRegion**  
L'attuale regione AWS in cui il contatto è attivo. Indica dove viene elaborato il contatto in tempo reale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.

**OriginRegion**  
La regione AWS in cui il contatto è stato originariamente creato e avviato. Questo può differire dal `ActiveRegion` caso in cui il contatto sia stato trasferito tra regioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.

**TrafficDistributionGroupId**  
L'identificatore del gruppo di distribuzione del traffico.  
Tipo: stringa  
Modello: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`

### QueueInfo
<a name="QueueInfo"></a>

L'oggetto `QueueInfo` ha le seguenti proprietà:

**QueueArn**  
L'Amazon Resource Name (ARN) della coda.  
Tipo: String

**QueueType**  
Il tipo di coda.  
Tipo: String

### RoutingCriteria
<a name="RoutingCriteria"></a>

Elenco dei criteri di instradamento. Ogni volta che i criteri di instradamento vengono aggiornati su un contatto, verranno aggiunti a questo elenco.

**ActivationTimestamp**  
Il timestamp che indica quando i criteri di instradamento sono impostati come attivi. Un criterio di instradamento viene attivato quando il contatto viene trasferito in una coda.  
ActivationTimestamp verrà impostato sui criteri di routing per i contatti nella coda degli agenti anche se i criteri di routing non sono mai attivati per i contatti nella coda degli agenti.  
Tipo: String (yyyy-mm-ddThh:mm:ssZ)

**Index**  
Informazioni sull'indice dei criteri di instradamento.  
Tipo: Integer  
Valore minimo: 0

**Steps**  
Elenco dei passaggi di instradamento.  
Tipo: elenco di oggetti di passaggio  
Lunghezza: 1-5

### Steps
<a name="Steps"></a>

Se Amazon Connect non trova un agente disponibile che soddisfi i requisiti in un passaggio per una determinata durata del passaggio, i criteri di instradamento passeranno al passaggio successivo in sequenza fino al completamento del join con un agente. Quando tutti i passaggi sono esauriti, il contatto verrà offerto a qualsiasi agente nella coda. 

**Status**  
Rappresenta lo stato del passaggio di instradamento.  
Tipo: String  
Valori validi: EXPIRED, ACTIVE, JOINED, INACTIVE, DEACTIVATED, INTERRUPTED

**Expression**  
Un oggetto per specificare l'espressione di un passaggio di instradamento.  
Tipo: Expression

**Expiry**  
Un oggetto per specificare la scadenza di un passaggio di instradamento.  
Tipo: Expiry

### SystemEndpoint
<a name="SystemEndpoint"></a>

L'endpoint di sistema. Ad esempio, per INBOUND, questo è il numero di telefono che il cliente ha chiamato o l'indirizzo e-mail a cui il cliente ha contattato. Per OUTBOUND e EXTERNAL\$1OUTBOUND, si tratta del numero ID chiamante in uscita assegnato alla coda in uscita utilizzata per chiamare il cliente o dell'indirizzo e-mail in uscita assegnato alla coda in uscita utilizzata per contattare il cliente.

**Nota**  
Questo campo non è attualmente compilato per i contatti con il metodo di avvio dei contatti CALLBACK, MONITOR, QUEUE\$1TRANSFER.

**Type**  
Endpoint

### Endpoint
<a name="Endpoint"></a>

Informazioni relative a un endpoint In Amazon Connect, un endpoint è la destinazione di un contatto, ad esempio il numero di telefono di un cliente o un numero di telefono per il contact center.

**Address**  
Il valore per il tipo di endpoint. Per TELEPHONE\$1NUMBER, il valore è un numero di telefono nel formato E.164.  
Tipo: String  
Lunghezza: 1-256

**Type**  
Tipo di endpoint. Al momento, un endpoint può essere solo un numero di telefono.  
Valori validi: TELEPHONE\$1NUMBER \$1 VOIP \$1 CONTACT\$1FLOW \$1 CONNECT\$1PHONENUMBER\$1ARN \$1 EMAIL\$1ADDRESS

**DisplayName**  
Visualizza il nome dell’endpoint.  
Tipo: String  
Lunghezza: 0-256

### Recordings
<a name="Recordings"></a>

Se è stata abilitata la registrazione, si tratta delle informazioni relative alle registrazioni.

**Type**  
Matrice di RecordingsInfo

### RecordingsInfo
<a name="RecordingsInfo"></a>

Informazioni su una registrazione vocale, trascrizione di chat o registrazione dello schermo.

**DeletionReason**  
Se recording/transcript è stato eliminato, questo è il motivo inserito per l'eliminazione.  
Tipo: String

**FragmentStartNumber**  
Il numero che identifica il frammento Kinesis Video Streams dove viene avviato il flusso audio del cliente.  
Tipo: String

**FragmentStopNumber**  
Il numero che identifica il frammento Kinesis Video Streams dove viene arrestato il flusso audio del cliente.  
Tipo: String

**Location**  
La posizione, in Amazon S3, per la registrazione/trascrizione.  
Tipo: String  
Lunghezza: 0-256

**MediaStreamType**  
Informazioni relative al flusso di file multimediali utilizzato durante la conversazione.  
Tipo: String  
Valori validi: AUDIO, VIDEO, CHAT

**ParticipantType**  
Informazioni relative al partecipante alla conversazione: se si tratta di un agente o di un contatto. Di seguito sono riportati i tipi di partecipanti:  
+ Tutti
+ Manager
+ Agente
+ Cliente
+ ThirdParty
+ Supervisore
Tipo: String

**StartTimestamp**  
Quando è stata avviata la conversazione dell’ultimo canale di registrazione, nel fuso orario UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**Status**  
Lo stato della registrazione/trascrizione.  
Valori validi: AVAILABLE \$1 DELETED \$1 NULL

**StopTimestamp**  
Quando è stata interrotta la conversazione dell’ultimo canale di registrazione, nel fuso orario UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**StorageType**  
Dove recording/transcript è immagazzinato.  
Tipo: String  
Valori validi: Amazon S3 \$1 KINESIS\$1VIDEO\$1STREAM

### ContactDetails
<a name="ContactDetails"></a>

È una mappa delle coppie valore-chiave di stringa, che contiene attributi definiti dall’utente che vengono digitati all’interno del contatto. Questo oggetto viene utilizzato solo per i contatti delle attività.

**Key**  
Tipo: String  
Lunghezza: 1-128

**Value**  
Tipo: String  
Lunghezza: 0-1024

### ContactEvaluations
<a name="ContactEvaluations"></a>

Informazioni sulle valutazioni dei contatti, in cui la chiave è FormId : un identificatore univoco per il modulo.

**Type**  
Mappa di String, ContactEvaluation

### ContactEvaluation
<a name="ContactEvaluation"></a>

**EvaluationArn**  
Il nome della risorsa Amazon per il modulo di valutazione. È sempre presente.  
Tipo: String

**Status**  
Lo stato della valutazione.  
Tipo: String  
Valori validi: COMPLETE, IN\$1PROGRESS, DELETED

**StartTimestamp**  
La data e l’ora in cui è stata avviata la valutazione, nel fuso orario UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**EndTimestamp**  
La data e l’ora in cui è stata inviata la valutazione, nel fuso orario UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**DeleteTimestamp**  
La data e l’ora in cui è stata eliminata la valutazione, nel fuso orario UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**ExportLocation**  
Il percorso in cui è stata esportata la valutazione.  
Tipo: String  
Lunghezza: 0-256

### StateTransitions
<a name="StateTransitions"></a>

Elenco StateTransition per un supervisore.

**Type**  
StateTransition

### StateTransition
<a name="StateTransition"></a>

Informazioni sulla transizione di stato di un supervisore.

**StateStartTimestamp**  
La data e l'ora in cui lo stato è iniziato in formato UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**StateEndTimestamp**  
La data e l'ora in cui lo stato è terminato in formato UTC.  
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**State**  
Valori validi: SILENT\$1MONITOR \$1 BARGE

### OutboundStrategy
<a name="OutboundStrategy"></a>

Informazioni sulla strategia in uscita.

Tipo: oggetto [OutboundStrategy](https://docs.aws.amazon.com/connect/latest/APIReference/API_OutboundStrategy.html)

## Timestamp del contatto
<a name="contact-timestamps"></a>

**InitiationTimestamp**  
La data e l'ora in cui il contatto è stato avviato, in orario UTC. Nel caso in cui un contatto vocale sia stato avviato nell’ambito di una campagna in uscita, `InitiationTimestamp` visualizza quando è stato avviato il contatto per l’evento Initiated e verrà aggiornato a quando è stata avviata la chiamata negli eventi successivi.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z') 

**ConnectedToSystemTimestamp**  
La data e l'ora di connessione dell'endpoint del cliente ad Amazon Connect, in orario UTC. Per INBOUND, questo corrisponde. InitiationTimestamp Per OUTBOUND, CALLBACK e API, indica quando l’endpoint del cliente risponde.

**EnqueueTimestamp**  
La data e l'ora di aggiunta del contatto alla coda, in orario UTC.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z') 

**ConnectedToAgentTimestamp**  
La data e l'ora di connessione del contatto all'agente, in orario UTC.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z') 

**DisconnectTimestamp**  
La data e l’ora di disconnessione dell’endpoint del cliente dal contatto corrente, nel fuso orario UTC. Negli scenari DisconnectTimestamp di trasferimento, il contatto precedente indica la data e l'ora in cui il that contatto è terminato.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z') 

**ScheduledTimestamp**  
La data e l'ora dell'attivazione pianificata del flusso da parte di questo contatto, nell'ora UTC. Questa funzionalità è supportata solo per il canale delle attività.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z') 

**GreetingStartTimestamp**  
La data e l'ora di misurazione dell'inizio del saluto del cliente da una chiamata vocale in uscita, in orario UTC.   
Tipo: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**GreetingEndTimestamp**  
La data e l'ora di misurazione della fine del saluto del cliente da una chiamata vocale in uscita, in orario UTC.   
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

### ChatContactMetrics
<a name="chat-contact-metrics"></a>

Informazioni sulle interazioni complessive dei partecipanti a livello di contatto.

**MultiParty**  
Un flag booleano che indica se nel contatto è stata abilitata la chat multiparte o l’inserimento del supervisore.  
Tipo: Booleano

**TotalMessages**  
Il numero di messaggi di chat nel contatto.  
Tipo: numero intero  
Valore minimo: 0

**TotalBotMessages**  
Il numero totale di messaggi bot e automatici in un contatto di chat.  
Tipo: numero intero  
Valore minimo: 0

**TotalBotMessageLengthInChars**  
Il numero totale di caratteri dei messaggi bot e automatici in un contatto di chat.  
Tipo: numero intero  
Valore minimo: 0

**ConversationCloseTimeInMillis**  
Il tempo impiegato per terminare un contatto dopo l’ultimo messaggio del cliente.  
Tipo: long  
Valore minimo: 0

**ConversationTurnCount**  
Il numero di conversazioni si trasforma in un contatto di chat, che rappresenta gli back-and-forth scambi tra il cliente e gli altri partecipanti  
Tipo: numero intero  
Valore minimo: 0

**AgentFirstResponseTimestamp**  
Il timestamp della prima risposta dell’agente per un contatto di chat.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

**AgentFirstResponseTimeInMillis**  
Il tempo di risposta di un agente dopo aver ottenuto un contatto di chat.  
Tipo: long  
Valore minimo: 0

### ParticipantMetrics
<a name="participantmetrics"></a>

Informazioni sulle interazioni tra partecipanti in un contatto.

**ParticipantId**  
L’ID del partecipante.  
Tipo: String  
Lunghezza: 1-256

**ParticipantType**  
Informazioni sul partecipante alla conversazione. Di seguito sono riportati i tipi di partecipanti: [Agente, Cliente, Supervisore].  
Tipo: String

**ConversationAbandon**  
Un flag booleano che indica se la conversazione in chat è stata abbandonata da un partecipante.  
Tipo: Booleano

**MessagesSent**  
Numero di messaggi di chat inviati dal partecipante.  
Tipo: numero intero  
Valore minimo: 0

**NumResponses**  
Numero di messaggi di chat inviati dal partecipante.  
Tipo: numero intero  
Valore minimo: 0

**MessageLengthInChars**  
Numero di caratteri della chat inviati dal partecipante.  
Tipo: numero intero  
Valore minimo: 0

**TotalResponseTimeInMillis**  
Tempo totale di risposta in chat del partecipante.  
Tipo: long  
Valore minimo: 0

**MaxResponseTimeInMillis**  
Tempo massimo di risposta in chat del partecipante.  
Tipo: long  
Valore minimo: 0

**LastMessageTimestamp**  
Timestamp dell’ultimo messaggio di chat del partecipante.  
Tipo: stringa (aaaa-MM-gg'T'HH:mm:ss.SSS'Z')

## Iscrizione agli eventi di contatto di Amazon Connect
<a name="subscribe-contact-events"></a>

Gli eventi di contatto di Amazon Connect vengono pubblicati tramite [Amazon EventBridge](https://aws.amazon.com/eventbridge/) e possono essere abilitati in un paio di passaggi per la tua istanza Amazon Connect nella EventBridge console Amazon creando una nuova regola. Sebbene gli eventi non siano ordinati, hanno un timestamp che consente di utilizzare i dati.

Gli eventi vengono emessi secondo il principio del [massimo sforzo](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).

Per iscriverti agli eventi di contatto di Amazon Connect:

1. Nella EventBridge console Amazon, scegli **Crea regola**.

1. Nella pagina **Dettagli regola predefinita**, assegna un nome alla regola, scegli **Regola con un modello di eventi**, quindi scegli **Successivo**, come mostrato nell'immagine seguente.  
![\[La pagina di dettaglio di definizione della regola nella EventBridge console.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/eventbridge-createrule.png)

1. Nella pagina **Crea modello di evento**, in **Origine evento**, verifica che siano selezionati **AWS gli eventi o gli eventi dei EventBridge partner**.

1. In **Tipo di evento di esempio**, scegli **AWS eventi**, quindi scegli ** Amazon Connect Contact Event** dalla casella a discesa, come mostrato nell'immagine seguente.  
![\[La sezione degli eventi di esempio, il tipo di evento di esempio è Eventi AWS.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/eventbridge-sampleevents.png)

1. Per Metodo di creazione, seleziona Utilizza modulo del modello. Nella sezione **Modello di eventi**, scegli **Servizi AWS **, **Amazon Connect**, **Evento di contatto Amazon Connect **, quindi scegli **Successivo**, come mostrato nell’immagine seguente.  
![\[Le sezioni Metodo di creazione e Modello evento della pagina Dettagli della regola predefinita.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/eventbridge-creationmethod.png)

1. Nella pagina Seleziona destinazioni, puoi quindi selezionare una destinazione di tua scelta, che include una funzione Lambda, una coda SQS o un argomento SNS. Per informazioni sulla configurazione degli obiettivi, [Amazon EventBridge targets](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).

1. Configura i tag in modo facoltativo. Nella pagina **Esamina e crea**, scegli **Crea regola**.

 Per ulteriori informazioni sulla configurazione delle regole, consulta le [ EventBridge regole di Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) nella *Amazon EventBridge User Guide*. 

## Esempio per l'interruzione dello streaming di un tipo di evento
<a name="stop-streaming-event"></a>

L'esempio seguente mostra come interrompere lo streaming di un `CONTACT_DATA_UPDATED` evento da Amazon Connect a EventBridge.

```
{
  "source": [
    "aws.connect"
  ],
  "detail-type": [
    "Amazon Connect Contact Event"
  ],
  "detail": {
    "eventType": [
      {
        "anything-but": [
          "CONTACT_DATA_UPDATED"
        ]
      }
    ]
  }
}
```

## Evento di contatto di esempio per la riuscita connessione di una chiamata vocale a un agente
<a name="sample-contact-event"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "contactId":"11111111-1111-1111-1111-111111111111",
        "channel":"VOICE",
        "instanceArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"INBOUND",
        "eventType":"CONNECTED_TO_AGENT",
        "agentInfo":{
          "agentArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
          "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
          "hierarchyGroups": { 
                         "level1": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a",
                        },
                        "level2": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b",
                        },
                        "level3": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c",
                        },
                        "level4": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d",
                        },
                        "level5": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e",
                        }
                 } 
            }
        },   
         "queueInfo": {  
            "queueType":"type",
            "queueArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2021-08-04T17:29:04.000Z"
          },
         "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
         } 
    }
}
```

## Evento di contatto di esempio per la riuscita disconnessione di una chiamata vocale
<a name="sample-contact-event-call-disconnected"></a>

L'evento di esempio seguente mostra un contatto che dispone di un tag definito dall'utente con **Dept** come chiave. Tieni presente che non `queueInfo` è incluso negli eventi ricevuti da EventBridge when `initiationMethod` is`OUTBOUND`.

```
{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType": "DISCONNECTED",
        "contactId": "11111111-1111-1111-1111-111111111111",
        "initialContactId": "11111111-2222-3333-4444-555555555555",
        "previousContactId": "11111111-2222-3333-4444-555555555555",
        "channel": "Voice",
        "instanceArn": "arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod": "OUTBOUND",
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "connectedToSystemTimestamp":"2021-08-04T17:17:55.000Z",
        "disconnectTimestamp":"2021-08-04T17:18:37.000Z",
        "agentInfo": {
            "agentArn": "arn",
            "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
            "hierarchyGroups": { 
                 "level1": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a",
                },
                "level2": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b",
                },
                "level3": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c",
                },
                "level4": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d",
                },
                "level5": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e",
                }
            } 
        },
           
        "CustomerVoiceActivity": {
           "greetingStartTimestamp":"2021-08-04T17:29:20.000Z",
           "greetingEndTimestamp":"2021-08-04T17:29:22.000Z",
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890",
            "Dept":"Finance"
        }
    }
}
```

## Evento di esempio per l'aggiornamento delle proprietà dei contatti
<a name="sample-updated-event"></a>

```
{
"version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
"detail": {
    "eventType": "CONTACT_DATA_UPDATED",
    "contactId": "the contact ID",
    "channel": "CHAT",
    "instanceArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID",
    "initiationMethod": "API",
    "queueInfo": {
        "queueArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/queue/the queue ID",
        "enqueueTimestamp": "2023-10-24T02:39:15.240Z",
        "queueType": "STANDARD"
    },
    "agentInfo": {
        "agentArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent/the agent ID",
        "connectedToAgentTimestamp": "1970-01-01T00:00:00.001Z",
        "hierarchyGroups": {
            "level1": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level2": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level3": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level4": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            }
        }
    },
    "updatedProperties": ["ContactLens.ConversationalAnalytics.Configuration"],
    "initiationTimestamp": "2023-10-24T02:39:15.154Z",
    "connectedToSystemTimestamp": "1970-01-01T00:00:00.001Z",
    "tags": {
        "aws:connect:instanceId": "the instance ID"
       },
    "contactLens": {
        "conversationalAnalytics": {
            "configuration": {
                "enabled": true,
                "channelConfiguration": {
                    "analyticsModes": ["PostContact"]
                },
                "languageLocale": "en-US",
                "redactionConfiguration": {
                    "behavior": "Enable",
                    "policy": "RedactedAndOriginal",
                    "entities": ["EMAIL"],
                    "maskMode": "EntityType"
                }
            }
        }
    }
}
}
```

## Evento di contatto di esempio relativo alla connessione di una chiamata vocale a un agente utilizzando i criteri di instradamento
<a name="sample-routing-criteria-event-connected"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "OrExpression": [{
                       "AttributeCondition": {
                           "Name": "Technology",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 2.0,
                           "Value": "AWS Kinesis"
                       }
                    },
                    {
                       "AttributeCondition": {
                           "Name": "Language",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 4.0,
                           "Value": "English"
                        }
                    }],
                    "AndExpression": [{
                        "AttributeCondition": {
                            "Name": "Language",
                            "ComparisonOperator": "NumberGreaterOrEqualTo",
                            "ProficiencyLevel": 2.0,
                            "Value": "Spanish"
                        }
                    }]
                }
            }]
        }]
    }
}
```

## Esempio di evento relativo alla scadenza del passaggio di instradamento su un contatto
<a name="sample-routing-step-expires"></a>

```
{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType":"CONTACT_DATA_UPDATED",
        "contactId":"12345678-1234-1234-1234-123456789012",
        "channel":"CHAT",
        "instanceArn":"arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"API",
        "queueInfo":{
            "queueArn":"arn:aws:connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2023-11-01T18:33:03.062Z",
            "queueType":"STANDARD"
        },
        "updatedProperties":["RoutingCriteria.Step.Status"],
        "initiationTimestamp":"2023-11-01T18:33:00.716Z",
        "connectedToSystemTimestamp":"2023-11-01T18:33:01.736Z",
        "tags":{
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012"
        },
        "routingCriteria":{
            "steps":[{
                "expiry":{
                    "durationInSeconds":50,
                    "expiryTimestamp":"2023-11-01T18:34:54.275Z"
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Location",
                        "value":"AZ",
                        "proficiencyLevel":3.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"EXPIRED"
            },
            {
                "expiry":{
                    "durationInSeconds":10
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":4.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"ACTIVE"
            },
            {
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":1.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"INACTIVE"
            }],
            "activationTimestamp":"2023-11-01T18:34:04.275Z",
            "index":1
        }
    }
}
```

## Evento di contatto di esempio relativo alla connessione di una chiamata vocale a un agente fornito dal cliente utilizzando i criteri di routing
<a name="sample-contact-event-voice-call-routing-criteria"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "AttributeCondition": {
                        "ComparisonOperator": "Match",
                        "MatchCriteria": {
                            "AgentsCriteria": {
                                "AgentIds": ["AGENT_1"]
                            }
                        }
                    }
                }
            }]
        }]
    }
}
```