Live CRM & Pengambilalihan Chat (Human Takeover)
Meskipun DagangBot AI mampu menangani sebagian besar pertanyaan rutin pelanggan, transaksi bernilai tinggi, komplain sensitif, atau permintaan khusus pelanggan tetap membutuhkan sentuhan empati staf manusia. Fitur Human Takeover menjembatani kolaborasi harmonis antara kecerdasan buatan dan tim CS Anda.
Stable1. Ikhtisar & Nilai Bisnis
Ketika pelanggan mengajukan komplain atau aturan bisnis terpenuhi (misalnya diskon melebihi batas atau transaksi bernilai tinggi), sistem Escalation Service dapat mendeteksinya secara otomatis dan mengeskalasi percakapan. Staf CS juga dapat langsung mengintervensi obrolan dari dasbor. AI seketika dijeda (is_bot_active = FALSE) sehingga tidak terjadi tabrakan balasan (double reply).
Fitur ini sangat krusial bagi merchant dengan volume pesan tinggi, di mana CS manusia tidak sanggup memantau ratusan pelanggan secara manual, namun wajib hadir ketika pelanggan mengalami kendala pelik yang tidak sanggup dipecahkan oleh bot.
- State Machine Terpusat: Setiap interaksi dengan pelanggan direkam dalam tabel basis data (kolom
state) dan diamankan menggunakan Distributed Lock (chat_lock.go) untuk menjamin tidak ada perlombaan kondisi (race condition) ketika CS mengambil alih chat. - Ringkasan Konteks Instan (AI Summary): Sistem Escalation Service (dengan templat prompt
escalation_summary) secara otomatis merangkum konteks masalah pelanggan tanpa staf harus menggulir jauh ke atas. - Real-Time UI Push: Penugasan eskalasi maupun pengambilalihan aktif dimutakhirkan secara instan (sekitar ~100 milidetik) ke antarmuka Live Inbox via koneksi WebSocket Push (
EventEscalationNewdanEventChatStatusChange). - Isolasi RBAC & Cabang: Obrolan dapat difilter dan dipantau sesuai dengan hak izin agen (Branch Unread Count) di dasbor tanpa membocorkan prospek dari cabang lain ke agen yang tidak berwenang.
- Siklus Hidup Pemulihan (Auto-Release): Terdapat mekanisme penarikan paksa oleh sistem. Meski idealnya CS menekan "Kembalikan ke Bot", sistem memiliki kemampuan mengendus ketidakaktifan (idle timeout) dari sisi CS, memastikan pelanggan tidak terkatung-katung akibat staf yang lupa menutup obrolan (opsional berdasarkan konfigurasi merchant).
- Pencegahan Fraud Staf (Audit Trail): Semua balasan yang diketik oleh CS manusia melalui modul
/replyakan diinspeksi oleh filter Anti-Fraud untuk mencegah pembajakan pesanan (order steering) ke nomor rekening pribadi staf.
Saat eskalasi dipicu atau agen menekan tombol Ambil Alih, basis data memperbarui is_bot_active menjadi FALSE dan state diubah. Seluruh pesan pelanggan yang masuk selanjutnya ditahan oleh Pipeline Classifier dan dilewati (bypassed) dari LLM untuk melindungi kuota token dan kenyamanan pelanggan.
1.1 Deteksi Pemicu Eskalasi AI
- CheckCapsSentiment: Pendeteksian kemarahan pelanggan berbasis kapitalisasi huruf. Sistem menghitung kemunculan uppercase beruntun (parameter standar threshold = 3 kata berurutan kapital semua). Fitur ini memiliki pengecualian jika teks merupakan potongan format terstruktur (contoh: nomor resi atau kode kupon).
- CheckBusinessRules: Ambang batas diskon (discount threshold) dan batas atas nilai nominal transaksi (high value). Misalnya jika sebuah pesanan melampaui "Rp 2.000.000" dan pelanggan menanyakan metode cicilan manual, bot otomatis mundur.
- CheckConsecutiveRAGMiss: Jika AI tidak berhasil menemukan referensi relevan dari pangkalan pengetahuan (KB) secara berturut-turut. Hitungan (counter) ini disimpan pada sistem tembolok in-memory dengan key Redis
rag_miss:<convID>(parameter limit default = 2). Melewati batas memicu eskalasi paksa. - CheckKeywords: Pemeriksaan secara case-insensitive dari larik kata kunci sensitif yang diinputkan merchant (seperti "marah", "komplain", "penipu", "viralkan", dll).
Begitu salah satu dari kondisi di atas bernilai true, metode TriggerEscalation akan dieksekusi: merekam context summary menggunakan LLM Rotator, memublikasikan event WebSocket, dan memberikan warna peringatan pada antarmuka dasbor.
2. Alur Visual & Antarmuka
Berikut adalah tampilan Live Inbox terpadu dan penanda jeda AI (Human Active):



3. Panduan Langkah-demi-Langkah
Ikuti prosedur operasional berikut saat menangani antrean Live Inbox dan mengambil alih percakapan pelanggan:
- 1
Langkah 1: Pantau Antrean Live Inbox
Buka menu Live Inbox di bilah sisi dashboard. Anda dapat melihat lencana belum dibaca (unread badge) yang dipasok oleh kalkulasi basis data secara instan melalui notifikasi WebSocket. Angka pesan yang belum terbaca hanya menghitung status selain human_active.
- 2
Langkah 2: Lakukan Human Takeover
Pilih percakapan (Conversation) dengan pelanggan yang membutuhkan bantuan. Klik tombol kuning Ambil Alih (Takeover) di pojok kanan atas obrolan. Pembaruan akan memanggil endpoint internal (POST
/api/v1/conversations/:id/takeover) dan mengubah status percakapan dariidleatauescalatedmenjadihuman_active. - 3
Langkah 3: Berinteraksi Secara Personal
Kirimkan balasan kepada pelanggan. Anda memegang kendali penuh obrolan. Gunakan tab Catatan Internal jika perlu meninggalkan rekam jejak untuk pergantian giliran sif. Selama status human_active berjalan, bot tidak akan menghabiskan token LLM.
- 4
Langkah 4: Alihkan atau Kembalikan ke AI Bot (Release)
Setelah obrolan berakhir, klik tombol hijau Kembalikan ke Bot (Resume AI). Tindakan ini memanggil rute Release yang mengembalikan
is_bot_activeke nilaiTRUEdanstatepercakapan menjadiidle, memungkinkan bot untuk langsung melayani sapaan berikutnya dari pelanggan yang sama tanpa interfensi lanjutan. - 5
Langkah 5: Transisi Internal Antar Staf (Transfer)
Jika obrolan ternyata masuk ke ranah spesialisasi kolega lain (misal dari staf Penjualan ke staf Dukungan Teknis), klik tombol Transfer (Pindahkan). Dialog pemindahan akan memuat daftar agen internal yang sedang daring (melalui mekanisme
branch_id). Anda dapat menyertakan "Catatan Transfer" yang hanya terlihat di sisi dasbor, guna mempercepat staf penerima dalam memahami akar persoalan pelanggan.
4. Parameter & Spesifikasi Teknis
Tabel di bawah merinci siklus hidup status pada state machine percakapan (conversations.state) berdasarkan infrastruktur mesin bot:
(Catatan Bukti Validasi Sistem: Saat ini, berbeda dengan spekulasi, sistem tidak memiliki penarikan waktu mundur 30 menit otomatis bawaan (default). Status AI mutlak dikendalikan manual oleh klik dari agen atau intervensi bot pengawas terjadwal khusus (jika disetel). Jika agen lupa menekan tombol "Resume AI", bot tetap akan membisu).
5. Relasi & Integrasi
- Penagihan (Billing) & Token LLM: Saat AI mendeteksi status
human_activeatauescalated, fungsi Pipeline Bypassing dalam servis chat langsung membatalkan reservasi (refund reservation padachat_service.go), sehingga Anda tidak kehilangan jatah 1.024 token sia-sia akibat perulangan balasan yang tak berguna. - Deteksi RAG Miss Beruntun: Modul ini berintegrasi erat dengan Knowledge Base. Jika bot gagal mencari jawaban dari pangkalan pengetahuan (RAG Miss) sebanyak batas beruntun yang diizinkan (parameter batas limit via Redis), Escalation Service menerbitkan peringatan (escalation_reason) untuk menyela AI otomatis.
- WebSocket Gateway: Antarmuka Live Inbox (Frontend) bergantung pada soket waktu nyata (real-time web sockets) agar perubahan transisi status per pelanggan (seperti
EventChatStatusChange) terpampang langsung ke monitor dasbor CS tanpa harus me-refresh laman browser.
5.1 Isolasi Data Karyawan (Role-Based Access)
Akses obrolan bersifat eksklusif:
- Staf Reguler (Kasir/CS): Hanya memiliki jangkauan data pelanggan yang telah terikat pada cabangnya (
branch_id). Unread Count di header aplikasi merujuk spesifik pada percakapan dari nomor Omnichannel cabang tersebut. Permintaan rute/api/v1/conversations/unread-countsyang mencoba menyusup (mis. melempar parameter cabang lain) akan dihadang (HTTP 403 Forbidden). - Manager / Owner: Mengantongi properti
reachesAllBranches: true, sehingga tampilan Live Inbox memuat bilah penyaring (filter) seluruh cabang dan akumulasi status di agregat dari seluruh pusat percakapan.
6. Pemecahan Masalah (Troubleshooting)
7. Referensi Terkait
Omnichannel WhatsApp
Manajemen multi-nomor WhatsApp dan pembagian beban kerja cabang.
Sales Closing & Ongkir
Otomasi cek ongkos kirim dan penerbitan QRIS saat chat berlangsung.
Manajemen Staf & RBAC
Pengaturan hak akses CS, Supervisor, dan Admin Toko.
Anti-Fraud & Filter Kata
Perlindungan deteksi kecurangan dan pencegahan transaksi di luar sistem.
