Points de terminaison de l'activité de l'agent

Les journaux d'activité des agents sont des enregistrements créés chaque fois que l'état du widget a changé. Il peut s'agir de la connexion au widget, de la réception d'une notification d'appel Deltacast ou de l'acceptation d'un appel, entre autres. Chaque activité crée un nouvel objet. Reportez-vous au modèle suivant pour vérifier quels champs peuvent contenir des informations permettant d'identifier personnellement l'utilisateur :

[
  {
    "id": 0,
    "agent_id": 0,
    "whodunnit": {
      "id": 0,
      "name": "string",
      "last_name": "string",
      "first_name": "string",
      "agent_number": "string",
      "avatar_url": "string"
    },
    "status": {
      "id": 0,
      "wfm_id": 0,
      "name": "string",
      "color": "string"
    },
    "started_at": "2018-06-06T21:12:24.766Z",
    "ended_at": "2018-06-06T21:12:24.766Z",
    "duration": 0,
    "activity": "login",
    "call_id": 0,
    "chat_id": 0
  }
]

Le tableau suivant récapitule toutes les activités pouvant entraîner la création d'un journal d'activité.

Activité	Description
chat_picked_up	Événement qui se produit lorsqu'un agent prend un appel
chat_pick_up_attempt	Événement qui se produit lorsqu'un agent tente de devenir l'agent répondant
chat_notification_offered	Événement qui se produit lorsqu'un utilisateur final demande une session de chat et qu'une notification est envoyée aux agents affectés à cette file d'attente.
call_notification_offered	Événement qui se produit lorsqu'un utilisateur final appelle et qu'une notification d'appel multicast ou deltacast est proposée à l'agent.
call_pick_up_attempt	Événement qui se produit lorsqu'un agent tente de répondre à un appel multicast ou deltacast.
call_picked_up	Événement qui se produit lorsqu'un agent répond à un appel multicast ou deltacast.
deltacast_call_notification_offered	Événement indiquant qu'un utilisateur final a appelé une file d'attente avec multicast, où un appel deltacast est ensuite diffusé à un agent de cette file d'attente.
deltacast_call_pick_up_attempt	Événement qui se produit lorsqu'un agent tente de répondre à un appel DeltaCsted
deltacast_call_picked_up	Événement qui se produit lorsqu'un agent répond correctement à un appel transmis.
deltacast_call_missed	Événement qui se produit lorsqu'un agent ne répond pas à son appel Deltacast
multicast_call_notification_offered	Événement indiquant qu'un utilisateur final a appelé une file d'attente avec multidiffusion, puis qu'un appel multidiffusion a été diffusé aux agents de cette file d'attente
multicast_call_pick_up_attempt	Événement qui se produit lorsqu'un agent a tenté de répondre à un appel multidiffusé
multicast_call_picked_up	Événement qui se produit lorsqu'un agent a répondu à un appel multidiffusé
call_outbound_dialing	Événement qui se produit lorsqu'un agent utilise le clavier numérique du widget pour appeler un utilisateur final.
user_status_changed	Événement qui se produit lorsqu'un agent modifie l'état de son widget
connexion	Événement qui se produit lorsqu'un agent se déconnecte du widget
Déconnexion	Événement qui se produit lorsqu'un agent se connecte au widget

Journaux d'activité des agents

Paramètre	Obligatoire	Type de données	Définition
sort_column	FALSE	Chaîne	Trie la réponse en fonction de n'importe quel champ de l'objet de réponse.
sort_direction	FALSE	ASC ou DESC	Indique le sens du tri (croissant ou décroissant).
page	FALSE	Chaîne	Associé à "par" pour indiquer la page des enregistrements. Par exemple, si "per" est défini sur 200 et "page" sur 2, la réponse contiendra les enregistrements 201 à 400, car la page 1 contiendra les enregistrements 1 à 200.
par	FALSE	Chaîne	Associez-le à la page pour indiquer le nombre d'enregistrements à inclure sur une page d'enregistrements. Par exemple, si "per" est défini sur 200 et "page" sur 2, la réponse contiendra les enregistrements 201 à 400, car la page 1 contiendra les enregistrements 1 à 200.
started_at[from]	FALSE	Heure en UTC	crée une limite inférieure pour le champ "Démarré à". Tous les enregistrements renvoyés seront postérieurs à la valeur saisie.
started_at[to]	FALSE	Heure en UTC	crée une limite supérieure pour le champ "Commencé à". Tous les enregistrements renvoyés seront antérieurs à la valeur saisie.
ended_at[from]	FALSE	Heure en UTC	crée une limite inférieure pour le champ "Terminé le". Tous les enregistrements renvoyés seront postérieurs à la valeur saisie.
ended_at[to]	FALSE	Heure en UTC	crée une limite supérieure pour le champ "Terminé le". Tous les enregistrements renvoyés seront antérieurs à la valeur saisie.
duration[from]	FALSE	Nombre	crée une limite inférieure pour le champ de durée. Tous les enregistrements renvoyés seront postérieurs à la valeur saisie.
duration[to]	FALSE	Nombre	crée une limite supérieure pour le champ de durée. Tous les enregistrements renvoyés seront antérieurs à la valeur saisie.
id[]	FALSE	Tableau[Chaîne]	Array[Strings]. ID des enregistrements à rechercher et à renvoyer
agent_id[]	FALSE	Tableau[Chaîne]	Filtre la réponse par ID d'agent
activity[]	FALSE	Tableau[Chaîne]	filtre les enregistrements en fonction de la tâche/activité accomplie par l'agent. Les valeurs possibles sont les suivantes : login, logout, call_outbound_dialing, deltacast_call_notification_offered, deltacast_call_pick_up_attempt, deltacast_call_picked_up, deltacast_call_projected, deltacast_call_missed, deltacast_call_bounced, multicast_call_notification_offered, multicast_call_pick_up_attempt, multicast_call_picked_up, user_status_changed, chat_notification_offered, chat_pick_up_attempt, chat_picked_up
whodunnit_id[]	FALSE	Tableau[Chaîne]	Filtre la réponse par ID d'agent. Whodunnit est un sous-ensemble de l'objet agent et utilise le même agent_id comme clé primaire.
call_id[]	FALSE	Tableau[Chaîne]	Filtre les enregistrements en fonction des ID d'appel saisis
chat_id[]	FALSE	Tableau[Chaîne]	Filtre les enregistrements en fonction des ID de chat saisis

Point de terminaison :

Method: GET
Type: 
URL: https://{​{subdomain}​}.{​{domain}​}/manager/api/v1/agent_activity_logs

Autres exemples de requêtes/réponses :

Exemple de requête : exemple de journaux d'activité des agents

Corps : aucun

Exemple de réponse : exemple de journaux d'activité des agents

[
    {
        "id": 190578,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
            "wfm_id": 36
        },
        "started_at": "2017-12-22T00:54:18.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "logout",
        "whodunnit": null
    },
    {
        "id": 199548,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
            "wfm_id": 36
        },
        "started_at": "2018-01-09T22:54:26.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "logout",
        "whodunnit": null
    },
    {
        "id": 190577,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
            "wfm_id": 36
        },
        "started_at": "2017-12-22T00:54:18.000Z",
        "ended_at": "2018-01-08T22:54:22.000Z",
        "duration": 1548004,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 199547,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
            "wfm_id": 36
        },
        "started_at": "2018-01-09T22:54:26.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 190270,
        "agent_id": 118,
        "status": {
            "id": -1,
            "name": "Unavailable",
            "color": "red",
            "wfm_id": 12
        },
        "started_at": "2017-12-21T21:34:14.000Z",
        "ended_at": "2017-12-22T00:54:18.000Z",
        "duration": 12004,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 198036,
        "agent_id": 118,
        "status": {
            "id": -1,
            "name": "Unavailable",
            "color": "red",
            "wfm_id": 12
        },
        "started_at": "2018-01-08T22:54:22.000Z",
        "ended_at": "2018-01-09T22:54:26.000Z",
        "duration": 86404,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 22249,
        "agent_id": 129,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
            "wfm_id": 36
        },
        "started_at": "2017-06-19T18:34:39.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "login",
        "whodunnit": null
    }
]

Code d'état : 200