AI Chat

Lokasi di admin: Customers › Support › Ticket, tab AI settings (/support/tickets?tab=settings). Penyedia dan modul: System › Settings › AI provider (/settings/ai). Lokasi di portal: tombol obrolan melayang dan halaman /chat (mode Ask AI).

Fungsi

AI Chat menjawab pertanyaan pelanggan setiap saat, mencari data akun mereka sendiri (saldo, layanan, pembayaran, error terbaru), dan dapat bertindak atas nama mereka — membuat VM, mengubah paket — setelah pelanggan mengonfirmasi. Ketika asisten tidak dapat membantu, pelanggan mengklik Talk to a human: obrolan diteruskan ke staf Anda di Telegram dan, jika tidak ada yang menjawab tepat waktu, akan menjadi tiket. Pengaturan AI yang sama juga memungkinkan sistem menginvestigasi tiket untuk staf Anda.

Persyaratan

Item	Persyaratan
Modul dan penyedia	Modul AI aktif dan AI provider disimpan serta digunakan. Tanpa penyedia, asisten akan menyatakan bahwa modul belum dikonfigurasi.
Pelanggan	Hanya untuk pelanggan yang masuk. Pada instalasi NexCMP tidak ada situs publik, sehingga pengunjung yang belum masuk akan mendapati "Sign in to use AI Chat".
Saluran staf (opsional)	Bot dan obrolan Telegram untuk peringatan admin (lihat Telegram notifications). Saluran yang sama menerima pengalihan obrolan dan draf tiket.
Dependensi	AI provider.

Siapkan infrastruktur

Tidak diperlukan di luar penyedia AI. Jika Anda ingin pengalihan ke staf:

1. Buat bot Telegram dengan @BotFather dan catat tokennya.
2. Buat grup atau gunakan chat pribadi Anda dengan bot tersebut, lalu catat ID chat-nya.
3. Masukkan keduanya di bawah System › Settings › Admin alerts (lihat Telegram notifications). Fitur dukungan menggunakan kembali bot dan chat tersebut.

Hubungkan di NexCMP

1. Pastikan modul AI aktif dan penyedia menguji hijau (AI provider).

2. Buka Customers › Support › Ticket dan pilih tab AI settings. Bagian atas kartu kiri menampilkan tiga tag: AI provider: configured, Telegram: channel present serta On shift atau Off shift.

3. Kartu kiri AI + Telegram:

   Tombol atau kolom	Default	Arti
   AI menyelidiki tiket secara otomatis	On	Untuk tiket atau pesan baru, AI membaca data pelanggan (hanya-baca) dan menulis kemungkinan penyebab serta draf balasan sebagai catatan internal. AI tidak pernah mengirimkannya ke pelanggan.
   Peringatan Telegram ke admin	On	Catatan tiba di Telegram dengan tombol Send, Edit, dan Skip.
   Balasan otomatis AI	Nonaktif	Mengirimkan jawaban cara-penggunaan atau penjualan sederhana secara mandiri ketika semua kondisi keselamatan terpenuhi (tingkat keyakinan 85% atau lebih, tanpa peringatan); dikirim setelah 3 menit dan dapat dibatalkan di Telegram.
   Kategori yang diizinkan untuk membalas otomatis	how_to, sales	Hanya kategori-kategori ini.
   Model primer, Model cadangan	ditetapkan dari penyedia	Biasanya biarkan seperti yang disimpan oleh halaman penyedia AI.
   ID pengguna Telegram yang diizinkan untuk bertindak	kosong	Kosong berarti chat dari saluran peringatan.

4. Kartu kanan Live chat (customer widget):

   Kolom	Default	Arti
   Aktifkan widget chat	On	Gelembung chat dan halaman /chat.
   Jam dukungan (waktu Vietnam)	08:00-22:00	Saat staf diharapkan menjawab di Telegram. Di luar jam tersebut, atau saat tidak ada saluran Telegram, Talk to a human langsung mengubah chat menjadi tiket.
   Waktu tunggu maks untuk staf (menit), lalu ubah menjadi tiket	10	1 hingga 240.
   Putaran AI / hari / pelanggan	40	1 hingga 1000. Setelah batas tercapai, asisten mengundang pelanggan untuk berbicara dengan manusia.
   Chat baru / jam / IP	20	1 hingga 1000.
   Tautan Zalo OA	kosong	https://zalo.me/... Menampilkan tombol Chat on Zalo (dengan kode QR) di dalam chat. Dikosongkan untuk menyembunyikannya.
   Tautan Telegram	kosong	https://t.me/... Menampilkan tombol Telegram. Dikosongkan untuk menyembunyikannya.
   Batas harian putaran AI seluruh sistem, pelanggan yang masuk	2000
   Batas harian seluruh sistem, tamu	500	Kumpulan tersendiri; tidak digunakan selama tamu tidak dapat melakukan chat.
   Batas harian penyelidikan tiket otomatis seluruh sistem	200
   Path admin (tombol Telegram "Open admin")	kosong	URL admin Anda, misalnya https://cloud.example.com/admin.

   Setiap tombol atau kolom akan tersimpan saat Anda mengubahnya.

5. Di bagian bawah, Reply templates (judul, bahasa VI/EN/ZH, teks hingga 4,000 karakter) menyediakan jawaban siap pakai bagi staf.

Yang dapat dan tidak dapat dilakukan oleh asisten

• Membaca: mencari basis pengetahuan dan dokumentasi publik Anda, serta membaca data pelanggan yang sedang masuk melalui alat baca-saja. Asisten tidak dapat melihat pelanggan lain.
• Bertindak: menggunakan izin API pelanggan itu sendiri. Tindakan read langsung dijalankan. Apa pun yang mengubah atau mengenakan biaya akan membuat kartu konfirmasi (dengan tulisan "Needs your confirmation", serta tag Costs money atau Delete); tidak ada yang terjadi hingga pelanggan mengklik Confirm. Obrolan dapat menampung paling banyak 3 kartu tertunda dan satu akun paling banyak 10 tindakan tulis terkonfirmasi per jam.
• Tidak pernah: tidak dapat membuka konsol, membuat token SSH atau konsol, mengunduh file akses Kubernetes, mengatur ulang kata sandi, atau menampilkan rahasia seperti kata sandi proxy atau rahasia S3. Rahasia tidak pernah dimasukkan ke dalam konteks model atau riwayat obrolan.
• Keamanan: jawabannya melewati filter keluaran; teks pelanggan dan hasil alat diperlakukan sebagai data, bukan sebagai instruksi.
• Spanduk kejujuran: obrolan menampilkan "Answered by an AI assistant — it may be imperfect. Talk to a human for anything critical."

Peralihan ke staf

1. Pelanggan mengklik Talk to a human dan dapat meninggalkan alamat email.
2. Pesan beserta percakapan tersebut masuk ke obrolan Telegram staf. Staf menjawab dengan membalas pesan tersebut; balasan akan muncul di obrolan pelanggan sebagai "[brand] Support".
3. Jika tidak ada yang menjawab dalam waktu tunggu (default 10 menit), obrolan akan menjadi tiket di bawah Customers › Support › Ticket. Hal yang sama terjadi seketika di luar jam dukungan atau saat Telegram tidak dikonfigurasi, dan pelanggan diberi tahu bahwa tiket telah dibuka.
4. Admin juga dapat melihat obrolan yang sedang berjalan di tab Live chat.

Verifikasi

1. Masuk sebagai pelanggan uji coba, buka obrolan, dan ajukan pertanyaan tentang layanan Anda. Asisten akan menjawab.
2. Minta asisten membuat sesuatu yang berbayar: kartu konfirmasi akan muncul dan tidak ada yang dibuat hingga Anda mengklik Confirm.
3. Klik Talk to a human. Pesan akan sampai ke obrolan Telegram Anda (jika dikonfigurasi) atau, setelah waktu tunggu berlalu, sebuah tiket akan muncul.
4. Dengan tautan Zalo dan Telegram yang terisi, kedua tombol pintas tersebut akan muncul di dalam obrolan.

Batas & catatan

• Batasan laju (per IP): 20 pesan per menit dan beberapa kali peralihan per jam; 40 pesan per percakapan. Ini adalah batas tetap.
• Biaya: setiap giliran AI memanggil penyedia Anda. Turunkan AI turns / day / customer untuk membatasi pengeluaran.
• Balasan otomatis nonaktif secara default. Nyalakan hanya setelah Anda mengamati draf untuk beberapa waktu.
• Bahasa: asisten menjawab dalam bahasa pelanggan; bahasa Vietnam dideteksi dari teks.
• Reseller: situs reseller menggunakan tiket alih-alih widget.

Pemecahan Masalah

Gejala	Penyebab	Solusi
Pelanggan tidak dapat melihat obrolan	Modul AI nonaktif, atau Enable chat widget nonaktif	Nyalakan keduanya.
"Sign in to use AI Chat"	Pengunjung belum masuk	Diharapkan di NexCMP: masuk terlebih dahulu.
Asisten menyatakan tidak ada penyedia AI yang dikonfigurasi	Penyedia tidak ada, tidak digunakan, atau kunci tidak ada	Lengkapi AI provider.
AI membalas "talk to a human" setelah beberapa pertanyaan	Batas harian per pelanggan telah tercapai	Naikkan AI turns / day / customer.
Tag Telegram menampilkan "no channel"	Bot atau chat ID belum dikonfigurasi	Atur Telegram notifications.
Tombol Zalo atau Telegram tidak ada	Kolom tautan kosong	Isi tautannya.
"Too many requests" di dalam chat	Lebih dari 20 pesan per menit dari satu IP	Tunggu sebentar.
Percakapan chat penuh	Mencapai 40 pesan	Mulai percakapan baru.