Endpoint aktivitas agen

Log aktivitas agen adalah catatan yang dibuat setiap kali status widget berubah. Status ini dapat berasal dari login ke widget, mendapatkan notifikasi panggilan deltacast, atau menerima panggilan di antara status lainnya. Setiap aktivitas membuat objek baru. Lihat model berikut untuk memverifikasi kolom mana yang mungkin berisi (PII).:

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

Tabel berikut berisi ringkasan setiap aktivitas yang dapat menyebabkan pembuatan log aktivitas.

Aktivitas Deskripsi
chat_picked_up Peristiwa yang terjadi saat agen mengambil agen
chat_pick_up_attempt Peristiwa yang terjadi saat agen mencoba menjadi agen yang merespons
chat_notification_offered Peristiwa yang terjadi setelah pengguna akhir meminta sesi chat dan notifikasi dikirim ke agen yang ditugaskan ke antrean tersebut.
call_notification_offered Peristiwa yang terjadi saat pengguna akhir melakukan panggilan dan notifikasi panggilan multicast atau deltacast ditawarkan kepada agen.
call_pick_up_attempt Peristiwa yang terjadi saat agen mencoba menjawab panggilan multicast atau deltacast.
call_picked_up Peristiwa yang terjadi saat agen menjawab panggilan multicast atau deltacast.
deltacast_call_notification_offered Peristiwa yang mencatat bahwa pengguna akhir telah menelepon ke antrean dengan multicast, lalu panggilan deltacast disiarkan ke agen dalam antrean tersebut.
deltacast_call_pick_up_attempt Peristiwa yang terjadi saat agen mencoba menjawab panggilan deltacst
deltacast_call_picked_up Peristiwa yang terjadi saat agen berhasil menjawab panggilan deltacast.
deltacast_call_missed Peristiwa yang terjadi saat agen tidak menjawab panggilan deltacast
multicast_call_notification_offered Peristiwa yang mencatat bahwa pengguna akhir telah menelepon ke antrean dengan multicast yang kemudian menyiarkan panggilan multicast ke agen dalam antrean tersebut
multicast_call_pick_up_attempt Peristiwa yang terjadi saat panggilan multi-cast telah dicoba untuk dijawab oleh agen
multicast_call_picked_up Peristiwa yang terjadi saat panggilan multi-cast telah dijawab oleh agen
call_outbound_dialing Peristiwa yang terjadi saat agen menggunakan papan tombol di widget untuk menelepon pengguna akhir.
user_status_changed Peristiwa yang terjadi saat agen mengubah status widgetnya
login Peristiwa yang terjadi saat agen keluar dari widget
logout Peristiwa yang terjadi saat agen login ke widget

Log aktivitas agen

Parameter Wajib Jenis Data Definisi
sort_column FALSE String Mengurutkan respons berdasarkan kolom apa pun dalam objek respons.
sort_direction FALSE ASC atau DESC Mencatat arah pengurutan, baik menaik atau menurun
halaman FALSE String Berpasangan dengan per untuk mencatat halaman rekaman. Misalnya, jika per ditetapkan menjadi 200 dan page adalah 2, respons akan berisi data 201-400, karena page 1 akan berisi 1-200.
per FALSE String Dipasangkan dengan halaman untuk mencatat jumlah data yang akan disertakan dalam halaman data. Misalnya, jika per ditetapkan menjadi 200 dan halaman adalah 2, respons akan berisi data 201-400, karena halaman 1 akan berisi 1-200.
started_at[from] FALSE Waktu dalam UTC membuat batas bawah kolom dimulai pada. Semua data yang ditampilkan akan berada setelah nilai yang dimasukkan.
started_at[to] FALSE Waktu dalam UTC membuat batas atas kolom dimulai pada. Semua data yang ditampilkan akan berada sebelum nilai yang dimasukkan.
ended_at[from] FALSE Waktu dalam UTC membuat batas bawah kolom berakhir pada. Semua data yang ditampilkan akan berada setelah nilai yang dimasukkan.
ended_at[to] FALSE Waktu dalam UTC membuat batas atas kolom berakhir pada. Semua data yang ditampilkan akan berada sebelum nilai yang dimasukkan.
duration[from] FALSE Angka membuat batas bawah kolom durasi. Semua data yang ditampilkan akan berada setelah nilai yang dimasukkan.
duration[to] FALSE Angka membuat batas atas kolom durasi. Semua data yang ditampilkan akan berada sebelum nilai yang dimasukkan.
id[] FALSE Array[String] Array[String]. ID catatan yang akan ditelusuri dan ditampilkan
agent_id[] FALSE Array[String] Memfilter respons menurut ID agen
activity[] FALSE Array[String] memfilter catatan menurut tugas/aktivitas yang telah diselesaikan agen. Nilai yang mungkin adalah: 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] Memfilter respons menurut ID agen. Whodunnit adalah subset objek agen, dan menggunakan agent_id yang sama sebagai kunci utamanya
call_id[] FALSE Array[String] Memfilter rekaman menurut ID panggilan yang dimasukkan
chat_id[] FALSE Array[String] Memfilter rekaman menurut ID chat yang dimasukkan

Endpoint:

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

Contoh Permintaan/Respons lainnya:

Contoh permintaan: Contoh log aktivitas agen

Isi: Tidak ada

Contoh respons: Contoh log aktivitas agen

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

Kode Status: 200