

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modèle de données des flux d’événements d’agent dans Amazon Connect
<a name="agent-event-stream-model"></a>

Les flux d'événements de l'agent sont créés au format JSON ( JavaScript Object Notation). Pour chaque type d'événement, un blob JSON est envoyé au flux de données Kinesis. Les types d'événements suivants sont inclus dans les flux d'événements de l'agent :
+ LOGIN : une connexion de l'agent au centre de contact.
+ LOGOUT : une déconnexion de l'agent du centre de contact.
+ STATE\$1CHANGE : un des éléments suivants a changé :
  + L'agent a modifié son statut dans le Panneau de configuration du contact (CCP). Par exemple, il a changé de Disponible à Pause.
  + L'état de la conversation entre l'agent et le contact a changé. Par exemple, ils étaient connectés, puis en attente. 
  + L'un des paramètres suivants a été modifié dans la configuration de l'agent :
    + Leur profil de routage
    + Les files d'attente dans leur profil de routage
    + Accepter automatiquement l'appel
    + Adresse Sip
    + Groupe de hiérarchie des agents
    + Paramètre de préférence de langue dans le CCP
+ HEART\$1BEAT : cet événement est publié toutes les 120 secondes si aucun autre événement n'est publié pendant cet intervalle.
**Note**  
Ces événements continuent d'être publiés jusqu'à une heure après la fermeture de session d'un agent. 

**Topics**
+ [AgentEvent](#AgentEvent)
+ [AgentSnapshot](#AgentSnapshot)
+ [Configuration](#Configuration)
+ [Objet du contact](#Contact)
+ [HierarchyGroup objet](#Hierarchygroup-object)
+ [AgentHierarchyGroups objet](#Hierarchygroups-object)
+ [Compétence](#proficiency-object)
+ [Objet Queue](#queue-object)
+ [RoutingProfile objet](#routingprofile)

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

L'objet `AgentEvent` inclut les propriétés suivantes :

**AgentARN**  
Amazon Resource Name (ARN) du compte de l'agent.  
Type : ARN

**AWSAccountId**  
L'identifiant de AWS compte à 12 chiffres du AWS compte associé à l'instance Amazon Connect.  
Type : Chaîne

**CurrentAgentSnapshot**  
Contient la configuration de l'agent, comme le nom d'utilisateur, le prénom, le nom de famille, le profil de routage, les groupes de hiérarchie, les contacts et le statut de l'agent.  
Type : objet `AgentSnapshot`

**EventId**  
Identifiant universel unique (UUID) de l'événement.  
Type : Chaîne

**EventTimestamp**  
Un horodatage de l'événement au format standard ISO 8601.  
Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)

**EventType**  
Type d’événement.   
Valeurs valides : `STATE_CHANGE` \$1 `HEART_BEAT` \$1 `LOGIN` \$1 `LOGOUT` 

**InstanceARN**  
Amazon Resource Name de l'instance d'Amazon Connect dans laquelle le compte d'utilisateur de l'agent est créé.  
Type : ARN

**PreviousAgentSnapshot**  
Contient la configuration de l'agent, comme le nom d'utilisateur, le prénom, le nom de famille, le profil de routage, les groupes de hiérarchie, les contacts et le statut de l'agent.   
Type : objet `AgentSnapshot`

**Version**  
Version du flux d'événements de l'agent au format de date, par exemple 2019-05-25.  
Type : Chaîne

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

L'objet `AgentSnapshot` inclut les propriétés suivantes :

**AgentStatus**  
Données sur le statut de l'agent, y compris :  
+ ARN : ARN correspondant au statut actuel de l'agent (et non à l'agent). 
+ Nom : il s'agit du [statut de l'agent qu'il a défini manuellement dans le CCP](metrics-agent-status.md) ou que le superviseur a [modifié manuellement dans le rapport de métriques en temps réel](rtm-change-agent-activity-state.md). 

  Par exemple, son statut peut être **Disponible**, ce qui signifie qu'il est prêt pour que les contacts entrants soient routés vers lui. Ou il peut s'agir d'un statut personnalisé, tel que Pause ou Formation, ce qui signifie que les contacts entrants ne peuvent pas être routés vers lui, mais qu'ils peuvent quand même effectuer des appels sortants.

  Le statut `Error` indique une erreur Amazon Connect interne.
+ StartTimestamp—L'horodatage au format standard ISO 8601 indique l'heure à laquelle l'agent a saisi le statut.

  Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)
+ Type : ROUTABLE, CUSTOM ou OFFLINE
Type : objet `AgentStatus`

**NextAgentStatus**  
Si l'agent définit un statut d'agent suivant, les données apparaissent ici.  
+ ARN : ARN du statut de l'agent que l'agent a défini comme son statut suivant.
+ Nom : il s'agit du nom du statut d'agent que l'agent a défini comme son statut suivant.
+ EnqueuedTimestamp—L'horodatage au format standard ISO 8601 indique l'heure à laquelle l'agent a défini son prochain statut et suspendu le routage des contacts entrants.

  Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)
Type : objet `NextAgentStatus`

**Configuration**  
Informations relatives à l'agent, y compris :   
+ FirstName—Le prénom de l'agent.
+ HierarchyGroups: le groupe hiérarchique auquel l'agent est affecté, le cas échéant.
+ LastName—Le nom de famille de l'agent.
+ RoutingProfile: le profil de routage auquel l'agent est affecté.
+ Nom d'utilisateur : nom d'utilisateur Amazon Connect de l'agent.
Type : objet `Configuration`

**Contacts**  
Les contacts  
Type : objet `List of Contact Objects`

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

L'objet `Configuration` inclut les propriétés suivantes :

**FirstName**  
Prénom saisi dans le compte Amazon Connect de l'agent.  
Type : String  
Longueur : de 1 à 100

**AgentHierarchyGroups**  
Groupe hiérarchique (jusqu'à cinq niveaux de regroupement) pour l'agent associé à l'événement.  
Type : objet `AgentHierarchyGroups`

**LastName**  
Nom de famille saisi dans le compte Amazon Connect de l'agent.  
Type : String  
Longueur : de 1 à 100

**Compétences**  
Liste de toutes les compétences attribuées à l’agent.  
Type : liste des objets de compétence

**RoutingProfile**  
Profil de routage attribué à l'agent associé à l'événement.  
Type : objet `RoutingProfile`

**Nom d’utilisateur**  
Nom d'utilisateur du compte d'utilisateur Amazon Connect de l'agent.  
Type : String  
Longueur : de 1 à 100

## Objet du contact
<a name="Contact"></a>

L'objet `Contact` inclut les propriétés suivantes :

**ContactId**  
Identifiant du contact.  
Type : String  
Longueur : de 1 à 256

**InitialContactId**  
Identifiant d'origine du contact qui a été transféré.  
Type : String  
Longueur : de 1 à 256

**Channel**  
Méthode de communication.  
Valeurs valides : `VOICE`, `CHAT`, `TASKS`

**InitiationMethod**  
Indique la manière dont le contact a été initié.   
Valeurs valides :  
+  `INBOUND` : le client a initié un contact vocal (téléphonique) avec votre centre de contact. 
+  `OUTBOUND` : un agent a initié un contact vocal (téléphonique) avec le client, en utilisant le CCP pour appeler son numéro. Cette méthode d'initiation appelle l'[StartOutboundVoiceContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundVoiceContact.html)API.
+  `TRANSFER` : le client a été transféré par un agent à un autre agent ou à une file d'attente à l'aide de connexions rapides dans le CCP. Cela entraîne la création d'un nouvel enregistrement de contact.
+  `CALLBACK` : le client a été contacté dans le cadre d'un flux de rappel. 

  Pour plus d'informations sur InitiationMethod ce scénario, consultez[Rappels mis en file d’attente dans les métriques en temps réel d’Amazon Connect](about-queued-callbacks.md). 
+  `API` : le contact a été initié avec Amazon Connect par API. Il peut s'agir d'un contact sortant que vous avez créé et mis en file d'attente auprès d'un agent, à l'aide de l'[StartOutboundVoiceContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundVoiceContact.html)API, ou d'un chat en direct initié par le client avec votre centre de contact, où vous avez appelé l'API. [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)
+  `WEBRTC_API`: le contact a utilisé le widget de communication pour voice/video appeler un agent dans l'application.
+  `QUEUE_TRANSFER` : lorsque le client était dans une file d'attente (écoute du flux de file d'attente du client), il a été transféré dans une autre file d'attente à l'aide d'un bloc de flux.
+  `MONITOR` : un superviseur a lancé la surveillance d'un agent. Le superviseur peut surveiller silencieusement l'agent et le client, ou intervenir de manière impromptue dans la conversation.
**Note**  
Ce statut ne s’affiche que si vous avez activé les [appels entre plusieurs parties et la surveillance améliorée](update-instance-settings.md#update-telephony-options). 
+  `DISCONNECT` : lorsqu'un bloc [Set disconnect flow (Définir le flux de déconnexion)](set-disconnect-flow.md) est déclenché, il indique le flux à exécuter après un événement de déconnexion lors d'un contact. 

  Un événement de déconnexion se produit quand :
  + Un chat ou une tâche est déconnecté.
  + Une tâche est déconnectée suite à une action de flux.
  + Une tâche expire. La tâche est automatiquement déconnectée lorsque son délai d’expiration s’est écoulé. La valeur par défaut est de 7 jours et l’expiration des tâches peut être configurée pour atteindre jusqu’à 90 jours. 

  Si un nouveau contact est créé pendant l'exécution d'un flux de déconnexion, la méthode d'initiation de ce nouveau contact est DISCONNECT.
+  `EXTERNAL_OUTBOUND` : un agent a établi un contact vocal (téléphonique) avec un participant externe à votre centre de contact à l'aide d'une connexion rapide dans le CCP ou d'un bloc de flux.
+  `AGENT_REPLY` : un agent a répondu à un e-mail entrant pour créer une réponse par e-mail sortant.
+  `FLOW`: e-mail initié par un bloc de flux.
+  `CAMPAIGN_PREVIEW`: Le contact a été initié par une campagne sortante utilisant le mode de numérotation préliminaire. L'agent prévisualise les informations du client avant de passer l'appel.

**State**  
État du contact.  
Valeurs valides : `INCOMING` \$1 `PENDING` \$1 `CONNECTING` \$1 `CONNECTED` \$1 `CONNECTED_ONHOLD` \$1 `MISSED` \$1 `PAUSED` \$1 `REJECTED` \$1 `ERROR` \$1 `ENDED`   
L’état `PAUSED` est disponible uniquement pour les tâches.

**StateStartTimestamp**  
Heure à laquelle le contact est passé à l'état actuel.  
Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)

**ConnectedToAgentTimestamp**  
Heure à laquelle le contact a été mis en relation avec un agent.  
Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)

**QueueTimestamp**  
Heure à laquelle le contact a été placé dans une file d'attente.  
Type : String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*.*sss*Z)

**File d’attente**  
File d'attente dans laquelle le contact a été mis.  
Type : objet `Queue`

## HierarchyGroup objet
<a name="Hierarchygroup-object"></a>

L'objet `HierarchyGroup` inclut les propriétés suivantes :

**ARN**  
Amazon Resource Name (ARN) de la hiérarchie de l'agent.  
Type : String

**Nom**  
Nom du groupe hiérarchique.  
Type : Chaîne

## AgentHierarchyGroups objet
<a name="Hierarchygroups-object"></a>

L'objet `AgentHierarchyGroups` inclut les propriétés suivantes :

**Level1**  
Inclut les détails de niveau 1 de la hiérarchie attribuée à l'agent.  
Type : objet `HierarchyGroup`

**Level2**  
Inclut les détails de niveau 2 de la hiérarchie attribuée à l'agent.  
Type : objet `HierarchyGroup`

**Level3**  
Inclut les détails de niveau 3 de la hiérarchie attribuée à l'agent.  
Type : objet `HierarchyGroup`

**Level4**  
Inclut les détails de niveau 4 de la hiérarchie attribuée à l'agent.  
Type : objet `HierarchyGroup`

**Level5**  
Inclut les détails de niveau 5 de la hiérarchie attribuée à l'agent.  
Type : objet `HierarchyGroup`

## Compétence
<a name="proficiency-object"></a>

L'objet `Proficiency` inclut les propriétés suivantes :

**Nom**  
Nom de l’attribut prédéfini.  
Type : String  
Longueur : de 1 à 64

**Value**  
Valeur de l’attribut prédéfini.  
Type : Chaîne

**ProficiencyLevel**  
Niveau de compétence de l’agent.  
Type : Float  
Valeurs valides : 1,0, 2,0, 3,0, 4,0 et 5,0

## Objet Queue
<a name="queue-object"></a>

L'objet `Queue` inclut les propriétés suivantes :

**ARN**  
Amazon Resource Name (ARN) de la file d'attente.  
Type : String

**Nom**  
Nom de la file d'attente.  
Type : String

**Canaux**  
Type de canal de communication.  
Type : liste d'objets canaux

## RoutingProfile objet
<a name="routingprofile"></a>

L'objet `RoutingProfile` inclut les propriétés suivantes :

**ARN**  
Amazon Resource Name (ARN) du profil de routage de l'agent.  
Type : String

**Nom**  
Nom du profil de routage.  
Type : Chaîne

**InboundQueues**  
Liste des objets `Queue` associés au profil de routage de l'agent.  
Type : liste d'objets `Queue`

**DefaultOutboundQueue**  
File d'attente sortante par défaut pour le profil de routage de l'agent.  
Type : objet `Queue`

**Concurrency**  
Liste d'informations de simultanéité. Les objets d'information de AvailableSlots simultanéité ont des valeurs (nombre), Canal (un objet de canal) et MaximumSlots (nombre).