Lompat ke konten utama
StableTerakhir diperbarui: 27 Okt 2026, 17.37

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.

Stable

1. 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 (EventEscalationNew dan EventChatStatusChange).
  • 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 /reply akan diinspeksi oleh filter Anti-Fraud untuk mencegah pembajakan pesanan (order steering) ke nomor rekening pribadi staf.
Mekanisme Fail-Closed pada Eskalasi

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

  1. 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).
  2. 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.
  3. 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.
  4. 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):

Kotak masuk Live CRM terpadu dengan filter saluran dan agen
Antarmuka Live Inbox multi-kanal dan multi-cabang
Status bot dijeda saat staf CS manusia mengambil alih percakapan
Banner penanda intervensi CS manusia dan tombol jeda bot aktif
Laci template balasan cepat saat staf CS menangani obrolan
Modul template balasan cepat untuk percepatan respon percakapan oleh staf CS

3. Panduan Langkah-demi-Langkah

Ikuti prosedur operasional berikut saat menangani antrean Live Inbox dan mengambil alih percakapan pelanggan:

  1. 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. 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 dari idle atau escalated menjadi human_active.

  3. 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. 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_active ke nilai TRUE dan state percakapan menjadi idle, memungkinkan bot untuk langsung melayani sapaan berikutnya dari pelanggan yang sama tanpa interfensi lanjutan.

  5. 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:

Status Transisi (state) Indikator is_bot_active Perilaku Pemrosesan Pipeline Bot Pemicu (Kondisi Transisi)
idle TRUE Pesan diproses LLM, menggunakan kuota token. Keadaan awal kontak baru, atau dipicu fungsi Release (Resume AI).
escalated FALSE Pesan diabaikan oleh AI, lencana berubah merah. Dipicu oleh Escalation Service (Mis. deteksi Caps Sentiment, RAG Miss 2x, Batas Diskon terlampaui).
human_active FALSE Akses bot ditutup sepenuhnya, chat diamankan oleh CS. Dipicu agen menekan tombol Ambil Alih (Takeover).
closed FALSE Percakapan disegel pada arsip historis. (Fitur opsional saat tiket diselesaikan)
transferred FALSE Chat tertahan di CS (belum kembali ke bot), menunggu CS baru. Dipicu saat agen menekan tombol Transfer.

(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_active atau escalated, fungsi Pipeline Bypassing dalam servis chat langsung membatalkan reservasi (refund reservation pada chat_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-counts yang 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)

Gejala Masalah Penyebab Utama Solusi Penanganan
Bot tetap merespons meski staf sedang membalas CS mengetik pesan via aplikasi WhatsApp HP mandiri secara terpisah dan belum menekan tombol Takeover di dasbor. Tekan tombol Ambil Alih (Takeover) di dasbor agar status di basis data terkunci menjadi human_active.
Pesan balasan CS dari dasbor memiliki tanda silang merah Engine Omnichannel pada WhatsApp Instance telah terputus (disconnected). Buka menu Omnichannel lalu sinkronkan ulang QR Code WhatsApp.
Staf CS tidak dapat melihat pelanggan tertentu di Live Inbox branch_id percakapan terikat pada cabang (contoh: Jakarta) dan staf tersebut diisolasi oleh RBAC untuk cabang lain (contoh: Bandung). Periksa role staf pada modul Manajemen Staf & RBAC untuk memastikan relasi cabangnya sudah tepat.
Pelanggan melaporkan bot tidak membalas sama sekali seharian Percakapan sebelumnya dengan staf CS belum di-Release. Statusnya terus terjebak dalam human_active. Klik obrolan, lalu klik tombol Kembalikan ke Bot (Resume AI) agar state percakapan kembali idle.
Live Inbox tidak memperbarui chat baru jika tidak di-refresh Koneksi WebSocket antara browser agen dan WSHub Server terganggu (timeout / blokir VPN). Pastikan VPN dimatikan atau koneksi internet stabil; sistem Live CRM akan berusaha merekatkan ulang (Reconnecting) koneksi otomatis dalam interval 2-10 detik.
Bot me-looping eskalasi tanpa henti (RAG Miss) Konfigurasi limitasi rag_miss pada sistem Redis tidak termuat sempurna (sehingga ambang limit jatuh ke nilai 0). Secara otomatis engine melakukan fungsi lindung-nilai ke setelan wajar (limit = 2). Jika persisten, periksa kelancaran koneksi antara backend (PGO) dan kluster Redis.
Pesan ketikan dari dasbor gagal terkirim (Error 400) Filter Anti-Fraud mendeteksi sisipan nomor rekening pribadi / link phising pada ketikan staf. Modul HTTP /api/v1/conversations/:id/reply menangkal payload berbahaya. Hapus tautan tak sah dan ketik ulang sesuai standar prosedur operasi (SOP).

7. Referensi Terkait

content/docs/features/takeover-crm.mdx
Terakhir diperbarui: 27 Okt 2026, 17.37

Dokumentasi teknis DagangBot