Endpunkte für Agent-Aktivitäten

Agentenaktivitäts-Logs sind Aufzeichnungen, die immer dann erstellt werden, wenn sich der Status des Widgets ändert. Das kann durch die Anmeldung im Widget, den Erhalt einer Deltacast-Anrufbenachrichtigung oder die Annahme eines Anrufs erfolgen. Bei jeder Aktivität wird ein neues Objekt erstellt. Anhand des folgenden Modells können Sie prüfen, welche Felder möglicherweise personenbezogene Daten enthalten:

[
  {
    "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
  }
]

In der folgenden Tabelle finden Sie eine Zusammenfassung aller Aktivitäten, die zur Erstellung eines Aktivitätslogs führen können.

Aktivität	Beschreibung
chat_picked_up	Ereignis, das auftritt, wenn ein Agent einen anderen Agenten auswählt
chat_pick_up_attempt	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter versucht, der antwortende Kundenservicemitarbeiter zu werden
chat_notification_offered	Ereignis, das auftritt, wenn ein Endnutzer eine Chatsitzung anfordert und eine Benachrichtigung an die Agenten gesendet wird, die dieser Warteschlange zugewiesen sind.
call_notification_offered	Ereignis, das auftritt, wenn ein Endnutzer anruft und dem Kundenservicemitarbeiter eine Benachrichtigung über einen Multicast- oder Deltacast-Anruf angezeigt wird.
call_pick_up_attempt	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter versucht, einen Multicast- oder Deltacast-Anruf anzunehmen.
call_picked_up	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter einen Multicast- oder Deltacast-Anruf annimmt.
deltacast_call_notification_offered	Ereignis, das angibt, dass ein Endnutzer eine Warteschlange mit Multicast angerufen hat, in der ein Deltacast-Anruf an einen Kundenservicemitarbeiter in dieser Warteschlange übertragen wird.
deltacast_call_pick_up_attempt	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter versucht, einen Anruf mit Delta-Routing zu beantworten
deltacast_call_picked_up	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter einen per Deltacast übertragenen Anruf erfolgreich beantwortet.
deltacast_call_missed	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter einen Deltacast-Anruf nicht annimmt
multicast_call_notification_offered	Ereignis, das angibt, dass ein Endnutzer eine Warteschlange mit Multicast angerufen hat, in der ein Multicast-Anruf an die Kundenservicemitarbeiter in dieser Warteschlange übertragen wird
multicast_call_pick_up_attempt	Ereignis, das auftritt, wenn ein Mitarbeiter versucht hat, einen Multicast-Anruf anzunehmen
multicast_call_picked_up	Ereignis, das auftritt, wenn ein per Multicast gesendeter Anruf von einem Kundenservicemitarbeiter beantwortet wurde
call_outbound_dialing	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter das Wähltastenfeld im Widget verwendet, um einen Endnutzer anzurufen.
user_status_changed	Ereignis, das auftritt, wenn ein Kundenservicemitarbeiter den Status seines Widgets ändert
Anmeldung	Ereignis, das auftritt, wenn sich ein Kundenservicemitarbeiter vom Widget abmeldet
Abmelden	Ereignis, das auftritt, wenn sich ein Kundenservicemitarbeiter im Widget anmeldet

Aktivitätsprotokolle von KI-Agenten

Parameter	Erforderlich	Datentyp	Definition
sort_column	FALSE	String	Sortiert die Antwort anhand eines beliebigen Felds im Antwortobjekt.
sort_direction	FALSE	ASC oder DESC	Gibt die Sortierreihenfolge an, entweder aufsteigend oder absteigend.
Seite	FALSE	String	Paare mit „per“, um die Seite der Datensätze anzugeben. Wenn „per“ beispielsweise auf 200 und „page“ auf 2 festgelegt ist, enthält die Antwort die Datensätze 201 bis 400, da Seite 1 die Datensätze 1 bis 200 enthält.
pro	FALSE	String	Paare mit Seite, um anzugeben, wie viele Datensätze in einer Seite mit Datensätzen enthalten wären. Wenn „per“ beispielsweise auf 200 und „page“ auf 2 festgelegt ist, enthält die Antwort die Datensätze 201 bis 400, da Seite 1 die Datensätze 1 bis 200 enthält.
started_at[from]	FALSE	Uhrzeit in UTC	Erstellt eine Untergrenze für das Feld „Begonnen am“. Alle zurückgegebenen Datensätze liegen nach dem eingegebenen Wert.
started_at[to]	FALSE	Uhrzeit in UTC	Erstellt eine Obergrenze für das Feld „Begonnen am“. Alle zurückgegebenen Datensätze liegen vor dem eingegebenen Wert.
ended_at[from]	FALSE	Uhrzeit in UTC	Erstellt eine Untergrenze für das Feld „Ended at“ (Beendet am). Alle zurückgegebenen Datensätze liegen nach dem eingegebenen Wert.
ended_at[to]	FALSE	Uhrzeit in UTC	Erstellt eine Obergrenze für das Feld „Ended at“ (Beendet am). Alle zurückgegebenen Datensätze liegen vor dem eingegebenen Wert.
duration[from]	FALSE	Zahl	Erstellt eine Untergrenze für das Feld „Zeitraum“. Alle zurückgegebenen Datensätze liegen nach dem eingegebenen Wert.
duration[to]	FALSE	Zahl	erstellt eine Obergrenze für das Feld „Dauer“. Alle zurückgegebenen Datensätze liegen vor dem eingegebenen Wert.
id[]	FALSE	Array[String]	Array[Strings]. ID der Datensätze, die gesucht und zurückgegeben werden sollen
agent_id[]	FALSE	Array[String]	Antwort nach Agent-ID filtern
activity[]	FALSE	Array[String]	filtert Datensätze nach der Aufgabe/Aktivität, die der Agent ausgeführt hat. Mögliche Werte sind: 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	Array[String]	Filtert die Antwort nach der Agent-ID. „Whodunnit“ ist eine Teilmenge des Agent-Objekts und verwendet dieselbe „agent_id“ als Primärschlüssel.
call_id[]	FALSE	Array[String]	Filtert Datensätze nach eingegebenen Anruf-IDs.
chat_id[]	FALSE	Array[String]	Filtert Datensätze nach eingegebenen Chat-IDs.

Endpunkt:

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

Weitere Beispielanfragen/-antworten

Beispielanfrage: Beispiel für Aktivitätsprotokolle für Agents

Body: None

Beispielantwort: Beispiel für Agent-Aktivitätsprotokolle

[
    {
        "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
    }
]

Statuscode:200