Copy page

Tim & Laporan

Tampilan & Laporan

Halaman ini membahas empat fitur yang mengontrol cara tim Anda memfilter inbox, menyusun widget dashboard, menerima laporan berkala via email, dan menelusuri riwayat pengiriman massal.

---

Tampilan Bersama (Shared Inbox Views)

Rute: /settings/shared-views

Shared inbox views adalah filter inbox yang dapat digunakan bersama oleh seluruh tim — atau dibatasi ke divisi tertentu. Setiap view menyimpan sekumpulan filter dalam format JSON (mis. status, prioritas, kanal) sehingga agent tidak perlu mengulang konfigurasi filter secara manual setiap kali membuka inbox.

Cara kerja

Code
Admin buat view → disimpan ke tabel shared_inbox_views (PostgreSQL)
                  ↓
GET /api/shared-inbox-views → hanya yang is_active = true, diurutkan sort_order lalu name
                  ↓
Inbox menampilkan view sebagai pintasan filter cepat

Membuat atau mengedit view

1. Buka Settings → Shared Views.
2. Klik New View di pojok kanan atas.
3. Isi formulir:
   • Name — wajib diisi, tidak boleh kosong.
   • Description — opsional, keterangan singkat untuk tim.
   • Filters (JSON) — objek JSON berisi kriteria filter, mis. {"status":"open","channel":"whatsapp"}.
   • Division ID — UUID divisi jika view hanya untuk satu divisi; kosongkan untuk semua divisi.
   • Sort Order — urutan tampil (default 0); nilai lebih kecil muncul lebih dulu.
4. Klik Create atau Update.

Menghapus view

Klik ikon tempat sampah di baris view, lalu konfirmasi. Penghapusan permanen — tidak ada soft-delete.

Endpoint (tag Shared Inbox Views)

Aksi	Endpoint
List view aktif	GET /api/shared-inbox-views
Buat view	POST /api/shared-inbox-views
Update view	PATCH /api/shared-inbox-views/{id}
Hapus view	DELETE /api/shared-inbox-views/{id}

Skema lengkap di API Reference.

---

Tata Letak Dashboard

Rute: /settings/dashboard-layout

Setiap agent dapat menyusun widget mana yang muncul di dashboard mereka dan urutan tampilannya. Konfigurasi disimpan per-agent — perubahan Anda tidak mempengaruhi tampilan agent lain.

Widget yang tersedia

Tipe widget	Label
conversations_overview	Conversations Overview
response_time	Response Time
csat_score	CSAT Score
active_agents	Active Agents
channel_distribution	Channel Distribution
sla_compliance	SLA Compliance
recent_activity	Recent Activity
my_conversations	My Conversations

Mengatur tata letak

1. Buka Settings → Dashboard Layout.
2. Panel Available Widgets di kanan menampilkan semua widget yang belum aktif.
3. Klik + Label Widget untuk menambahkan ke daftar Active Widgets.
4. Gunakan tombol ▲ / ▼ untuk mengubah urutan.
5. Klik Remove untuk mengeluarkan widget dari layout.
6. Klik Save Layout untuk menyimpan.

Penyimpanan

Layout disimpan ke tabel dashboard_layouts dengan upsert pada agent_id. Jika belum ada layout tersimpan, API mengembalikan array kosong sebagai default.

Endpoint (tag Dashboard)

Aksi	Endpoint
Ambil layout	GET /api/dashboard/layout
Simpan layout	PUT /api/dashboard/layout

Skema lengkap di API Reference.

---

Laporan Terjadwal

Rute: /settings/reports

Fitur ini memungkinkan admin dan supervisor membuat laporan analitik berkala yang dikirim otomatis via email. Halaman memiliki tiga tab: Scheduled Reports, Quick Reports, dan Report History.

Tab: Scheduled Reports

Laporan terjadwal dieksekusi oleh background scheduler (scheduler.rs) yang berjalan setiap 30 detik — scheduler mengambil semua laporan dengan next_run_at <= NOW() dan is_active = true, lalu mengirim email HTML, kemudian memperbarui last_sent_at dan menghitung next_run_at berikutnya.

Membuat laporan terjadwal:

1. Buka Settings → Reports → Scheduled Reports.
2. Klik New Report.
3. Isi formulir:
   • Report Name — nama laporan, wajib diisi.
   • Frequency — Daily, Weekly, atau Monthly.
   • Report Type — lihat tabel di bawah.
   • Recipients — alamat email dipisah koma, titik koma, atau baris baru. Minimal satu email valid.
   • First Send / Next Run — waktu pertama laporan dikirim (datetime-local). Setelah terkirim, jadwal berikutnya dihitung otomatis.
   • Active — centang untuk mengaktifkan; hapus centang untuk menjeda tanpa menghapus.
4. Klik Create Report.

Tipe laporan:

Nilai	Label	Isi laporan
overview	Conversations Summary	Total, open, resolved conversations; contacts; agents online
agent_performance	Agent Performance	Per-agent: open, resolved, total, avg FRT, avg AHT (maks. 50 agent)
channel_metrics	Channel Analytics	Per-kanal: jumlah kontak dan percakapan
full	Full Report	Gabungan ketiga bagian di atas

Jadwal pengiriman berikutnya:

Frekuensi	Interval
daily	+1 hari
weekly	+7 hari
monthly	+30 hari (perkiraan)

Aksi cepat per laporan:

• Power icon — aktifkan / jedakan laporan.
• Send icon — kirim sekarang (POST /api/scheduled-reports/{id}/send) tanpa menunggu jadwal.
• Edit icon — buka form edit.
• Hapus — klik ikon tempat sampah, konfirmasi dengan Confirm.

Tab: Quick Reports

Unduh laporan on-demand sebagai file CSV tanpa perlu membuat jadwal.

1. Pilih rentang tanggal (From / To) atau gunakan preset Last 7 days, Last 30 days, Last 90 days.
2. Klik Download CSV pada salah satu kartu laporan.

Jenis quick report:

Kartu	Data yang diunduh
Conversations Report	Metrik overview dari GET /api/analytics/overview
Agent Performance	Metrik per-agent dari GET /api/analytics/agents
CSAT Report	Ringkasan dan per-agent dari GET /api/analytics/csat?period=30d
Channel Analytics	Breakdown per-kanal dari GET /api/analytics/channels

Tab: Report History

Log lokal dari laporan yang telah dikirim atau diunduh dalam sesi halaman saat ini. History tidak disimpan ke server — membuka ulang halaman akan mengosongkan daftar.

Hak akses

Semua endpoint scheduled-reports memerlukan permission settings.manage (hanya admin dan supervisor).

Endpoint (tag Scheduled Reports)

Aksi	Endpoint
List laporan	GET /api/scheduled-reports
Detail laporan	GET /api/scheduled-reports/{id}
Buat laporan	POST /api/scheduled-reports
Update laporan	PATCH /api/scheduled-reports/{id}
Hapus laporan	DELETE /api/scheduled-reports/{id}
Kirim sekarang	POST /api/scheduled-reports/{id}/send

Skema lengkap di API Reference.

---

Riwayat Bulk Send

Rute: /settings/bulk-send-history

Halaman ini menampilkan log historis dari semua operasi pengiriman massal (bulk send) template WhatsApp yang pernah dijalankan di platform. Berguna untuk memantau status kampanye broadcast, mendeteksi kegagalan pengiriman, dan mengaudit penggunaan template.

Kolom tabel

Kolom	Deskripsi
Template	Nama template (template_name) atau 8 karakter pertama dari template_id jika nama tidak tersedia
Status	pending, in_progress, completed, atau failed
Total	Jumlah kontak yang ditargetkan (total_contacts)
Sent	Jumlah pesan berhasil dikirim (sent_count)
Failed	Jumlah pesan gagal (failed_count)
Date	Waktu operasi dibuat (created_at)

Memuat data

Halaman memuat hingga 100 log terbaru saat pertama kali dibuka, diurutkan dari yang terbaru. Tidak ada auto-refresh — muat ulang halaman untuk melihat entri baru.

Endpoint

Aksi	Endpoint
List log	GET /api/bulk-send-logs
Statistik agregat	GET /api/analytics/bulk-sends

Parameter query untuk GET /api/bulk-send-logs:

• limit — jumlah record (default 50, maks 200)
• offset — offset untuk paginasi

Endpoint GET /api/analytics/bulk-sends mengembalikan statistik agregat termasuk delivery_rate dan breakdown per-template, berguna untuk tampilan ringkasan di dashboard analytics.

Skema lengkap di API Reference.

---

Rute terkait

• Kampanye Broadcast — membuat dan memantau kampanye broadcast
• Analytics & Laporan — grafik tren dan tabel metrik lengkap
• Kebijakan SLA — konfigurasi SLA yang muncul di widget sla_compliance
• Divisi — UUID divisi untuk scope shared inbox views