Modello di dati dei flussi di eventi degli agenti in Amazon Connect - Amazon Connect

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.

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