Lewati ke isi

Troubleshooting — Masalah Umum & Solusi

Tujuan

Halaman ini berisi masalah yang sering di-alami counselor, marketing, dan admin di dashboard HUPH — dari pesan yang tidak muncul sampai cluster routing yang aneh. Setiap entry dijelaskan dengan gejala → penyebab → solusi pertama. Kalau masalah tidak terdaftar di sini, lapor ke tim dev lewat kanal biasa.

Prasyarat

  • Paham dashboard dasar — Getting started
  • Log in dengan role yang relevan

Entry Troubleshooting

1. Pesan user tidak muncul di Inbox

Gejala: User bilang sudah kirim WA, tapi percakapan tidak ada di tab Conversations/Inbox. Penyebab: Webhook 360dialog mungkin terlambat diterima, atau backend API down. Solusi pertama: Refresh halaman. Kalau masih kosong, buka tab baru dan cek https://huph.val.id/health — kalau 503 atau timeout, hubungi dev team segera.

2. Aria jawab kosong atau "maaf saya tidak mengerti"

Gejala: Aria konsisten jawab dengan pesan bingung/fallback untuk topik yang seharusnya ada di KB. Penyebab: Retrieval mismatch — keyword yang dicari tidak match dokumen yang di-indeks; atau embed cache stale. Solusi pertama: Buka Knowledge base → tab Evaluation → Retrieval Sandbox → ketik query yang sama → lihat dokumen mana yang diambil. Kalau dokumen relevan tidak muncul, tambahkan/update konten di Documents atau Web Sources.

3. Label waktu "7 jam lalu" padahal baru saja

Gejala: Event baru terjadi (pesan masuk, lead baru) tapi label waktu langsung menunjukkan 7 jam lalu. Penyebab: Timezone bug pada Postgres trigger — kolom timestamp tanpa timezone tidak di-cast AT TIME ZONE 'UTC' sebelum di-serialize (sudah di-fix April 2026, tapi bisa kambuh kalau ada trigger baru). Solusi pertama: Refresh halaman. Kalau label benar setelah refresh, itu stale cache frontend. Kalau tetap salah, lapor dev team — ada trigger yang perlu di-patch.

4. Sidebar dan header scroll bersama content

Gejala: Ketika scroll di halaman Conversations atau Leads, sidebar dan header juga ikut scroll — merusak layout. Penyebab: Enterprise shell pattern bug — min-h-screen di authenticated-layout.tsx (bukan h-screen overflow-hidden). Harusnya sudah di-fix, tapi bisa kambuh saat ada perubahan layout. Solusi pertama: Refresh halaman; kalau tetap, lapor dev team — mereka perlu re-verify layout shell.

5. Lead count mismatch antara /leads-v2 dan Overview

Gejala: List /admin/leads-v2 menunjukkan 26 lead, tapi Overview dashboard menunjukkan angka berbeda. Penyebab: Cluster merge belum trigger, atau polling 30s + delay aggregate. Solusi pertama: Tunggu 1 menit, refresh dua-duanya. Kalau masih beda, cek filter chip di /leads-v2 — mungkin Anda melihat subset (misal actionable yang tidak termasuk enrolled/lost).

6. FAQ tidak match walaupun wording mirip

Gejala: User tanya dengan bahasa yang mirip FAQ yang sudah ada, tapi Aria jawab via full LLM (lambat), bukan via FAQ. Penyebab: Dify Annotation matching strict; variasi wording tidak ter-match. Solusi pertama: Buka FAQ page → edit FAQ terkait → tambahkan Alternative questions dengan variasi wording yang mungkin → Save → coba lagi. Sinkron Dify butuh ~5 detik.

7. Cluster tidak pindah setelah reassign

Gejala: Admin klik Reassign di detail lead, pilih cluster baru, konfirmasi. Tapi list /leads-v2 tetap menunjukkan lead di cluster lama. Penyebab: Cache frontend stale, atau polling belum tick. Solusi pertama: Logout → login ulang. Cache session akan reset. Kalau masih salah, cek di database langsung (hubungi dev) — reassign mungkin gagal silently.

8. Langfuse dashboard kosong atau timeout

Gejala: Buka https://langfuse.huph.val.id tapi dashboard kosong, blank, atau loading terus. Penyebab: ClickHouse (storage backend Langfuse) bisa OOM saat memory limit tight. Sudah di-fix 2026-04-08 dengan memory cap + log disable, tapi tetap bisa kambuh kalau ada traffic burst. Solusi pertama: Lapor ke dev team — mereka akan cek docker stats | grep clickhouse dan restart container kalau perlu. Jangan panik — data tidak hilang, hanya query layer yang stuck.

9. Chatbot WA tidak jawab lebih dari 24 jam setelah interaksi terakhir

Gejala: User kirim WA, bot tidak jawab sama sekali setelah percakapan sempat berhenti >24 jam. Penyebab: WhatsApp 24-hour session window expired. Outbound free-form hanya bisa dalam 24 jam sejak pesan user terakhir — setelah itu harus pakai template Meta approved. Solusi pertama: User harus inisiasi sesi baru (kirim pesan apapun). Atau kalau perlu outreach aktif, gunakan Follow-up yang pakai template Meta approved.

10. "Unauthorized" ketika membuka /leads-v2 atau /analytics-v2

Gejala: Counselor mengklik link dan dapat error 403 / "Unauthorized" walaupun sudah login. Penyebab: RBAC Phase 1.5 aktif — counselor hanya boleh akses cluster-nya sendiri. Link yang di-klik mungkin untuk lead dari cluster lain. Solusi pertama: Kembali ke list, pastikan filter hanya menampilkan cluster Anda. Kalau yakin lead itu seharusnya cluster Anda tapi tidak bisa akses, escalate ke admin untuk reassign (lihat Escalation).

Masalah yang tidak ada di sini

Kalau gejala yang Anda alami tidak cocok dengan 10 entry di atas, lakukan langkah pertama:

  1. Screenshot gejala (termasuk URL, error message, tab yang di- buka)
  2. Catat langkah reproduksi — apa yang Anda klik sebelum masalah muncul
  3. Cek status page di https://huph.val.id/health dulu — kalau API down, masalah Anda mungkin symptom dari outage lebih besar
  4. Lapor ke dev team via channel biasa dengan detail di langkah 1-2

Lihat juga