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à.
Modello di dati dei flussi di eventi degli agenti in Amazon Connect
I flussi di eventi degli agenti vengono creati in formato JavaScript Object Notation (JSON). Per ogni tipo di evento viene inviato un blob JSON al flusso di dati Kinesis. I seguenti tipi di eventi sono inclusi nei flussi di eventi degli agenti:
-
LOGIN: l'accesso dell'agente al contact center.
-
LOGOUT: la disconnessione di un agente dal contact center.
-
STATE_CHANGE: si è verificato uno dei seguenti cambiamenti:
-
Lo stato dell'agente è cambiato nel Pannello di controllo contatti (CCP). Ad esempio, c'è stata una modifica da Available (Disponibile) a on Break (Pausa).
-
Lo stato della conversazione tra l'agente e il contatto è cambiato. Ad esempio, sono stati connessi e quindi messi in attesa.
-
Una delle seguenti impostazioni è stata modificata nella configurazione dell'agente:
-
Il loro profilo di instradamento
-
Le code nel loro profilo di instradamento
-
Chiamata accettazione automatica
-
Indirizzo Sip
-
Gruppo di gerarchia degli agenti
-
Impostazione delle preferenze linguistiche nel CCP
-
-
-
HEART_BEAT: questo evento viene pubblicato ogni 120 secondi se non vengono pubblicati altri eventi in quell'intervallo.
Nota
Questi eventi continuano a essere pubblicati fino a un'ora dopo la disconnessione di un agente.
Oggetti eventi
AgentEvent
L'oggetto AgentEvent
ha le seguenti proprietà:
- AgentARN
-
L'Amazon Resource Name (ARN) per l'account dell'agente.
Tipo: ARN
- AWSAccountId
-
L'ID AWS account a 12 cifre per l' AWS account associato all'istanza Amazon Connect.
Tipo: stringa
- CurrentAgentSnapshot
-
Contiene la configurazione di un agente, ad esempio nome utente, nome, cognome, profilo di instradamento, gruppi gerarchici, contatti e stato agente.
Tipo: oggetto
AgentSnapshot
- EventId
-
L'identificatore univoco universale (UUID) per l'evento.
Tipo: stringa
- EventTimestamp
-
Un timestamp per l'evento, nel formato standard ISO 8601.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
- EventType
-
Tipo di evento.
Valori validi:
STATE_CHANGE
|HEART_BEAT
|LOGIN
|LOGOUT
- InstanceARN
-
Amazon Resource Name per l'istanza Amazon Connect in cui viene creato l'account utente dell'agente.
Tipo: ARN
- PreviousAgentSnapshot
-
Contiene la configurazione di un agente, ad esempio nome utente, nome, cognome, profilo di instradamento, gruppi gerarchici, contatti e stato agente.
Tipo: oggetto
AgentSnapshot
- Versione
-
La versione del flusso di eventi degli agenti in formato data, ad esempio 2019-05-25.
Tipo: stringa
AgentSnapshot
L'oggetto AgentSnapshot
ha le seguenti proprietà:
- AgentStatus
-
Dati dello stato dell'agente, incluso:
-
ARN: l'ARN per lo stato corrente dell'agente (non per l'agente).
-
Name: questo è lo stato dell'agente impostato manualmente nel CCP o che il supervisore modifica manualmente nel report delle metriche in tempo reale.
Ad esempio, lo stato potrebbe essere Available (Disponibile), il che significa che sono pronti per l'instradamento dei contatti in ingresso. Oppure potrebbe trattarsi di uno stato personalizzato, ad esempio Break (Pausa) o Training, il che significa che i contatti in ingresso non possono essere instradati a loro, ma possono comunque effettuare chiamate in uscita.
Lo stato di
Error
indica un errore interno di Amazon Connect. -
StartTimestamp—Il timestamp in formato standard ISO 8601 per l'ora in cui l'agente ha inserito lo stato.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
-
Tipo: ROUTABLE, CUSTOM o OFFLINE
Tipo:
AgentStatus
oggetto. -
- NextAgentStatus
-
Se l'agente imposta uno stato di agente successivo, i dati vengono visualizzati qui.
-
ARN: l'ARN dello stato dell'agente che l'agente ha impostato come stato successivo.
-
Name: nome dello stato dell'agente che l'agente ha impostato come stato successivo.
-
EnqueuedTimestamp—Il timestamp in formato standard ISO 8601 per l'ora in cui l'agente ha impostato lo stato successivo e ha sospeso il routing dei contatti in entrata.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
Tipo:
NextAgentStatus
oggetto. -
- Configurazione
-
Informazioni sull'agente, tra cui:
-
FirstName—Il nome dell'agente.
-
HierarchyGroups—Il gruppo gerarchico a cui è assegnato l'agente, se presente.
-
LastName—Il cognome dell'agente.
-
RoutingProfile—Il profilo di routing a cui è assegnato l'agente.
-
Username: il nome utente Amazon Connect dell'agente.
Tipo: oggetto
Configuration
-
- Contatti
-
I contatti
Tipo: oggetto
List of Contact Objects
Configurazione
L'oggetto Configuration
ha le seguenti proprietà:
- FirstName
-
Il nome immesso nell'account Amazon Connect dell'agente.
Tipo: stringa
Lunghezza: 1-100
- AgentHierarchyGroups
-
Il gruppo della gerarchia, fino a cinque livelli di raggruppamento, per l'agente associato all'evento.
Tipo: oggetto
AgentHierarchyGroups
- LastName
-
Il cognome immesso nell'account Amazon Connect dell'agente.
Tipo: stringa
Lunghezza: 1-100
- Competenze
-
Elenco di tutte le competenze assegnate all'agente.
Tipo: elenco di oggetti Competenza
- RoutingProfile
-
Il profilo di instradamento assegnato all'agente associato all'evento.
Tipo:
RoutingProfile
oggetto. - Username
-
Il nome utente per l'account utente Amazon Connect dell'agente.
Tipo: stringa
Lunghezza: 1-100
Oggetto Contact
L'oggetto Contact
ha le seguenti proprietà:
- ContactId
-
L'identificatore del contatto.
Tipo: stringa
Lunghezza: 1-256
- InitialContactId
-
L'identificatore originale del contatto che è stato trasferito.
Tipo: stringa
Lunghezza: 1-256
- Canale
-
Il metodo di comunicazione.
Valori validi:
VOICE
,CHAT
,TASKS
- InitiationMethod
-
Indica la modalità di avvio iniziale del contatto.
Valori validi:
-
INBOUND
: il cliente ha avviato il contatto vocale (telefonico) con il contact center. -
OUTBOUND
: un agente ha avviato il contatto vocale (telefonico) con il cliente, utilizzando il CCP per chiamarne il numero. Questo metodo di iniziazione chiama l'API. StartOutboundVoiceContact -
TRANSFER
: il cliente è stato trasferito da un agente a un altro agente o a una coda, utilizzando connessioni rapide nel CCP. Ciò comporta la creazione di un nuovo record di contatto. -
CALLBACK
: il cliente è stato contattato nell'ambito di un flusso di callback.Per ulteriori informazioni su InitiationMethod in questo scenario, vedereRichiamate in coda con parametri in tempo reale in Amazon Connect.
-
API
: il contatto è stato avviato con Amazon Connect tramite API. Potrebbe trattarsi di un contatto in uscita che hai creato e messo in coda a un agente, utilizzando l'StartOutboundVoiceContactAPI, oppure di una chat dal vivo avviata dal cliente con il tuo contact center, dove hai chiamato l'API. StartChatConnect -
WEBRTC_API
: Il contatto ha utilizzato il widget di comunicazione per effettuare una chiamata vocale/video in-app a un agente. -
QUEUE_TRANSFER
: mentre il cliente era in una coda (in ascolto del flusso coda clienti), è stato trasferito a un'altra coda utilizzando 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.Nota
Questo stato viene visualizzato solo se hai attivato Chiamate multiparte e Monitoraggio avanzato.
-
DISCONNECT
: quando viene attivato un blocco Set Disconnect Flow (Imposta flusso di disconnessione), specifica quale flusso eseguire dopo un evento di disconnessione durante un contatto.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 se non viene completata entro 30 giorni.
Se viene creato un nuovo contatto durante l'esecuzione di un flusso di disconnessione, il metodo di avvio per quel nuovo contatto è DISCONNECT.
-
- Stato
-
Lo stato del contatto.
Valori validi:
INCOMING
|PENDING
|CONNECTING
|CONNECTED
|CONNECTED_ONHOLD
|MISSED
|PAUSED
|REJECTED
|ERROR
|ENDED
Nota
Lo stato
PAUSED
è disponibile solo per le attività. - StateStartTimestamp
-
L'ora in cui il contatto ha assunto lo stato attuale.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
- ConnectedToAgentTimestamp
-
L'ora in cui il contatto è stato connesso a un agente.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
- QueueTimestamp
-
L'ora in cui il contatto è stato inserito all'interno di una coda.
Tipo: String (aaaa-mm-ggThh:mm:ss.sssZ)
- Queue
-
La coda in cui è stato posizionato il contatto.
Tipo: oggetto
Queue
HierarchyGroup oggetto
L'oggetto HierarchyGroup
ha le seguenti proprietà:
- ARN
-
L'Amazon Resource Name (ARN) per la gerarchia dell'agente.
Tipo: stringa
- Nome
-
Il nome del gruppo di gerarchie.
Tipo: stringa
AgentHierarchyGroups oggetto
L'oggetto AgentHierarchyGroups
ha le seguenti proprietà:
- Level1
-
Include i dettagli di Level1 della gerarchia assegnata all'agente.
Tipo: oggetto
HierarchyGroup
- Level2
-
Include i dettagli di Level2 della gerarchia assegnata all'agente.
Tipo: oggetto
HierarchyGroup
- Level3
-
Include i dettagli di Level3 della gerarchia assegnata all'agente.
Tipo: oggetto
HierarchyGroup
- Level4
-
Include i dettagli di Level4 della gerarchia assegnata all'agente.
Tipo: oggetto
HierarchyGroup
- Level5
-
Include i dettagli di Level5 della gerarchia assegnata all'agente.
Tipo: oggetto
HierarchyGroup
Competenza
L'oggetto Proficiency
ha le seguenti proprietà:
- Nome
-
Il nome dell'attributo predefinito.
Tipo: stringa
Lunghezza: 1-64
- Valore
-
Il valore dell'attributo predefinito.
Tipo: stringa
- ProficiencyLevel
-
Il livello di competenza dell'agente.
Tipo: Float
Valori validi: 1,0, 2,0, 3,0, 4,0 e 5,0
Oggetto Queue
L'oggetto Queue
ha le seguenti proprietà:
- ARN
-
L'Amazon Resource Name (ARN) della coda.
Tipo: stringa
- Nome
-
Il nome della coda.
Tipo: stringa
- Canali
-
Tipo di canale di comunicazione.
Tipo: elenco di oggetti Channel
RoutingProfile oggetto
L'oggetto RoutingProfile
ha le seguenti proprietà:
- ARN
-
L'Amazon Resource Name (ARN) del profilo di instradamento dell'agente.
Tipo: stringa
- Nome
-
Il nome del profilo di instradamento.
Tipo: stringa
- InboundQueues
-
Gli oggetti
Queue
associati al profilo di instradamento dell'agente.Tipo: elenco di oggetto
Queue
- DefaultOutboundQueue
-
La coda in uscita di default per il profilo di routing dell'agente.
Tipo: oggetto
Queue
- Simultaneità
-
Un elenco di informazioni sulla simultaneità. Gli oggetti informativi sulla concorrenza hanno valori AvailableSlots (numero), canale (un oggetto canale) e MaximumSlots (numero).