Lewati ke konten utama

Laporan, Ekspor, dan CSAT

Ringkasan performa layanan pelanggan — volume percakapan, respons agen, tim, inbox, label, SLA, dan kepuasan pelanggan (CSAT) — tersedia lewat laporan agregat dan berkas CSV. Halaman beranda juga menampilkan hitungan antrean langsung.

Tujuan​

  • Melihat ringkasan dan deret-waktu percakapan (per agen, tim, inbox, label) dalam rentang hingga 90 hari.
  • Melihat agregat SLA dan skor CSAT dari respons survei sungguhan.
  • Mengekspor laporan sebagai CSV untuk analisis lanjutan.
  • Memantau hitungan langsung percakapan terbuka, belum ditugaskan, dan sesi WAHA dari beranda.

Untuk siapa​

  • Owner dan admin: melihat laporan (view_reports) dan mengekspor (export_data).
  • Supervisor: memantau performa tim lewat ringkasan dan ekspor.
  • Agent: memantau antrean langsung di beranda (bukan laporan agregat).

Prasyarat​

  • Izin view_reports untuk seluruh endpoint laporan; tanpa izin, permintaan ditolak 403.
  • Izin export_data untuk mengunduh CSV — dalam praktik hanya dimiliki owner.
  • Rentang tanggal laporan: bawaan 30 hari, maksimum 90 hari; format YYYY-MM-DD.

Alur kerja​

1. Memantau antrean langsung di beranda​

  1. Buka beranda aplikasi web.
  2. Lihat hitungan langsung: percakapan terbuka, percakapan belum ditugaskan, dan sesi WAHA yang terhubung.
  3. Gunakan daftar antrean langsung yang diurutkan menurut risiko SLA untuk memprioritaskan kerja.

Catatan: metrik grafik respons pertama dan tren SLA menampilkan keterangan belum tersedia di beranda; angka tersebut hanya dapat diambil lewat endpoint laporan oleh admin/developer (lihat Langkah 2).

2. Mengambil laporan agregat​

Dasbor laporan belum tersedia di aplikasi web, jadi laporan agregat dan deret-waktu diambil lewat endpoint API:

  1. Admin atau developer memanggil endpoint laporan yang sesuai (lihat Referensi API):
    • ringkasan (overview) dan deret-waktu percakapan;
    • laporan per agen, per tim, per inbox, per label;
    • laporan SLA dan CSAT;
    • kesehatan sesi WAHA dan risiko penugasan.
  2. Kirim rentang tanggal (from/to, YYYY-MM-DD) dan filter yang berlaku. Laporan percakapan menerima filter inbox, tim, agen, status, prioritas, dan label; laporan lain hanya rentang tanggal.
  3. Nilai di luar rentang maksimum otomatis dijepit; format salah mengembalikan rentang bawaan 30 hari.

Bila Anda supervisor dan membutuhkan angka laporan, mintalah owner/admin untuk mengambilnya, atau arahkan developer ke endpoint di atas.

3. Mengekspor CSV​

Tombol unduh belum tersedia di UI, jadi ekspor CSV juga dijalankan lewat endpoint API oleh admin/developer:

  1. Gunakan endpoint ekspor untuk laporan yang diinginkan (mis. percakapan, CSAT, SLA).
  2. Tanggapan berupa berkas CSV yang dihasilkan seketika (sinkron), dengan sel dibersihkan dari karakter pemecah.
  3. Simpan dan buka berkas di aplikasi lembar kerja Anda.

Izin export_data diperlukan; tanpa izin, permintaan ekspor ditolak 403.

4. Menilai kepuasan pelanggan (CSAT)​

  1. Skor CSAT agregat dihitung dari respons survei (csat_responses) dan dapat dilihat lewat laporan CSAT (diambil oleh admin/developer seperti Langkah 2).
  2. Survei dikirim ke pelanggan dengan token unik; pelanggan menjawab lewat tautan publik tanpa login.
  3. Jawaban kedua pada survei yang sama ditolak setelah status berubah dari sent (konflik). Alur pengiriman dan pengisian survei dijelaskan pada dokumentasi pelanggan/CSAT tersendiri.

Tanda berhasil​

  • Laporan mengembalikan agregat dan deret-waktu yang konsisten dengan rentang yang diminta.
  • Berkas CSV terunduh berisi baris data laporan yang sama dengan respons JSON.
  • Skor CSAT memperbarui agregat setelah pelanggan mengirimkan jawaban.
  • Beranda menampilkan hitungan antrean langsung yang terkini.

Jika terjadi masalah​

GejalaPenyebabPemulihan
403 saat mengakses laporanTidak memiliki view_reports (hanya owner/admin)Hubungi owner workspace
403 saat mengunduh CSVTidak memiliki export_data (owner)Minta owner mengunduh atau menyesuaikan akses
Rentang tanggal tidak berlakuRentang melebihi 90 hari atau format salahKirim ulang dengan rentang ≤ 90 hari (YYYY-MM-DD)
Angka CSAT kosongBelum ada respons survei pada rentangPeriksa rentang; pastikan survei sudah dikirim
Beranda menampilkan metrik tidak tersediaGrafik tren butuh endpoint laporan yang belum dihubungkan ke berandaMinta admin/developer mengambil lewat endpoint laporan/ekspor

Batasan​

  • Belum ada layar dasbor laporan di aplikasi web: grafik dan unduhan CSV tersedia lewat endpoint berizin (view_reports untuk laporan, export_data untuk ekspor) dan belum ada tombol unduh di UI. Pengambilan lewat endpoint dilakukan oleh admin/developer; kontrak permintaan ada di Referensi API.
  • Ekspor bersifat sinkron: berkas dihasilkan saat permintaan; tidak ada pekerjaan latar atau notifikasi.
  • Laporan nilai penjualan memakai izin terpisah (view_sales_values/export_sales_reports); lihat Pipeline penjualan dan peluang.
  • Ekspor dan penghapusan data pelanggan (tata kelola data) ditangani domain terpisah, bukan lewat endpoint laporan ini.
  • Laporan mencakup data hingga 90 hari ke belakang; rentang lebih panjang tidak didukung.

Tugas terkait​