Manual SEMJAT yang didukung tangkapan layar dibuat dari alur dasbor sem.chat yang sebenarnya. Setiap panduan memberi tahu Anda apa yang harus diklik, apa yang akan terjadi setelah klik, cara mengujinya, cara memecahkan masalah, dan apa yang harus dilakukan selanjutnya.
Tidak ditemukan panduan yang cocok. Coba kata kunci yang lebih pendek seperti widget, API, suara, penagihan, webhook, WordPress, SendPulse, atau penjadwalan.
Catatan tangkapan layar: setiap gambar dalam manual ini diambil dari aplikasi sem.chat asli menggunakan ruang kerja demo. Detail akun sensitif, data pelanggan, kunci API, detail pembayaran, dan konten percakapan pribadi disamarkan sebelum dipublikasikan.
01
Memulai
Buat akun, selesaikan orientasi, pahami dasbor, buat bot pertama, uji secara pribadi, instal, dan pilih paket yang tepat.
/authPendaftaran, uji coba, dan bot pertama
1Mulailah dengan Mendaftar atau Masuk dari situs atau aplikasi publik.
2Verifikasi alamat email sebelum mengandalkan notifikasi atau pesan penagihan.
3Gunakan orientasi untuk membuat bot pertama sebelum membuka dasbor.
/ikhtisarIkhtisar setelah login
1Gunakan tindakan cepat untuk membuat bot, melihat bot, membuka analitik, atau mengelola penagihan.
2Tinjau bot aktif, conversations, menit suara, dan kepuasan sebelum melakukan perubahan.
3Periksa aktivitas terkini setelah setiap pengujian pengaturan.
Peluncuran pertama
Daftar, mulai uji coba, dan pahami dasbor
Untuk apa ini: Gunakan alur kerja ini untuk ruang kerja baru atau saat melakukan orientasi pada rekan satu tim yang belum pernah menggunakan sem.chat.
Sebelum Anda mulai
Gunakan email bisnis yang dapat menerima email verifikasi dan penagihan.
Putuskan siapa yang harus memiliki ruang kerja sebelum mengundang anggota tim lainnya.
Siapkan situs web pengujian atau halaman pementasan yang aman untuk pemasangan widget.
1
Buka halaman pendaftaran aplikasi
Buka app.sem.chat/auth dari situs web tombol Masuk / Daftar.
Hasil yang diharapkan: Halaman autentikasi menampilkan opsi masuk dan pembuatan akun.
2
Buat akun
Masukkan email bisnis, buat kata sandi, dan kirimkan formulir pendaftaran.
Hasil yang diharapkan: Aplikasi meminta verifikasi atau beralih ke orientasi setelah akun diterima.
3
Verifikasi emailnya
Buka email verifikasi dan klik tautan konfirmasi.
Hasil yang diharapkan: Akun tersebut dapat menerima pesan penagihan, undangan, laporan, dan peringatan.
4
Selesaikan orientasi
Masukkan nama bisnis, jelaskan tujuan asisten, pilih warna awal, dan buat bot pertama.
Hasil yang diharapkan: Ruang kerja terbuka dengan draf bot dan status uji coba aktif.
5
Buka Ikhtisar
Klik Ikhtisar di sidebar kiri.
Hasil yang diharapkan: Dasbor menampilkan kartu usage, tindakan cepat, dan aktivitas terkini.
6
Pilih tindakan selanjutnya
Gunakan Buat Bot Baru untuk penyiapan, Lihat Semua Bot untuk pengelolaan, Analisis untuk kinerja, atau Penagihan untuk batas paket.
Hasil yang diharapkan: Anda tahu ke mana harus melanjutkan berdasarkan keadaan ruang kerja.
Cara mengujinya: Buat satu bot pengujian pribadi dan kirim pesan pengujian sebelum mengundang rekan satu tim. Konfirmasikan perubahan aktivitas Ikhtisar setelah pengujian.
Masalah
Perbaiki
Email verifikasi tidak sampai
Periksa spam, konfirmasi ejaan email, lalu minta email verifikasi lainnya.
Dasbor terbuka di Penagihan
Ruang kerja mungkin memerlukan uji coba atau rencana aktif. Mulai uji coba atau pilih paket yang benar sebelum penyiapan.
Rekan satu tim tidak dapat mengakses ruang kerja
Undang mereka dari Pengaturan, Tim alih-alih membagikan login pemilik.
Apa yang harus dilakukan selanjutnya: Buat bot pertama, uji secara pribadi, lalu pasang widget di halaman pementasan.
Tes peluncuran pribadi
Buat pengujian bot pribadi pertama sebelum ditayangkan
Untuk apa ini: Gunakan ini untuk memverifikasi akun, bot, widget, dan pelacakan riwayat sebelum pelanggan melihat asisten.
Sebelum Anda mulai
Siapkan satu contoh pertanyaan pelanggan.
Siapkan halaman pementasan atau halaman pengujian HTML lokal.
Jangan gunakan data pelanggan nyata pada pengujian pertama.
1
Buka My Bots
Klik My Bots di sidebar atau gunakan Lihat Semua Bot dari Ikhtisar.
Hasil yang diharapkan: Anda dapat melihat bot yang dibuat selama orientasi atau keadaan kosong dengan tombol Bot Baru.
2
Buka pembuat bot
Klik Bot Baru atau Edit pada bot yang sudah ada.
Hasil yang diharapkan: Bot Builder dibuka dengan kontrol Dasar, Widget, Pengetahuan, Suara, dan integrasi.
3
Simpan bot sekali
Isi nama bot dan pesan pertama yang diperlukan, lalu klik Simpan.
Hasil yang diharapkan: Bot menerima ID yang valid dan dapat menghasilkan kode semat.
4
Pratinjau secara pribadi
Gunakan panel pratinjau dan ajukan contoh pertanyaan Anda.
Hasil yang diharapkan: Jawabannya harus sesuai dengan instruksi Anda atau mengungkapkan pengetahuan apa yang hilang.
5
Instal pada pementasan
Buka Sematkan, salin cuplikan HTML, dan tempelkan sebelum tag isi penutup pada halaman pementasan.
Hasil yang diharapkan: Widget muncul di sudut yang dikonfigurasi pada desktop dan seluler.
6
Konfirmasikan pelacakan
Buka Kotak Masuk atau Chat History setelah percakapan percobaan.
Hasil yang diharapkan: Percakapan pengujian muncul dengan bot, saluran, dan riwayat pesan yang benar.
Cara mengujinya: Kirim satu pesan teks dan satu tes suara jika suara diaktifkan. Konfirmasikan keduanya muncul di Chat History.
Masalah
Perbaiki
Kode semat tidak tersedia
Simpan botnya dulu. Jika sinkronisasi suara masih tertunda, tunggu sinkronisasi atau simpan lagi setelah kolom yang wajib diisi selesai.
Widget menunjukkan bot yang salah
Konfirmasikan data-bot-id dalam cuplikan cocok dengan ID bot dari modal Sematan.
Tidak ada percakapan yang muncul dalam riwayat
Refresh Chat History, konfirmasikan bot aktif, dan pastikan pengujian dilakukan pada widget yang terpasang, bukan halaman basi.
Apa yang harus dilakukan selanjutnya: Lanjutkan ke Bot Builder penyiapan dan pelatihan pengetahuan.
02
Buat Dan Konfigurasikan Bot
Bangun, edit, pratinjau, aktifkan, transfer, atau hapus bot dari My Bots dan Bot Builder.
/dasborMy Bots pusat kendali
1Klik Bot Baru untuk memulai asisten baru.
2Gunakan Edit, Sematkan, Transfer, Aktifkan, atau Hapus pada setiap kartu bot.
3Periksa status aktif dan waktu pembaruan terakhir sebelum pengujian.
/bots/:id/editBot Builder tab dasar
1Isi nama bot, avatar, pesan pertama, dan instruksi sistem.
2Gunakan Pratinjau untuk menguji sebelum dipublikasikan.
3Simpan dan sinkronkan sebelum menyalin kode semat.
Buat bot
Buat bot baru dari My Bots
Untuk apa ini: Gunakan alur kerja ini ketika merek, situs web, antrean dukungan, atau kampanye baru memerlukan asistennya sendiri.
Sebelum Anda mulai
Siapkan nama bot, tujuan, pesan pertama, dan dua atau tiga contoh pertanyaan.
Kumpulkan situs web publik URL jika Anda berencana mengimpor konten.
Konfirmasikan bahwa paket mengizinkan jumlah bot dan fitur suara/avatar yang Anda perlukan.
1
Buka My Bots
Klik My Bots di bilah sisi.
Hasil yang diharapkan: Bot yang ada dan tombol Bot Baru terlihat.
2
Klik Bot Baru
Mulai bot baru dari halaman My Bots.
Hasil yang diharapkan: Bot Builder dibuka dengan asisten wajib militer.
3
Tetapkan identitas bot
Masukkan Nama Bot, unggah atau pilih avatar, dan tulis pesan pertama yang akan dilihat pengunjung.
Hasil yang diharapkan: Panel pratinjau mencerminkan nama asisten, avatar, dan salam.
4
Tulis instruksi sistem
Jelaskan apa yang harus dilakukan bot, cara bicaranya, apa yang harus dihindari, dan kapan bot harus meminta bantuan manusia.
Hasil yang diharapkan: Asisten mempunyai aturan perilaku yang jelas sebelum pengetahuan ditambahkan.
5
Tambahkan pengetahuan dasar
Tempelkan informasi penting perusahaan, produk, dukungan, harga, dan kontak ke dalam area pengetahuan.
Hasil yang diharapkan: Bot dapat menjawab pertanyaan umum tanpa memerlukan impor situs web.
6
Simpan botnya
Klik Simpan dan tunggu konfirmasi yang disimpan atau disinkronkan.
Hasil yang diharapkan: Bot memiliki ID yang stabil, pratinjau dapat diuji, dan opsi penyematan tersedia.
7
Pratinjau hasilnya
Ajukan contoh pertanyaan yang telah disiapkan di Pratinjau.
Hasil yang diharapkan: Jawaban harus mengikuti instruksi dan menggunakan pengetahuan yang Anda masukkan.
8
Aktifkan hanya jika sudah siap
Aktifkan bot setelah tes pribadi berlalu.
Hasil yang diharapkan: Bot siap untuk widget atau lalu lintas saluran.
Cara mengujinya: Ajukan setidaknya lima pertanyaan realistis. Periksa apakah jawabannya benar, apakah tetap sesuai merek, dan apakah meminta bantuan manusia saat dibutuhkan.
Masalah
Perbaiki
Jawabannya terlalu umum
Tambahkan pengetahuan yang lebih spesifik dan tulis ulang instruksi dengan contoh jawaban yang baik.
Bot menolak pertanyaan yang harus dijawabnya
Hapus instruksi yang terlalu ketat dan tambahkan pengetahuan tepercaya untuk topik tersebut.
Simpan tidak menghasilkan kode semat
Periksa bidang yang wajib diisi dan simpan lagi setelah sinkronisasi penyedia suara selesai.
Apa yang harus dilakukan selanjutnya: Konfigurasikan pengaturan widget, tambahkan pengetahuan situs web, lalu instal bot.
Kelola bot
Edit, klon alur kerja, transfer, nonaktifkan, atau hapus bot
Untuk apa ini: Gunakan alur kerja ini ketika bot memerlukan pembaruan, perubahan kepemilikan, jeda sementara, atau penghapusan permanen.
Sebelum Anda mulai
Ekspor percakapan atau data kontak apa pun yang harus Anda simpan sebelum menghapus bot.
Pastikan bot tidak tertanam di situs web aktif sebelum menghapus atau mentransfernya.
Beri tahu rekan satu tim sebelum menonaktifkan bot produksi.
1
Buka My Bots
Temukan kartu bot berdasarkan nama atau status.
Hasil yang diharapkan: Kartu tersebut menunjukkan status saat ini dan tindakan yang tersedia.
2
Klik Sunting
Buka pembuat bot dan buat perubahan yang diperlukan.
Hasil yang diharapkan: Editor memuat konfigurasi saat ini.
3
Simpan dan tes ulang
Klik Simpan setelah setiap perubahan materi, lalu jalankan pertanyaan pratinjau.
Hasil yang diharapkan: Konfigurasi yang disimpan digunakan oleh pratinjau dan widget yang dipasang.
4
Nonaktifkan sementara
Gunakan tombol aktif jika bot berhenti menangani pengunjung untuk saat ini.
Hasil yang diharapkan: Bot berhenti melayani lalu lintas langsung sambil mempertahankan konfigurasi.
5
Mentransfer kepemilikan
Gunakan Transfer, masukkan email penerima, dan konfirmasi.
Hasil yang diharapkan: Akun yang dipilih menerima kepemilikan sesuai dengan alur transfer aplikasi.
6
Hapus hanya setelah pemeriksaan
Gunakan Hapus, baca peringatannya, dan konfirmasi hanya jika bot tidak lagi diperlukan.
Hasil yang diharapkan: Bot dan konfigurasi terkait dihapus sesuai dengan peringatan.
Cara mengujinya: Setelah mengedit, buka widget yang terpasang dan ajukan pertanyaan persis yang memotivasi perubahan tersebut. Konfirmasikan jawaban langsung diubah.
Masalah
Perbaiki
Jawaban lama masih muncul
Segarkan halaman situs web, konfirmasikan bahwa Anda menyimpan bot yang benar, dan periksa apakah pengetahuan yang diimpor memerlukan sinkronisasi.
Transfer gagal
Konfirmasikan email penerima valid dan akun tujuan dapat menerima bot.
Hapus diklik secara tidak sengaja
Berhenti sebelum konfirmasi akhir. Peringatan penghapusan ada karena tindakan tersebut dapat menghapus data bot secara permanen.
Apa yang harus dilakukan selanjutnya: Tinjau analitik dan riwayat setelah perubahan langsung untuk memastikan pengalaman pengunjung meningkat.
03
Instal Widgetnya
Salin kode semat yang benar, instal dalam konteks HTML, WordPress, React, atau SDK lanjutan, lalu verifikasi perilaku desktop dan seluler.
Sematkan modalSalin cuplikan pemasangan situs web
1Pilih HTML, WordPress, React, atau NPM/SDK berdasarkan tumpukan situs.
2Salin kode setelah bot disimpan dan disinkronkan.
3Tempelkan cuplikan sebelum tag isi penutup atau di tata letak kerangka kerja.
HTML instal
Instal widget di situs web HTML standar
Untuk apa ini: Gunakan ini ketika Anda dapat mengedit templat halaman, footer tema, atau tata letak HTML global.
Sebelum Anda mulai
Simpan bot terlebih dahulu agar modal penyematan memiliki ID bot asli.
Gunakan situs pementasan sebelum produksi.
Simpan versi skrip yang tepat dan data-bot-id dari modal.
1
Buka My Bots
Temukan bot yang ingin Anda instal dan klik Sematkan.
Hasil yang diharapkan: Modal Sematkan terbuka dengan tab instalasi.
2
Pilih HTML
Pilih tab HTML dan klik Salin Kode.
Hasil yang diharapkan: Skrip widget disalin dengan ID bot terlampir.
3
Buka templat situs web
Edit file footer atau tata letak global yang ditampilkan di setiap halaman tempat widget akan muncul.
Hasil yang diharapkan: Anda sedang mengedit shell situs bersama, bukan satu halaman terisolasi kecuali itu disengaja.
4
Tempel sebelum menutup badan
Tempelkan cuplikan tepat sebelum tag isi penutup.
Hasil yang diharapkan: Skrip dimuat setelah konten halaman dan dapat memasang wadah widget.
5
Publikasikan atau terapkan
Simpan templat dan sebarkan situs.
Hasil yang diharapkan: Skrip widget aktif di halaman target.
6
Uji desktop dan seluler
Buka situs di jendela browser baru dan di area pandang seluler.
Hasil yang diharapkan: Widget muncul di posisi yang dikonfigurasi dan terbuka tanpa kesalahan konsol.
Cara mengujinya: Kirim pesan dari halaman aktif, lalu buka Kotak Masuk dan Chat History untuk mengonfirmasi bahwa percakapan tersebut milik bot yang benar.
Masalah
Perbaiki
Widgetnya hilang
Konfirmasikan kode sebelum tag body penutup, skrip tidak diblokir oleh pembuat situs, dan bot aktif.
Bot yang salah muncul
Salin lagi cuplikannya dan bandingkan data-bot-id dengan bot yang diinginkan.
Widget tumpang tindih dengan kontrol halaman
Ubah posisi atau ukuran di Pengaturan Widget dan uji lagi di ponsel.
Apa yang harus dilakukan selanjutnya: Sesuaikan pengaturan widget dan pengambilan prospek setelah instalasi.
Instal di WordPress, React, atau alur suara lanjutan SDK
Untuk apa ini: Gunakan ini ketika situs web dikelola oleh CMS, aplikasi React, atau integrasi suara khusus.
Sebelum Anda mulai
Ketahui tumpukan mana yang memiliki tata letak bersama.
Gunakan cuplikan persis seperti yang ditampilkan di sem.chat untuk bot yang dipilih.
Untuk penggunaan SDK tingkat lanjut, konfirmasikan bahwa Anda memiliki kunci publik Vapi dan ID asisten yang diperlukan.
1
opsi WordPress
Gunakan Penampilan, Editor Tema, footer.php, atau plugin header-and-footer tepercaya.
Hasil yang diharapkan: Cuplikan dimuat di halaman WordPress publik.
2
opsi React
Buat komponen ChatWidget kecil, tambahkan skrip di useEffect, dan render di tata letak root.
Hasil yang diharapkan: Widget dimuat satu kali dan dibersihkan jika tata letak dilepas.
3
Opsi SDK tingkat lanjut
Gunakan tab NPM/SDK hanya ketika Anda memerlukan kontrol panggilan suara khusus di luar widget default.
Hasil yang diharapkan: Aplikasi Anda mengontrol sesi suara sementara sem.chat tetap menjadi sumber asisten yang dikonfigurasi.
4
Verifikasi ID bot
Konfirmasikan kode yang diinstal merujuk pada ID bot dari modal Sematan.
Hasil yang diharapkan: Widget langsung terhubung ke asisten yang dituju.
5
Periksa konsol
Buka alat pengembang browser dan muat ulang.
Hasil yang diharapkan: Tidak ada skrip yang diblokir, wadah duplikat, atau kesalahan jaringan.
Cara mengujinya: Selesaikan satu pesan pengujian dari situs yang diinstal, lalu konfirmasikan pesan tersebut muncul di Kotak Masuk dengan halaman yang diharapkan URL.
Masalah
Perbaiki
React memuat widget duplikat
Jaga penyisipan skrip dengan ref atau render komponen hanya di tata letak root.
WordPress menghapus tag skrip
Gunakan plugin injeksi footer atau file tema yang mengizinkan skrip.
SDK panggilan tidak dapat dimulai
Periksa kunci publik, ID asisten, izin browser, dan rencanakan akses suara.
Apa yang harus dilakukan selanjutnya: Pindah ke Pengaturan Widget untuk mengontrol perilaku, pencitraan merek, dan pengambilan prospek.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Pengaturan Widget
Konfigurasikan mode, tema, ukuran, posisi, warna, branding, reaksi, suara, persetujuan, pengambilan prospek, peringkat, email tindak lanjut, dan status aktivasi.
Bot Builder /WidgetTampilan widget dan perilaku pengunjung
1Pilih mode chat, suara, atau hibrid.
2Tetapkan tema, warna, posisi, ukuran, branding, persetujuan, dan suara.
3Konfigurasikan penangkapan prospek, penilaian, reaksi, dan perilaku tindak lanjut.
Perilaku widget
Konfigurasikan perilaku widget yang dilihat pengunjung
Untuk apa ini: Gunakan ini setelah instalasi pertama atau kapan saja widget perlu disesuaikan dengan situs web dan mendapatkan prospek yang lebih baik.
Sebelum Anda mulai
Instal widget di halaman pementasan.
Ketahui apakah pengunjung harus memulai dengan chat, suara, atau keduanya.
Siapkan persetujuan dan salinan pengambilan prospek jika diperlukan untuk wilayah tersebut.
1
Buka pembuat bot
Buka My Bots, klik Edit, lalu pilih tab Widget.
Hasil yang diharapkan: Kontrol widget muncul untuk bot yang dipilih.
2
Pilih modenya
Pilih Obrolan, Suara, atau Hibrid berdasarkan pengalaman pengunjung yang Anda inginkan.
Hasil yang diharapkan: Pratinjau berubah untuk menampilkan mode yang dipilih.
3
Atur penampilan
Pilih tema, warna, ukuran, posisi tombol, dan opsi branding.
Hasil yang diharapkan: Widget cocok dengan situs tanpa mencakup konten penting.
4
Aktifkan kontrol pengunjung
Mengaktifkan atau menonaktifkan perintah reaksi, suara, penilaian, dan persetujuan.
Hasil yang diharapkan: Pengunjung hanya melihat kontrol yang Anda ingin mereka gunakan.
5
Konfigurasikan pengambilan prospek
Pilih bidang yang wajib diisi, bidang deskripsi opsional, dan kapan formulir muncul.
Hasil yang diharapkan: Kontak dikumpulkan sebelum atau selama conversations sesuai dengan pengaturan Anda.
6
Atur email tindak lanjut
Konfigurasikan perilaku email tindak lanjut jika rencana Anda menyertakannya.
Hasil yang diharapkan: Pengunjung dapat menerima pesan tindak lanjut setelah diselesaikan conversations.
7
Simpan dan uji
Klik Simpan, muat ulang halaman pementasan, dan buka widget.
Hasil yang diharapkan: Widget langsung cocok dengan pengaturan yang disimpan.
Cara mengujinya: Buka widget di desktop dan seluler, kirimkan formulir prospek, berikan peringkat, dan konfirmasikan kontak dan percakapan telah direkam.
Masalah
Perbaiki
Warna tidak diperbarui
Simpan bot, segarkan situs web, dan konfirmasikan widget yang dipasang menggunakan ID bot yang sama.
Bidang prospek tidak ada
Konfirmasikan pengambilan prospek diaktifkan dan kondisi pemicu yang dipilih terpenuhi.
Pengunjung tidak dapat menggunakan suara
Periksa pengaturan Suara, izin mikrofon browser, akses paket, dan batas menit suara.
Apa yang harus dilakukan selanjutnya: Tambahkan pengaturan suara/avatar dan sumber pengetahuan sebelum peluncuran produksi.
05
Suara dan Avatar
Pilih suara stok, konfigurasikan mode dan batas suara, baca transkrip, kloning suara, tetapkan suara kloning, dan kelola stok atau avatar khusus.
Bot Builder / SuaraSuara, batasan, transkrip, dan avatar
1Pilih suara stok atau suara kloning yang disimpan.
2Tetapkan batas menit suara dan penyimpanan transkrip.
3Pilih avatar stok atau unggah avatar khusus jika paket memungkinkan.
Pengaturan suara
Atur panggilan suara dan transkrip
Untuk apa ini: Gunakan ini ketika pengunjung harus berbicara dengan bot, bukan hanya mengetik.
Sebelum Anda mulai
Konfirmasikan paket tersebut mencakup menit suara dan opsi suara/avatar yang diinginkan.
Gunakan lingkungan browser yang tenang untuk pengujian.
Siapkan satu pertanyaan dukungan atau penjualan yang realistis untuk diuji dengan suara.
1
Buka pengaturan Suara
Buka pembuat bot dan pilih area Suara atau Suara dan Avatar.
Hasil yang diharapkan: Kontrol suara dan pemilihan suara saat ini terlihat.
2
Pilih suara stok
Pratinjau suara yang tersedia, pilih yang paling cocok, dan simpan pilihan.
Hasil yang diharapkan: Bot menggunakan suara yang dipilih untuk panggilan.
3
Konfigurasikan mode suara
Gunakan Pengaturan Widget untuk memilih Suara atau Hibrida ketika suara harus tersedia bagi pengunjung.
Hasil yang diharapkan: Pengunjung melihat opsi suara di widget.
4
Tetapkan batas suara
Tentukan batas per pengguna atau ruang kerja jika tersedia.
Hasil yang diharapkan: Panggilan yang panjang atau berulang-ulang tidak akan memakan waktu lebih lama dari yang diharapkan.
5
Aktifkan transkrip
Aktifkan penyimpanan transkrip jika Anda memerlukan peninjauan panggilan dalam riwayat.
Hasil yang diharapkan: Panggilan suara membuat transkrip yang dapat dibaca setelah sesi.
6
Uji panggilan
Buka widget, izinkan akses mikrofon, mulai panggilan, dan ajukan pertanyaan yang sudah disiapkan.
Hasil yang diharapkan: Bot merespons dengan suara dan panggilan berakhir dengan rapi.
7
Baca transkripnya
Buka Chat History dan temukan percakapan suara.
Hasil yang diharapkan: Transkrip menunjukkan apa yang dikatakan pengunjung dan bot.
Cara mengujinya: Selesaikan satu panggilan singkat dan konfirmasikan menit suara, transkrip, dan mode percakapan telah direkam.
Masalah
Perbaiki
Browser memblokir mikrofon
Izinkan izin mikrofon di browser dan muat ulang halaman.
Opsi suara terkunci
Buka Penagihan dan konfirmasikan paket ruang kerja menyertakan fitur suara.
Transkrip kosong
Konfirmasikan penyimpanan transkrip diaktifkan dan panggilan berakhir secara normal.
Apa yang harus dilakukan selanjutnya: Menambah atau menyempurnakan pengetahuan agar jawaban suara akurat.
Klon suara dan avatar
Kloning suara dan tetapkan avatar khusus
Untuk apa ini: Gunakan ini saat asisten memerlukan suara bermerek atau pengalaman avatar berbicara.
Sebelum Anda mulai
Gunakan hanya audio dan gambar yang Anda punya izin untuk menggunakannya.
Rekam sampel suara bersih dengan kebisingan latar belakang rendah.
Konfirmasikan batas paket untuk suara kloning dan avatar khusus.
1
Buka Kloning Suara
Klik Kloning Suara dari area Suara.
Hasil yang diharapkan: Dialog unggahan menunjukkan persyaratan sampel yang diterima.
2
Unggah sampel
Unggah satu hingga lima rekaman jelas dan kirimkan permintaan kloning.
Hasil yang diharapkan: Suara kloning muncul setelah pemrosesan atau dialog menampilkan persyaratan selanjutnya.
3
Tetapkan suara kloning
Pilih suara kloning di pemilih suara dan simpan.
Hasil yang diharapkan: Panggilan selanjutnya menggunakan suara kloning.
4
Pilih avatar stok
Pilih avatar yang disertakan jika unggahan avatar khusus tidak diperlukan.
Hasil yang diharapkan: Pengalaman suara memiliki identitas visual.
5
Unggah avatar khusus
Unggah gambar wajah yang jelas atau video pendek jika rencana Anda mendukungnya.
Hasil yang diharapkan: Avatar diproses dan tersedia untuk dipilih.
6
Jalankan pratinjau penuh
Mulai panggilan suara dan konfirmasikan perilaku suara, avatar, dan transkrip secara bersamaan.
Hasil yang diharapkan: Pengalaman pengunjung cocok dengan merek yang dikonfigurasi.
Cara mengujinya: Ajukan pertanyaan singkat dengan suara kloning dipilih dan konfirmasikan panggilan menggunakan suara/avatar yang diharapkan.
Masalah
Perbaiki
Kualitas klon buruk
Rekam sampel yang lebih bersih dengan satu speaker, volume stabil, dan tanpa musik.
Unggahan avatar khusus tidak tersedia
Periksa Penagihan untuk mengetahui batas avatar yang dibatasi paket.
Suara lama masih terdengar
Simpan bot setelah memilih suara baru dan muat ulang halaman widget.
Apa yang harus dilakukan selanjutnya: Lanjutkan ke Pengetahuan dan Data sehingga pengalaman suara memiliki jawaban yang akurat.
06
Pengetahuan dan Data
Tambahkan pengetahuan manual, impor konten situs web, terapkan hasil perayapan, sinkronkan konten yang diimpor, tambahkan umpan produk URLs, segarkan atau hapus umpan, dan verifikasi jawaban dengan pertanyaan tes.
Bot Builder / PengetahuanSumber pengetahuan dan pengujian jawaban
1Tambahkan pengetahuan manual untuk kebijakan, harga, dan aturan merek.
2Impor halaman situs web dan terapkan hasil perayapan.
3Tambahkan feed produk dan sinkronkan saat inventaris berubah.
Sumber pengetahuan
Latih bot dengan pengetahuan manual, impor situs web, dan umpan produk
Untuk apa ini: Gunakan ini setiap kali asisten memberikan jawaban yang tidak lengkap atau membutuhkan informasi produk, kebijakan, atau situs web baru.
Sebelum Anda mulai
Siapkan URLs sumber dan feed produk URLs.
Putuskan halaman mana yang tidak boleh diimpor, seperti halaman admin atau pribadi.
Buat pertanyaan tes untuk setiap topik yang Anda tambahkan.
1
Pengetahuan Terbuka
Buka Bot Builder dan pilih tab Pengetahuan atau Data.
Hasil yang diharapkan: Pengetahuan manual, impor situs web, dan alat umpan produk terlihat.
2
Tambahkan pengetahuan manual
Tempelkan fakta singkat, kebijakan, harga, detail kontak, dan catatan gaya jawaban.
Hasil yang diharapkan: Bot memiliki sumber tepercaya langsung untuk jawaban berprioritas tinggi.
3
Impor konten situs web
Rekatkan situs web publik URL dan mulai perayapan/impor.
Hasil yang diharapkan: Hasil perayapan menunjukkan halaman yang ditemukan atau status impor.
4
Tinjau dan terapkan hasilnya
Pertahankan halaman yang bermanfaat, hapus halaman yang tidak relevan, lalu terapkan konten yang dipilih.
Hasil yang diharapkan: Hanya konten situs web yang disetujui yang masuk ke basis pengetahuan.
5
Tambahkan umpan produk URLs
Tempel Google Merchant Center atau feed URLs yang didukung dan impor.
Hasil yang diharapkan: Produk, harga, ketersediaan, dan atribut tersedia untuk bot.
6
Segarkan atau hapus feed
Gunakan penyegaran saat data katalog berubah dan hapus feed yang tidak lagi digunakan.
Hasil yang diharapkan: Bot menghindari data produk yang basi atau duplikat.
7
Simpan dan sinkronkan
Simpan bot dan tunggu hingga sinkronisasi selesai.
Hasil yang diharapkan: Pengetahuan terbaru digunakan oleh pratinjau dan jawaban widget langsung.
8
Ajukan pertanyaan verifikasi
Ajukan satu pertanyaan tes per sumber yang Anda tambahkan.
Hasil yang diharapkan: Jawabannya mengutip atau mencerminkan konten yang diperbarui secara akurat.
Cara mengujinya: Ajukan pertanyaan tentang harga, pengembalian, ketersediaan, info perusahaan, dan topik yang tidak didukung. Konfirmasikan bahwa bot menjawab topik yang diketahui dan tidak memberikan detail yang tidak diketahui.
Masalah
Perbaiki
Crawler mengimpor halaman yang tidak relevan
Hapus halaman tersebut dari hasil yang dipilih dan tambahkan instruksi manual yang lebih jelas.
Harga produk sudah basi
Segarkan feed dan konfirmasikan feed URL itu sendiri berisi nilai saat ini.
Bot membuat jawaban
Tambahkan aturan bahwa bot harus mengatakan tidak yakin dan menawarkan dukungan manusia ketika pengetahuan hilang.
Apa yang harus dilakukan selanjutnya: Kembali ke Pratinjau, uji lagi, lalu instal atau perbarui widget.
07
Kotak Masuk, Live Support, Riwayat, Kontak
Tangani conversations setiap hari, klaim permintaan dukungan langsung, kendalikan kembali ke AI, ekspor riwayat, kelola kontak, dan sinkronkan kontak ke SendPulse.
/kotak masukAlur kerja percakapan kotak masuk
1Filter berdasarkan bot atau saluran.
2Buka percakapan dan balas sebagai manusia saat dibutuhkan.
3Gunakan kontrol terjemahan, penyelesaian, dan penyerahan dengan hati-hati.
/dukungan langsungKontrol handoff dukungan langsung
1Klaim penyerahan yang menunggu dengan cepat.
2Balas sebagai agen atau kembalikan percakapan ke AI.
3Selesaikan ketika pengunjung tidak lagi membutuhkan bantuan manusia.
/chat-sejarahRiwayat percakapan dan ekspor
1Cari berdasarkan pengunjung, bot, saluran, atau tanggal.
2Buka transkrip lengkap untuk sesi teks dan suara.
3Ekspor CSV atau JSON bila diperlukan.
/kontakKontak dan SendPulse ekspor
1Filter kontak berdasarkan bot atau sumber.
2Buka detail kontak dan konteks percakapan.
3Ekspor atau sinkronkan kontak yang dipilih ke SendPulse.
Balasan kotak masuk
Buka percakapan dan kirim balasan manusia
Untuk apa ini: Gunakan ini ketika operator perlu merespons pelanggan dari sem.chat alih-alih membiarkan AI melanjutkan sendiri.
Sebelum Anda mulai
Konfirmasikan bahwa operator memiliki akses ke bot atau ruang kerja.
Baca percakapan sebelum membalas.
Ketahui apakah pengunjung mengharapkan bahasa yang sama.
1
Buka Kotak Masuk
Klik Kotak Masuk di bar samping.
Hasil yang diharapkan: conversations terbaru muncul dengan bot, saluran, pengunjung, status, dan waktu.
2
Saring jika diperlukan
Gunakan filter saluran, bot, belum dibaca, atau status untuk menemukan percakapan.
Hasil yang diharapkan: Daftarnya menyempit ke rangkaian percakapan yang Anda perlukan.
3
Buka percakapan
Klik baris pengunjung.
Hasil yang diharapkan: Thread lengkap, info pengunjung, dan kontrol balasan terlihat.
4
Terjemahkan jika diperlukan
Gunakan kontrol terjemahan ketika bahasa pengunjung berbeda dari bahasa agen.
Hasil yang diharapkan: Agen dapat memahami dan membalas dengan tepat.
5
Kirim balasan
Tulis tanggapan manusia dan kirimkan.
Hasil yang diharapkan: Pesan ditambahkan ke thread sebagai agen/balasan manusia.
6
Putuskan atau tetap terbuka
Selesaikan percakapan jika sudah selesai, atau biarkan terbuka untuk tindak lanjut.
Hasil yang diharapkan: Status kotak masuk sesuai dengan keadaan pelanggan sebenarnya.
Cara mengujinya: Kirim balasan pengujian yang aman ke percakapan pengujian dan konfirmasikan bahwa balasan tersebut muncul di widget pengunjung dan Chat History.
Masalah
Perbaiki
Balasan gagal dikirim
Periksa status jaringan, status percakapan, dan apakah dukungan langsung telah diklaim.
Bahasa pengunjung salah
Gunakan terjemahan atau perbarui pengaturan bahasa bot sebelum membalas.
Percakapan tidak ada di Kotak Masuk
Cari Chat History dan konfirmasi pengujian widget menggunakan bot yang benar.
Apa yang harus dilakukan selanjutnya: Gunakan Live Support untuk antrian handoff aktif dan Chat History untuk audit.
Dukungan langsung
Klaim, balas, serahkan kembali ke AI, dan selesaikan serah terima
Untuk apa ini: Gunakan ini ketika AI meminta manusia atau pengunjung secara eksplisit membutuhkan agen.
Sebelum Anda mulai
Sediakan agen sebelum mengaktifkan dukungan langsung.
Tentukan kapan AI harus meminta penyerahan dalam instruksi bot.
Tetap aktifkan pengaturan notifikasi untuk peringatan handoff.
1
Buka Live Support
Klik Live Support di bilah sisi.
Hasil yang diharapkan: Menunggu dan handoff aktif conversations terlihat.
2
Klaim permintaan tersebut
Klik Klaim pada percakapan yang menunggu.
Hasil yang diharapkan: Agen lain dapat melihat percakapan tersebut ditangani secara aktif.
3
Baca konteks
Buka pesan dan detail pengunjung sebelum membalas.
Hasil yang diharapkan: Agen memahami mengapa serah terima itu terjadi.
4
Kirim balasan manusia
Tanggapi dengan jelas dan terus perbarui topiknya.
Hasil yang diharapkan: Pengunjung menerima tanggapan manusia.
5
Serahkan kembali ke AI jika perlu
Gunakan tangan kembali ketika masalah terjawab dan AI dapat melanjutkan.
Hasil yang diharapkan: AI kembali menangani percakapan.
6
Putuskan setelah selesai
Klik Selesaikan setelah pengunjung tidak lagi membutuhkan bantuan.
Hasil yang diharapkan: Handoff ditutup dan dikeluarkan dari antrian aktif.
Cara mengujinya: Buat uji serah terima, klaim, balas satu kali, serahkan kembali, dan konfirmasikan perubahan status di Live Support dan Chat History.
Masalah
Perbaiki
Agen melewatkan permintaan
Aktifkan pemberitahuan browser/email/push dan tambahkan proses untuk kepemilikan antrean.
AI terus mengambil alih terlalu cepat
Sesuaikan instruksi dan aturan serah terima sehingga kendali manusia tetap aktif hingga diselesaikan atau diserahkan kembali.
CRM eksternal tidak sinkron
Gunakan webhook atau polling dari bagian Resep Pengembang.
Apa yang harus dilakukan selanjutnya: Hubungkan CRM/webhook jika tim dukungan bekerja di luar sem.chat.
Sejarah dan kontak
Cari, ekspor, dan gunakan catatan percakapan/kontak
Untuk apa ini: Gunakan ini untuk audit, tinjauan prospek, ekspor CSV, dan sinkronisasi SendPulse.
Sebelum Anda mulai
Putuskan apakah Anda memerlukan conversations, kontak, atau keduanya.
Terapkan rentang tanggal yang benar sebelum mengekspor.
Jangan mengekspor data pribadi lebih dari yang diperlukan.
1
Buka Chat History
Klik Chat History di bilah sisi.
Hasil yang diharapkan: Filter percakapan, statistik, dan daftar transkrip terlihat.
2
Cari dan saring
Filter berdasarkan bot, saluran, mode, pengunjung, atau rentang tanggal.
Hasil yang diharapkan: Hanya conversations yang cocok yang tetap terlihat.
3
Buka transkrip
Klik percakapan untuk membaca rangkaian pesan selengkapnya.
Hasil yang diharapkan: Konteks lengkap, detail kontak, dan metadata percakapan terlihat.
4
Ekspor conversations
Klik Ekspor dan pilih format yang diperlukan jika tersedia.
Hasil yang diharapkan: Ekspor berisi data percakapan yang difilter.
5
Buka Kontak
Klik Kontak di bar samping.
Hasil yang diharapkan: Catatan prospek/kontak muncul dengan sumber, bot, dan status.
6
Filter dan ekspor kontak
Cari kontak, pilih catatan yang diinginkan, lalu ekspor atau sinkronkan ke SendPulse.
Hasil yang diharapkan: Kontak yang dipilih tersedia di luar sem.chat sesuai dengan tindakan yang dipilih.
Cara mengujinya: Ekspor CSV kecil yang difilter dan buka secara lokal untuk mengonfirmasi kolom dan rentang tanggal sudah benar.
Masalah
Perbaiki
Kontak hilang dari Kontak
Konfirmasikan pengambilan prospek diaktifkan dan pengunjung mengirimkan formulir.
Ekspor terlalu besar
Persempit rentang tanggal atau filter bot sebelum mengekspor.
Sinkronisasi SendPulse tidak tersedia
Hubungkan SendPulse di Integrasi terlebih dahulu, lalu kembali ke Kontak.
Apa yang harus dilakukan selanjutnya: Tinjau Analytics untuk memahami tren kinerja setelah operasi berjalan.
08
Saluran Dan Integrasi
Hubungkan Slack, Facebook, Instagram, WhatsApp, Telegram melalui Botfather, kredensial manual, tautan chat alternatif, SendPulse, dan integrasi CRM.
/integrasiSaluran, CRM, dan koneksi email
1Pilih saluran atau kartu integrasi CRM.
2Ikuti langkah-langkah OAuth atau kredensial untuk setiap penyedia.
3Putuskan sambungan atau uji ulang integrasi dari halaman yang sama.
Hubungkan saluran
Hubungkan saluran perpesanan atau integrasi CRM
Untuk apa ini: Gunakan ini ketika sem.chat harus menerima conversations di luar widget situs web atau mengirim kontak ke alat lain.
Sebelum Anda mulai
Memiliki akses admin ke platform eksternal.
Ketahui bot mana yang harus menerima pesan saluran.
Gunakan saluran pengujian sebelum menghubungkan akun produksi.
1
Integrasi Terbuka
Klik Integrasi di sidebar.
Hasil yang diharapkan: Saluran yang tersedia, alat CRM, SendPulse, dan opsi widget situs web terlihat.
2
Pilih integrasi
Klik Hubungkan di Slack, saluran Meta, Telegram, SendPulse, CRM, atau kredensial manual.
Hasil yang diharapkan: Dialog penyiapan atau alur OAuth akan terbuka.
3
Selesaikan penyiapan penyedia
Untuk saluran OAuth, setujui izin yang diminta. Untuk saluran manual, tempelkan token, rahasia, ID akun, atau webhook URL yang diperlukan.
Hasil yang diharapkan: sem.chat menyimpan koneksi dan menunjukkan integrasi sebagai terhubung.
4
Tetapkan botnya
Pilih bot mana yang harus menangani pesan dari saluran tersebut saat dialog ditanyakan.
Hasil yang diharapkan: Pesan masuk dirutekan ke asisten yang benar.
5
Uji salurannya
Kirim pesan percobaan dari saluran eksternal.
Hasil yang diharapkan: Pesan tersebut muncul di Kotak Masuk atau Chat History di bawah saluran yang benar.
6
Putuskan sambungan jika diperlukan
Gunakan Putuskan sambungan dari kartu integrasi ketika saluran harus dihentikan.
Hasil yang diharapkan: sem.chat berhenti menerima atau mengirim melalui integrasi itu.
Cara mengujinya: Kirim satu pesan percobaan melalui saluran yang terhubung dan konfirmasikan balasan bot, baris Kotak Masuk, dan catatan riwayat.
Masalah
Perbaiki
Token Telegram gagal
Buat atau setel ulang token di Botfather dan tempelkan lagi.
Slack pesan tidak sampai
Periksa cakupan aplikasi, langganan acara URL, token bot, rahasia penandatanganan, dan keanggotaan saluran.
Koneksi saluran meta gagal
Konfirmasikan bahwa akun Facebook/Instagram/WhatsApp memiliki izin admin dan memerlukan akses bisnis.
Sinkronisasi SendPulse gagal
Hubungkan kembali SendPulse dan konfirmasikan bidang kontak telah dipetakan.
Apa yang harus dilakukan selanjutnya: Dokumentasikan kepemilikan saluran untuk tim dan pantau Inbox setelah peluncuran.
09
Penjadwalan
Buat jenis acara, konfigurasikan ketersediaan, sambungkan kalender, kelola pemesanan, buat tautan satu kali, konfigurasikan email pemesanan, tinjau analitik, atur acara berbayar, dan uji tautan pemesanan publik.
/ penjadwalanMenjadwalkan ruang kerja
1Gunakan tab untuk Jenis Acara, Pemesanan, Analisis, Tautan Sekali Pakai, Kalender, Email, dan Pengaturan.
2Edit, salin, sematkan, aktifkan, atau jeda jenis acara.
3Salin tautan publik dan jalankan tes pemesanan pribadi.
Editor acaraKonfigurasi jenis acara
1Masukkan nama, deskripsi, durasi, lokasi, dan buffer.
2Tetapkan ketersediaan, jangka waktu pemesanan, pertanyaan, opsi acara berbayar, dan aturan pembatalan.
1Pengunjung memilih tanggal dari halaman pemesanan umum.
2Pengunjung memilih slot waktu yang tersedia.
3Pengunjung mengkonfirmasi pemesanan dan menerima email konfirmasi.
Jenis acara
Buat jenis acara dan publikasikan tautan pemesanan
Untuk apa ini: Gunakan ini ketika pengunjung harus memesan demo, konsultasi, panggilan penjualan, orientasi, atau sesi dukungan.
Sebelum Anda mulai
Pilih nama acara, durasi, jenis rapat, dan pemilik.
Tetapkan zona waktu dan ketersediaan sebelum membagikan tautan.
Hubungkan kalender jika pemesanan ganda penting.
1
Buka Penjadwalan
Klik Penjadwalan di bar samping.
Hasil yang diharapkan: Ruang kerja penjadwalan memperlihatkan tab untuk jenis acara, pemesanan, analitik, tautan satu kali, kalender, email, dan pengaturan.
2
Buat jenis acara
Klik Buat, lalu tambahkan nama, deskripsi, durasi, lokasi, buffer, dan aturan pemesanan.
Hasil yang diharapkan: Acara tersebut memiliki informasi publik yang cukup bagi pengunjung untuk memahaminya.
3
Tetapkan ketersediaan
Konfigurasikan jam mingguan, penggantian tanggal, jendela pemberitahuan, dan jendela pemesanan.
Hasil yang diharapkan: Pengunjung hanya melihat waktu yang ingin Anda tawarkan.
4
Tambahkan pertanyaan
Tambahkan pertanyaan wajib seperti telepon, perusahaan, situs web, atau tujuan pertemuan.
Hasil yang diharapkan: Pemesanan mengumpulkan konteks yang dibutuhkan tim Anda sebelum panggilan dilakukan.
5
Hubungkan kalender
Buka Kalender dan sambungkan Google, Outlook, atau iCal jika tersedia.
Hasil yang diharapkan: Waktu sibuk dapat diblokir dan pemesanan yang dikonfirmasi dapat ditulis ke kalender.
6
Atur email dan pengingat
Buka Email dan konfigurasikan konfirmasi, pengingat, pembatalan, dan penjadwalan ulang pesan.
Hasil yang diharapkan: Pengunjung menerima komunikasi pemesanan yang benar.
7
Bagikan dan uji tautan publik
Salin tautan acara, buka di jendela pribadi, pilih slot, dan selesaikan pemesanan tes.
Hasil yang diharapkan: Pemesanan muncul di tab Pemesanan dan pesan konfirmasi dikirim.
Cara mengujinya: Selesaikan satu pemesanan tes, satu penjadwalan ulang, dan satu pembatalan. Konfirmasikan setiap acara muncul di Penjadwalan dan kalender yang terhubung.
Masalah
Perbaiki
Tidak ada waktu yang muncul di halaman publik
Periksa zona waktu, ketersediaan mingguan, penggantian tanggal, jendela pemberitahuan, dan konflik kalender yang terhubung.
Email pemesanan hilang
Periksa pengaturan email dan folder spam, lalu kirim pemesanan tes lainnya.
Pembayaran gagal pada acara berbayar
Konfirmasikan setelan integrasi penagihan/pembayaran dan mata uang valid sebelum dipublikasikan.
Apa yang harus dilakukan selanjutnya: Sematkan tautan pemesanan di bot, situs web, atau email tindak lanjut.
Penjadwalan lanjutan
Gunakan tautan satu kali, analitik, penyematan, dan acara berbayar
Untuk apa ini: Gunakan ini ketika penjadwalan memerlukan ketersediaan sementara, pelaporan, pemesanan tertanam, atau pembayaran.
Sebelum Anda mulai
Buat setidaknya satu jenis acara terlebih dahulu.
Hubungkan kalender sebelum banyak menggunakan tautan satu kali.
Tentukan kebijakan pengembalian dana/pembatalan sebelum mengaktifkan acara berbayar.
1
Buat tautan satu kali
Buka Tautan Satu Kali, pilih slot atau aturan yang ditawarkan, lalu buat tautannya.
Hasil yang diharapkan: Penerima dapat memesan hanya dari ketersediaan yang dipilih.
2
Sematkan penjadwalan
Gunakan opsi penyematan kartu acara jika alur pemesanan akan muncul di situs web Anda.
Hasil yang diharapkan: UI pemesanan dapat ditempatkan di halaman tempat pengunjung melakukan konversi.
3
Tinjau analitik penjadwalan
Buka Analytics di dalam Penjadwalan.
Hasil yang diharapkan: Anda dapat melihat pemesanan, tren penyelesaian, dan performa jenis acara.
4
Aktifkan acara berbayar
Buka editor acara, atur harga, mata uang, dan perilaku pembayaran.
Hasil yang diharapkan: Pengunjung harus menyelesaikan langkah pembayaran sesuai dengan pengaturan acara.
5
Pemesanan audit
Buka Pemesanan dan tinjau entri yang akan datang, selesai, dibatalkan, dan dijadwalkan ulang.
Hasil yang diharapkan: Tim dapat mengatur kehadiran dan tindak lanjut.
Cara mengujinya: Pesan melalui halaman publik dan melalui halaman tersemat jika digunakan. Konfirmasikan keduanya membuat jenis catatan pemesanan yang sama.
Masalah
Perbaiki
Tautan satu kali memperlihatkan slot yang salah
Buat ulang tautan dengan kumpulan slot yang lebih kecil atau rentang tanggal yang lebih ketat.
Pemesanan tertanam terlalu sempit
Tempatkan penyematan dalam wadah konten yang lebih luas dan periksa tata letak seluler.
Analytics terlihat kosong
Buat atau tunggu pemesanan nyata; analitik bergantung pada catatan pemesanan.
Apa yang harus dilakukan selanjutnya: Hubungkan hasil penjadwalan ke Laporan dan Analisis.
10
Analisis Dan Laporan
Pilih rentang tanggal, gunakan tanggal khusus, baca metrik inti, ekspor CSV, tinjau kepuasan dan tren percakapan, konfigurasikan laporan email, dan verifikasi pengiriman.
/analitikDasbor analitik
1Pilih rentang tanggal atau tanggal khusus.
2Baca metrik percakapan, kepuasan, bahasa, saluran, dan konversi.
3Ekspor CSV untuk analisis offline.
Pengaturan / LaporanPengaturan laporan email
1Pilih irama laporan harian, mingguan, atau bulanan.
2Tambahkan penerima laporan.
3Kirim laporan instan untuk menguji pengiriman.
Tinjauan analitik
Baca analitik dan ekspor data kinerja
Untuk apa ini: Gunakan ini untuk tinjauan mingguan, pemeriksaan peluncuran, tinjauan kualitas dukungan, dan analisis konversi.
Sebelum Anda mulai
Pilih rentang tanggal sebelum membaca metrik.
Ketahui bot atau saluran mana yang Anda evaluasi.
Kecualikan tanggal pengujian pribadi saat melaporkan kinerja produksi.
1
Buka Analisis
Klik Analytics di bilah sisi.
Hasil yang diharapkan: Metrik dasbor dan panel bagan terlihat.
2
Pilih rentang tanggal
Pilih hari ini, 7 hari, 30 hari, atau tanggal khusus.
Hasil yang diharapkan: Semua grafik diperbarui ke periode yang dipilih.
3
Baca metrik inti
Tinjau conversations, notulen suara, kepuasan, konversi, dan campuran saluran.
Hasil yang diharapkan: Anda memahami volume dan kualitas interaksi pelanggan.
4
Tinjau tren
Lihatlah tren percakapan, perubahan kepuasan, pertanyaan populer, dan pola bahasa/saluran.
Hasil yang diharapkan: Anda dapat mengidentifikasi tempat untuk meningkatkan instruksi atau staf bot.
5
Ekspor CSV
Gunakan Ekspor CSV ketika tim memerlukan analisis spreadsheet.
Hasil yang diharapkan: CSV berisi rentang tanggal dan metrik yang dipilih.
6
Ubah temuan menjadi perubahan
Perbarui instruksi bot, pengetahuan, pengaturan widget, atau cakupan dukungan berdasarkan data.
Hasil yang diharapkan: Analisis mengarah pada peningkatan produk yang nyata.
Cara mengujinya: Ekspor tanggal khusus kecil CSV dan verifikasi rentang tanggal dan metrik sesuai dengan yang ditampilkan dasbor.
Masalah
Perbaiki
Metrik tampaknya terlalu tinggi
Periksa apakah pementasan/pengujian conversations disertakan dalam rentang tanggal yang dipilih.
Kepuasan itu kosong
Aktifkan peringkat di Pengaturan Widget dan tunggu pengunjung memberikan peringkat.
Notulen suara tidak sesuai ekspektasi
Konfirmasikan mode suara diaktifkan hanya pada bot yang dituju.
Apa yang harus dilakukan selanjutnya: Jadwalkan laporan email untuk visibilitas berulang.
Laporan
Konfigurasikan laporan email berulang dan uji pengiriman
Untuk apa ini: Gunakan ini ketika pemilik, manajer, atau klien memerlukan ringkasan kinerja otomatis.
Sebelum Anda mulai
Putuskan siapa yang harus menerima laporan.
Gunakan alamat email terverifikasi.
Pilih irama yang sesuai dengan ritme tinjauan bisnis.
1
Buka Pengaturan, lalu Laporan
Buka Pengaturan dan pilih tab Laporan, atau gunakan pengalihan Laporan jika tersedia.
Hasil yang diharapkan: Irama laporan, penerima, dan riwayat terlihat.
2
Pilih irama
Aktifkan laporan harian, mingguan, atau bulanan.
Hasil yang diharapkan: Jadwal laporan disimpan untuk ruang kerja.
3
Tambahkan penerima
Masukkan alamat email yang seharusnya menerima laporan.
Hasil yang diharapkan: Laporan dikirim ke pemangku kepentingan yang benar.
4
Kirim laporan instan
Klik Kirim Sekarang atau tindakan laporan instan yang setara.
Hasil yang diharapkan: Email laporan segera dikirim untuk verifikasi.
5
Tinjau riwayat laporan
Periksa panel riwayat setelah laporan dikirim.
Hasil yang diharapkan: Anda dapat mengonfirmasi status dan waktu pengiriman.
Cara mengujinya: Kirim laporan instan ke penerima tes dan konfirmasikan penerimaan dan pemformatan.
Masalah
Perbaiki
Email laporan tidak sampai
Periksa ejaan penerima, folder spam, dan status riwayat laporan.
Orang yang salah menerima laporan
Perbarui penerima dan simpan sebelum jadwal pengiriman berikutnya.
Konten laporan terasa berisik
Sesuaikan ekspektasi rentang tanggal dan gunakan Analytics untuk peninjauan manual yang lebih mendalam.
Apa yang harus dilakukan selanjutnya: Gunakan irama laporan sebagai ritme operasi untuk peningkatan bot.
11
Penagihan, Tim, Keamanan, Pengaturan, Afiliasi
Mulai atau tingkatkan paket, kelola portal penagihan, undang rekan satu tim, tetapkan peran, edit profil/bahasa, konfigurasikan notifikasi, aktifkan 2FA, gunakan tindakan zona bahaya, dan jalankan alur kerja afiliasi.
/penagihanKontrol rencana dan penagihan
1Tinjau rencana saat ini, status uji coba, dan batas usage.
2Bandingkan fitur paket sebelum meningkatkan.
3Buka portal penagihan untuk faktur, metode pembayaran, pembatalan, atau pengaktifan kembali.
/pengaturanPengaturan, tim, dan keamanan
1Gunakan Umum untuk profil dan bahasa.
2Gunakan Tim untuk undangan dan peran.
3Gunakan Keamanan untuk 2FA, kunci API, dan tindakan zona bahaya.
/ afiliasiKontrol program afiliasi
1Bergabunglah dengan program untuk membuat tautan rujukan.
2Salin tautan rujukan untuk kampanye.
3Tetapkan email pembayaran dan minta pembayaran yang memenuhi syarat.
Penagihan
Mulai, tingkatkan, batalkan, atau aktifkan kembali paket
Untuk apa ini: Gunakan ini ketika ruang kerja memerlukan aktivasi uji coba, batasan lebih lanjut, faktur, pembaruan pembayaran, atau perubahan langganan.
Sebelum Anda mulai
Pemilik akun atau admin penagihan harus melakukan tindakan penagihan.
Konfirmasikan fitur mana yang dibatasi rencana: suara, suara kloning, avatar khusus, API, tim, CRM, dan saluran.
Gunakan portal penagihan aman untuk metode pembayaran dan perubahan faktur.
1
Buka Penagihan
Klik Penagihan di sidebar.
Hasil yang diharapkan: Paket saat ini, status uji coba, batas usage, dan kartu paket terlihat.
Hasil yang diharapkan: Anda tahu paket mana yang membuka fitur yang diperlukan.
3
Pilih interval penagihan
Pilih bulanan atau tahunan jika tombol tersedia.
Hasil yang diharapkan: Pembaruan harga dan penghematan untuk interval yang dipilih.
4
Tingkatkan versi atau mulai pembayaran
Pilih paket yang diinginkan dan selesaikan pembayaran.
Hasil yang diharapkan: Langganan menjadi aktif setelah konfirmasi pembayaran.
5
Buka portal pelanggan
Gunakan portal penagihan untuk metode pembayaran, faktur, pembatalan, atau pengaktifan kembali.
Hasil yang diharapkan: Tindakan penagihan sensitif terjadi di portal penyedia aman.
6
Verifikasi akses fitur
Kembali ke fitur yang dikunci dan muat ulang aplikasi.
Hasil yang diharapkan: Fitur tidak terkunci sekarang tersedia jika paket menyertakannya.
Cara mengujinya: Setelah memutakhirkan, buka fitur yang sebelumnya terkunci, seperti klon suara atau kunci API, dan konfirmasikan bahwa kunci telah hilang.
Masalah
Perbaiki
Fitur tetap terkunci setelah peningkatan
Refresh aplikasi, tunggu sebentar untuk sinkronisasi langganan, lalu periksa kembali Penagihan.
Pembayaran dibatalkan
Kembali ke Penagihan dan mulai checkout lagi; tidak ada perubahan paket yang terjadi setelah pembayaran dibatalkan.
Perlu faktur atau perubahan kartu
Buka portal pelanggan alih-alih mengedit detail pembayaran di dalam aplikasi.
Apa yang harus dilakukan selanjutnya: Undang rekan satu tim dan amankan akun pemilik.
Tim dan keamanan
Undang rekan satu tim, tetapkan peran, edit profil, aktifkan 2FA, dan kelola pengaturan
Untuk apa ini: Gunakan ini saat ruang kerja berpindah dari pengaturan solo ke operasi tim.
Sebelum Anda mulai
Ketahui setiap peran rekan satu tim sebelum mengirim undangan.
Gunakan akses dengan hak paling rendah: Pemilik, Admin, Editor, Pengakses lihat-saja.
Siapkan aplikasi pengautentikasi untuk 2FA.
1
Buka Pengaturan
Klik Pengaturan di bar samping.
Hasil yang diharapkan: Umum, pemberitahuan, tim, laporan, pengembang, keamanan, dan tab terkait terlihat.
2
Edit profil dan bahasa
Perbarui nama tampilan, informasi profil, dan bahasa pilihan secara Umum.
Hasil yang diharapkan: Aplikasi ini mengidentifikasi pengguna dengan benar dan menggunakan bahasa yang dipilih jika tersedia.
3
Undang anggota tim
Buka Tim, masukkan email, pilih peran, dan kirim undangan.
Hasil yang diharapkan: Rekan satu tim menerima tautan undangan dan tampak tertunda hingga diterima.
4
Tetapkan izin peran
Gunakan Pemilik untuk kontrol penuh, Admin untuk manajemen, Editor untuk perubahan konten, dan Viewer untuk akses baca-saja.
Hasil yang diharapkan: Setiap pengguna memiliki akses sesuai dengan tanggung jawabnya.
5
Konfigurasikan notifikasi
Pilih email, browser, push, dukungan langsung, penagihan, dan pemberitahuan laporan.
Hasil yang diharapkan: Orang yang tepat mendapatkan peringatan tanpa kebisingan yang tidak perlu.
6
Aktifkan 2FA
Buka Keamanan, aktifkan autentikasi dua faktor, pindai kode, dan simpan detail pemulihan.
Hasil yang diharapkan: Akun memerlukan faktor kedua setelah login kata sandi.
7
Gunakan tindakan di zona bahaya dengan hati-hati
Ekspor data yang diperlukan dan konfirmasi widget/integrasi aktif sebelum tindakan akun yang merusak.
Hasil yang diharapkan: Ruang kerja menghindari kehilangan data yang tidak disengaja.
Cara mengujinya: Undang rekan satu tim pengujian, terima undangan di browser terpisah, dan konfirmasikan bahwa peran tersebut hanya memperlihatkan fitur yang diinginkan.
Masalah
Perbaiki
Email undangan tidak ada
Periksa spam, kirim ulang undangan, dan verifikasi alamat.
Rekan satu tim melihat terlalu banyak
Turunkan perannya dan tinjau pengaturan akses bot.
Pengaturan 2FA gagal
Periksa waktu perangkat, pindai ulang kode QR, dan simpan detail pemulihan sebelum mengandalkannya.
Apa yang harus dilakukan selanjutnya: Konfigurasikan kunci API hanya untuk pengguna dan layanan yang membutuhkannya.
Afiliasi
Bergabunglah dengan afiliasi, salin tautan rujukan, atur email pembayaran, dan minta pembayaran
Untuk apa ini: Gunakan ini ketika mitra atau pelanggan ingin merujuk pengguna sem.chat baru dan melacak aktivitas komisi.
Sebelum Anda mulai
Gunakan akun yang seharusnya memiliki atribusi rujukan.
Siapkan email pembayaran sebelum meminta pembayaran.
Periksa aturan program sebelum menerbitkan kampanye rujukan.
1
Buka Afiliasi
Klik Afiliasi di sidebar atau buka tab afiliasi dari Pengaturan jika ditautkan di sana.
Hasil yang diharapkan: Halaman program afiliasi menunjukkan area bergabung, rujukan, pembayaran, dan riwayat.
2
Bergabunglah dengan program ini
Klik Gabung jika akun belum bergabung.
Hasil yang diharapkan: Kode rujukan dan tautan rujukan dibuat.
3
Salin tautan rujukan
Salin tautan unik dan gunakan dalam konten, kampanye, atau pesan mitra.
Hasil yang diharapkan: Pendaftaran melalui tautan dapat dikaitkan ke akun afiliasi.
4
Tetapkan email pembayaran
Masukkan email pembayaran dan simpan.
Hasil yang diharapkan: Pembayaran yang memenuhi syarat dapat disalurkan dengan benar.
5
Tinjau referensi dan komisi
Periksa daftar referensi, status komisi, dan riwayat pembayaran.
Hasil yang diharapkan: Anda tahu apa yang tertunda, memenuhi syarat, atau sudah dibayar.
6
Minta pembayaran
Klik Minta Pembayaran ketika aturan dan minimum program terpenuhi.
Hasil yang diharapkan: Permintaan pembayaran dicatat untuk diproses.
Cara mengujinya: Buka tautan rujukan di browser pribadi dan konfirmasikan bahwa tautan tersebut sesuai dengan alur pendaftaran yang diharapkan dengan pelacakan rujukan.
Masalah
Perbaiki
Tautan rujukan tidak ada
Bergabunglah dengan program ini terlebih dahulu atau segarkan halaman afiliasi setelah bergabung.
Permintaan pembayaran tidak tersedia
Periksa ambang pembayaran minimum, status komisi yang memenuhi syarat, dan email pembayaran.
Rujukan tidak diatribusikan
Konfirmasikan bahwa pengunjung menggunakan tautan rujukan yang tepat dan tidak menghapus parameter pelacakan.
Apa yang harus dilakukan selanjutnya: Gunakan Analisis dan Laporan untuk memantau dampak pelanggan yang dirujuk jika memungkinkan.
12
Pemberitahuan Dan App Updates
Tinjau peringatan, tandai pemberitahuan sebagai telah dibaca, filter peristiwa penting, dan gunakan pembaruan aplikasi untuk memahami perubahan produk baru.
/pemberitahuanPusat notifikasi
1Gunakan Tandai semua telah dibaca setelah meninjau peringatan yang belum dibaca.
2Filter berdasarkan belum dibaca, penagihan, dukungan langsung, atau peristiwa sistem.
3Buka fitur terkait setelah membaca peringatan.
/pembaruan aplikasiUmpan pembaruan aplikasi
1Baca catatan rilis untuk mengetahui fitur baru dan perbaikan.
2Gunakan detail untuk melatih rekan satu tim sebelum alur kerja berubah.
3Periksa pembaruan setelah melihat perubahan UI atau perilaku.
Pemberitahuan
Tinjau notifikasi dan tindak lanjuti peringatannya
Untuk apa ini: Gunakan ini saat aplikasi melaporkan serah terima, status penagihan, peristiwa sistem, pengiriman laporan, atau aktivitas ruang kerja penting.
Sebelum Anda mulai
Pastikan preferensi notifikasi diatur di Pengaturan.
Memiliki cakupan dukungan langsung jika peringatan handoff diaktifkan.
Tinjau peringatan yang belum dibaca sebelum menandainya sebagai telah dibaca.
1
Buka Notifikasi
Klik Notifikasi di sidebar atau entri notifikasi header aplikasi.
Hasil yang diharapkan: Pusat notifikasi mencantumkan peringatan terkini.
2
Filter peringatan
Gunakan filter yang belum dibaca atau kategori untuk fokus pada penagihan, dukungan langsung, bot, laporan, atau peristiwa sistem.
Hasil yang diharapkan: Hanya lansiran yang cocok yang tetap terlihat.
3
Buka halaman terkait
Klik lansiran atau gunakan konteksnya untuk membuka Penagihan, Live Support, Laporan, atau bot yang relevan.
Hasil yang diharapkan: Anda bertindak berdasarkan notifikasi, bukan hanya membacanya.
4
Tandai sudah dibaca
Tandai satu peringatan telah dibaca atau gunakan Tandai semua telah dibaca setelah ditinjau.
Hasil yang diharapkan: Penurunan jumlah yang belum dibaca dan item yang ditinjau tidak lagi disorot.
5
Sesuaikan preferensi
Buka Pengaturan, Pemberitahuan jika terlalu banyak atau terlalu sedikit peringatan yang masuk.
Hasil yang diharapkan: Aliran notifikasi sesuai dengan kebutuhan tim.
Cara mengujinya: Buat acara pengujian yang aman seperti permintaan dukungan langsung atau laporan instan, lalu konfirmasikan bahwa pemberitahuan muncul dan dapat ditandai telah dibaca.
Masalah
Perbaiki
Tidak ada pemberitahuan yang masuk
Periksa preferensi pemberitahuan Pengaturan, izin browser, dan apakah peristiwa tersebut benar-benar terjadi.
Terlalu banyak peringatan
Nonaktifkan kategori yang berisik atau kirimkan hanya ke anggota tim yang bertanggung jawab.
Hitungan yang belum dibaca sepertinya terhenti
Segarkan aplikasi setelah menandai semua sudah dibaca dan konfirmasikan filter tidak menyembunyikan item yang belum dibaca.
Apa yang harus dilakukan selanjutnya: Tinjau App Updates ketika perilaku berubah atau kontrol baru muncul.
Pembaruan aplikasi
Gunakan pembaruan aplikasi untuk memahami perubahan produk
Untuk apa ini: Gunakan ini ketika rekan satu tim perlu mempelajari apa yang berubah sebelum menggunakan fitur baru.
Sebelum Anda mulai
Buka pembaruan setelah rilis besar atau ketika UI berubah.
Bagikan catatan pembaruan yang relevan dengan dukungan dan pengguna penjualan.
Uji ulang alur kerja penting setelah perubahan besar.
1
Buka App Updates
Klik App Updates di bilah sisi.
Hasil yang diharapkan: Umpan pembaruan menampilkan fitur baru, perbaikan, dan catatan rilis.
2
Baca pembaruan terkini
Buka kartu pembaruan terkini atau tampilan detail.
Hasil yang diharapkan: Anda melihat apa yang berubah dan alur kerja apa yang terpengaruh.
Hasil yang diharapkan: Anggota tim yang tepat tahu apa yang harus diperiksa.
4
Uji ulang jalur kritis
Jika pembaruan memengaruhi alur kerja produksi, ulangi langkah manual yang relevan dari dokumentasi ini.
Hasil yang diharapkan: Tim mengonfirmasi alur kerja yang diubah masih berfungsi.
5
Bagikan secara internal
Kirimkan ringkasan pembaruan kepada pengguna yang memiliki area yang terkena dampak.
Hasil yang diharapkan: Adopsi tim lebih lancar dan pertanyaan dukungan berkurang.
Cara mengujinya: Setelah pembaruan yang relevan, ulangi panduan untuk fitur yang terpengaruh dan konfirmasikan tangkapan layar atau nama langkah masih cocok.
Masalah
Perbaiki
Pembaruan menyebutkan fitur terkunci
Buka Penagihan untuk mengonfirmasi apakah paket saat ini menyertakannya.
Tim melewatkan perubahan
Tambahkan ulasan App Updates ke rilis atau rutinitas operasi mingguan.
Dokumentasi tampak basi setelah pembaruan
Gunakan Panduan Insinyur untuk memperbarui tangkapan layar dan langkah-langkahnya.
Apa yang harus dilakukan selanjutnya: Selalu perbarui dokumentasi publik seiring berkembangnya fitur.
13
Resep Pengembang
Hasilkan kunci API, gunakan autentikasi x-api-key, panggil titik akhir berbasis tindakan, jembatani dukungan langsung ke CRM, daftarkan webhook, verifikasi tanda tangan, dan sematkan widget dalam kode.
Pengaturan / PengembangAPI tombol, mulai cepat, dan usage tab
1Hasilkan dan cabut kunci API dari tab API Kunci.
2Gunakan Quick Start untuk contoh ikal pertama.
3Tinjau Penggunaan sebelum mengaktifkan otomatisasi volume tinggi.
API mulai cepat
Hasilkan kunci API dan lakukan panggilan API pertama
Untuk apa ini: Gunakan ini untuk skrip pelaporan, aplikasi khusus, jembatan CRM, dukungan langsung eksternal, atau otomatisasi.
Sebelum Anda mulai
Gunakan lingkungan sisi server. Jangan mengekspos kunci API di browser JavaScript.
Hasilkan kunci terpisah untuk setiap integrasi.
Salin kuncinya segera karena rahasia ditampilkan satu kali.
1
Buka Pengembang
Buka Pengaturan dan pilih Pengembang, atau gunakan pengalihan Pengembang jika tersedia.
Hasil yang diharapkan: API Tab Kunci, Quick Start, Dokumentasi, dan Penggunaan terlihat.
2
Hasilkan kunci
Klik Generate Key, beri label yang jelas, dan segera salin.
Hasil yang diharapkan: Kuncinya dimulai dengan sk_live_ dan tersedia untuk permintaan sisi server.
3
Kirim tajuk x-api-key
Sertakan x-api-key pada setiap permintaan API publik.
Hasil yang diharapkan: API publik dapat mengautentikasi permintaan dan memberikan cakupannya kepada pemilik.
4
Daftar bot
Panggil action=list-bots untuk menemukan ID bot yang Anda perlukan.
Hasil yang diharapkan: Responsnya mengembalikan ID bot, nama, status aktif, dan ringkasan konfigurasi.
5
Kirim pesan chat
POST tindakan chat dengan botId dan pesan.
Hasil yang diharapkan: Responsnya mengembalikan informasi balasan, model, dan usage.
6
Periksa usage
Panggil tindakan=usage sebelum menjalankan pekerjaan bervolume tinggi.
Hasil yang diharapkan: Anda mengetahui paket saat ini dan status usage sebelum otomatisasi berjalan.
7
Putar tombol bila diperlukan
Cabut kunci yang tidak digunakan dan buat kunci baru untuk vendor atau layanan yang diubah.
Hasil yang diharapkan: Layanan lama tidak dapat terus menggunakan kredensial lama.
Cara mengujinya: Jalankan list-bots dan chat dari terminal lokal atau lingkungan server, lalu konfirmasikan percakapan muncul di Chat History jika chat telah dikirim.
Masalah
Perbaiki
401 atau respons yang tidak sah
Periksa ejaan x-api-key, salin kunci lengkap, dan konfirmasikan bahwa kunci tersebut belum dicabut.
Bot tidak ditemukan
Gunakan list-bots lagi dan konfirmasikan bahwa bot tersebut milik pemilik kunci API.
Masalah CORS peramban
Pindahkan panggilan API ke backend Anda; Kunci API ditujukan untuk penggunaan sisi server.
Apa yang harus dilakukan selanjutnya: Gunakan /api-docs untuk referensi titik akhir terfokus dan jadikan halaman ini sebagai panduan alur kerja.
Daftar bot
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Kirim pesan chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Jembatan CRM dukungan langsung
Jajak pendapat atau dorong permintaan dukungan langsung ke CRM
Untuk apa ini: Gunakan ini ketika agen bekerja di sistem lain tetapi sem.chat menerima percakapan pengunjung.
Sebelum Anda mulai
Buat kunci API khusus yang diberi nama untuk jembatan CRM.
Putuskan apakah polling atau webhook sesuai dengan infrastruktur Anda.
Pastikan CRM menyimpan ID percakapan untuk balasan/resolusi di masa mendatang.
1
Daftar serah terima yang menunggu
GET tindakan=live-support-list dengan status=diminta atau status=semua.
Hasil yang diharapkan: CRM menerima conversations terbuka yang membutuhkan perhatian manusia.
2
Ambil pesan
GET tindakan=live-support-messages dengan conversationId.
Hasil yang diharapkan: CRM memiliki konteks thread lengkap dan detail pengunjung.
3
Klaim sebelum membalas
POST tindakan=live-support-claim.
Hasil yang diharapkan: sem.chat menandai percakapan sebagai ditangani secara aktif.
4
Kirim balasan agen
POST action=live-support-reply dengan conversationId, pesan, dan AgentName.
Hasil yang diharapkan: Pengunjung menerima balasan manusia dan pembaruan thread.
5
Putuskan atau kembalikan
POST tindakan=live-support-resolve dengan penyelesaian resolusi atau penyerahan kembali.
Hasil yang diharapkan: Percakapan meninggalkan antrian tunggu atau AI melanjutkan kendali.
6
Masuk status di CRM
Simpan status handoff terbaru, ID pesan, dan stempel waktu.
Hasil yang diharapkan: CRM dan sem.chat tetap dapat diaudit.
Cara mengujinya: Buat handoff yang aman, cerminkan ke CRM, balas dari bridge, dan konfirmasi pembaruan thread pengunjung.
Masalah
Perbaiki
Duplikat tiket CRM
Gunakan conversationId sebagai kunci idempotensi di jembatan CRM Anda.
Balasan datang tidak berurutan
Simpan stempel waktu pesan dan hindari balasan bersamaan dari beberapa sistem.
Balasan AI saat agen sedang bekerja
Klaim handoff terlebih dahulu dan baru serahkan kembali setelah agen selesai.
Apa yang harus dilakukan selanjutnya: Daftarkan webhook jika polling terlalu lambat atau terlalu mahal.
Webhook
Daftarkan webhook dan verifikasi X-SemChat-Signature
Untuk apa ini: Gunakan ini ketika sistem Anda memerlukan kejadian real-time untuk serah terima, pesan, dan pembaruan resolusi.
Sebelum Anda mulai
Webhook URL harus HTTPS dan dapat dijangkau dari internet publik.
Simpan rahasia webhook segera; itu ditampilkan sekali.
Verifikasi tanda tangan sebelum memproses acara.
1
Daftarkan webhook
POST tindakan webhook-register dengan url dan acara.
Hasil yang diharapkan: Responsnya mencakup detail webhook dan rahasia penandatanganan satu kali.
2
Simpan rahasianya
Simpan rahasia di lingkungan server atau manajer rahasia Anda.
Hasil yang diharapkan: Pengiriman di masa depan dapat diverifikasi.
3
Verifikasi tanda tangan
Baca X-SemChat-Signature dan bandingkan dengan HMAC SHA-256 pada isi permintaan mentah.
Hasil yang diharapkan: Hanya pengiriman sem.chat asli yang diterima.
4
Tangani percobaan ulang secara idempoten
Gunakan ID peristiwa atau ID percakapan/pesan untuk menghindari pemrosesan duplikat.
Hasil yang diharapkan: Percobaan ulang tidak membuat data CRM duplikat.
5
Daftar webhook
GET tindakan webhook-list untuk mengaudit titik akhir yang dikonfigurasi.
Hasil yang diharapkan: Anda dapat melihat URLs, peristiwa, status yang diaktifkan, dan status pengiriman terkini.
6
Hapus webhook yang sudah usang
POST tindakan webhook-delete dengan ID webhook.
Hasil yang diharapkan: Titik akhir lama berhenti menerima peristiwa.
Cara mengujinya: Daftarkan titik akhir pengujian, picu peristiwa dukungan langsung, verifikasi tanda tangan, dan konfirmasikan bahwa pengendali Anda mengembalikan 2xx.
Masalah
Perbaiki
Tanda tangan tidak cocok
Gunakan isi mentah, bukan JSON yang diuraikan, dan konfirmasikan rahasia webhook yang benar.
Webhook tidak menerima acara
Konfirmasikan bahwa daftar peristiwa mencakup peristiwa yang Anda uji dan titik akhirnya adalah HTTPS.
Waktu webhook habis
Akui dengan cepat dan proses pekerjaan panjang secara asinkron.
Apa yang harus dilakukan selanjutnya: Tautkan teknisi ke /api-docs untuk detail dan contoh titik akhir.
Untuk apa ini: Gunakan ini saat memilih tindakan yang tepat untuk suatu fitur.
Sebelum Anda mulai
Setiap permintaan menggunakan fungsi api publik yang sama URL.
Tindakan GET menggunakan parameter kueri. POST tindakan menggunakan JSON badan.
Kirim x-api-key untuk semua permintaan.
Cara mengujinya: Panggil usage dan list-bots sebagai tes asap setelah kunci API atau perubahan titik akhir.
Masalah
Perbaiki
Ketidakcocokan metode
Gunakan metode yang ditunjukkan pada tabel titik akhir. Beberapa tindakan hanya GET atau POST saja.
Nilai yang diperlukan tidak ada
Periksa botId, conversationId, id webhook, dan ejaan tindakan.
Apa yang harus dilakukan selanjutnya: Gunakan Quick Start untuk permintaan pertama, lalu /api-docs untuk referensi lengkap.
Metode
Tindakan
Tujuan
GET
list-bots
Cantumkan semua bot yang tersedia untuk pemilik kunci API.
GET
get-bot
Ambil satu konfigurasi bot berdasarkan ID bot.
POST
chat
Kirim pesan pengunjung ke bot dan kembalikan balasan AI.
GET
conversations
Cantumkan conversations terbaru untuk bot, hingga 100 catatan.
GET
usage
Paket pengembalian, kredit, jumlah bot, conversations, dan kunci API usage.
GET
live-support-list
Daftar conversations menunggu atau ditangani oleh agen manusia.
GET
live-support-messages
Ambil thread handoff dengan pesan dan info pengunjung.
POST
live-support-reply
Kirim balasan agen manusia dari sistem eksternal.
POST
live-support-claim
Klaim percakapan serah terima yang menunggu.
POST
live-support-resolve
Selesaikan handoff atau kembalikan kendali ke AI.
POST
webhook-register
Daftarkan titik akhir webhook HTTPS.
GET
webhook-list
Daftar pendaftaran webhook tanpa mengembalikan rahasia.
POST
webhook-delete
Hapus pendaftaran webhook berdasarkan ID.
14
Panduan Insinyur: Tambahkan Fitur
Tambahkan rute, navigasi dasbor, pengaturan pembuat bot, Supabase tabel/fungsi/migrasi, API dokumen, dokumentasi publik, pemeriksaan SEO, dan verifikasi lokal.
Alur kerja fitur aplikasi
Tambahkan rute aplikasi, halaman, item navigasi, dan entri dokumen
Untuk apa ini: Gunakan ini saat menambahkan fitur dasbor baru yang menghadap pelanggan.
Sebelum Anda mulai
Buat cabang sebelum mengedit.
Identifikasi apakah fitur tersebut termasuk dalam repo aplikasi atau repo frontend sem.chat publik.
Periksa rute, sidebar, i18n, dan pola pengaturan yang ada sebelum menambahkan struktur baru.
1
Tambahkan rute
Perbarui src/App.tsx dengan rute yang dilindungi untuk halaman pelanggan, atau rute publik hanya jika halaman tersebut harus bersifat publik.
Hasil yang diharapkan: URL diselesaikan di aplikasi tanpa menekan NotFound.
2
Membuat atau memperbarui komponen halaman
Gunakan pola halaman yang ada, pemuatan data, status kosong, status pemuatan, dan izin.
Hasil yang diharapkan: Fitur ini berperilaku konsisten dengan dasbor.
3
Tambahkan navigasi dasbor
Perbarui sidebar/sumber navigasi dengan label, ikon, rute, dan gerbang rencana jika diperlukan.
Hasil yang diharapkan: Pengguna dapat menemukan halaman baru dari shell aplikasi.
4
Tambahkan tab atau pengaturan pembuat bot
Jika fitur tersebut milik bot, tambahkan fitur tersebut ke dalam tab Bot Builder dan pertahankan melalui alur penyimpanan yang ada.
Hasil yang diharapkan: Konfigurasi khusus bot disimpan dengan bot, tidak terdampar di negara bagian lokal.
5
Tambahkan Supabase perubahan skema/fungsi
Buat migrasi untuk tabel/kebijakan dan fungsi edge untuk pekerjaan sisi server.
Hasil yang diharapkan: Perilaku basis data dan server dapat diterapkan berulang kali.
6
Perbarui bentuk API jika bersifat publik
Tambahkan atau perluas penanganan tindakan di supabase/functions/public-api/index.ts dan dokumentasikan perilaku x-api-key.
Hasil yang diharapkan: Integrasi dapat menggunakan fitur ini dengan aman.
7
Perbarui dokumen aplikasi dan dokumentasi publik
Perbarui dokumen pengembang dalam aplikasi dan halaman /dokumentasi ini dengan tangkapan layar dan langkah-langkah klik demi klik.
Hasil yang diharapkan: Pengguna dan teknisi melihat fitur tersebut di kedua tempat.
8
Jalankan pemeriksaan
Jalankan pengujian/pembangunan aplikasi, pengoptimal SEO di situs publik, pemeriksaan peta situs, dan verifikasi browser.
Hasil yang diharapkan: Fitur ini berfungsi secara lokal dan situs publik tetap dapat dirayapi.
Cara mengujinya: Buka rute baru, gunakan fitur ujung ke ujung, periksa kesalahan konsol/jaringan, dan verifikasi setiap perubahan database dari UI.
Masalah
Perbaiki
Rute berfungsi tetapi navigasi tidak menyorot
Periksa pencocokan rute sidebar dan jalur pengalihan.
Data berfungsi secara lokal tetapi tidak diterapkan
Konfirmasikan migrasi, kebijakan RLS, dan variabel lingkungan fungsi edge.
Dokumen publik hilang dari peta situs
Jalankan pengoptimal SEO dan periksa sitemap.xml untuk URL kanonik.
Apa yang harus dilakukan selanjutnya: Ambil atau buat ulang tangkapan layar dokumentasi setiap kali UI berubah.
Alur kerja pemeliharaan dokumen
Perbarui halaman dokumentasi publik ini setelah perubahan produk
Untuk apa ini: Gunakan ini saat tangkapan layar, alur kerja, perilaku API, atau navigasi berubah.
Sebelum Anda mulai
Gunakan hanya data demo yang aman.
Jangan pernah mengekspos pelanggan asli, email, detail pembayaran, kunci API, atau conversations pribadi.
Perbarui manual bahasa Inggris terlebih dahulu, lalu segarkan setiap halaman dokumentasi terlokalisasi sebelum pemeriksaan SEO.
1
Audit rute yang diubah
Buka rute aplikasi dan identifikasi apa yang berubah secara visual dan prosedural.
Hasil yang diharapkan: Anda tahu panduan, tangkapan layar, dan baris pemecahan masalah mana yang perlu diedit.
2
Tangkap atau buat tangkapan layar yang aman
Gunakan ruang kerja demo dan tutupi rahasia sebelum menyimpan aset WebP di bawah aset/dokumentasi.
Hasil yang diharapkan: Tangkapan layar akurat dan aman untuk dipublikasikan.
3
Perbarui panduannya
Edit bagian Untuk apa, Sebelum memulai, Langkah-langkah, Hasil yang diharapkan, Pengujian, Pemecahan Masalah, dan Berikutnya yang relevan.
Hasil yang diharapkan: Panduan ini memberi tahu pengguna apa yang harus diklik dan apa yang harus terjadi setelah setiap klik.
4
Perbarui navigasi jika diperlukan
Tambahkan bagian tersebut ke Daftar Isi yang melekat, pemilih bagian seluler, dan indeks visual jika itu adalah halaman utama.
Hasil yang diharapkan: Pembaca dapat menemukan konten baru dengan cepat.
5
Jalankan alat SEO
Jalankan alat simpul/seo-optimize-static-pages.js dan alat simpul/seo-optimize-static-pages.js --check.
Hasil yang diharapkan: Output kanonikal, metadata, peta situs, dan robot tetap benar.
6
Jalankan pembersihan dan pemeriksaan diff
Jalankan alat simpul/static-translation-cleanup.js --audit dan git diff --check.
Hasil yang diharapkan: Terjemahan statis dan spasi bersih.
7
Verifikasi peramban
Sajikan situs secara lokal dan uji/dokumentasi di desktop dan seluler.
Hasil yang diharapkan: Gambar dimuat, pencarian berfungsi, tombol salin berfungsi, sorotan TOC, dan tata letak tidak tumpang tindih dengan spanduk cookie.
Cara mengujinya: Cari nama fitur yang diubah di /dokumentasi dan konfirmasikan blok panduan yang benar muncul.
Masalah
Perbaiki
Penanda tangkapan layar melayang di perangkat seluler
Simpan penanda di dalam gambar tangkapan layar atau gunakan koordinat penanda responsif.
Pencarian melewatkan panduan baru
Tambahkan kata kunci yang berguna ke judul data dan sertakan istilah produk yang tepat yang dicari pengguna.
Dokumentasi terlokalisasi menjadi usang
Setelah mengedit manual bahasa Inggris, segarkan setiap halaman dokumentasi terlokalisasi, jalankan kembali pengoptimal SEO, dan pastikan sitemap.xml menyertakan setiap URL dokumentasi.
Apa yang harus dilakukan selanjutnya: Komit halaman dokumen, aset, tautan header/footer, .htaccess, dan perubahan peta situs secara bersamaan.
Butuh referensi API yang terfokus?
Halaman /api-docs yang lama tetap tersedia untuk detail API tingkat titik akhir.