Panduan visual langkah demi langkah

sem.chat dokumentasi

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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Email verifikasi tidak sampaiPeriksa spam, konfirmasi ejaan email, lalu minta email verifikasi lainnya.
Dasbor terbuka di PenagihanRuang 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 kerjaUndang 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.
MasalahPerbaiki
Kode semat tidak tersediaSimpan botnya dulu. Jika sinkronisasi suara masih tertunda, tunggu sinkronisasi atau simpan lagi setelah kolom yang wajib diisi selesai.
Widget menunjukkan bot yang salahKonfirmasikan data-bot-id dalam cuplikan cocok dengan ID bot dari modal Sematan.
Tidak ada percakapan yang muncul dalam riwayatRefresh 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Jawabannya terlalu umumTambahkan pengetahuan yang lebih spesifik dan tulis ulang instruksi dengan contoh jawaban yang baik.
Bot menolak pertanyaan yang harus dijawabnyaHapus instruksi yang terlalu ketat dan tambahkan pengetahuan tepercaya untuk topik tersebut.
Simpan tidak menghasilkan kode sematPeriksa 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.
MasalahPerbaiki
Jawaban lama masih munculSegarkan halaman situs web, konfirmasikan bahwa Anda menyimpan bot yang benar, dan periksa apakah pengetahuan yang diimpor memerlukan sinkronisasi.
Transfer gagalKonfirmasikan email penerima valid dan akun tujuan dapat menerima bot.
Hapus diklik secara tidak sengajaBerhenti 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Widgetnya hilangKonfirmasikan kode sebelum tag body penutup, skrip tidak diblokir oleh pembuat situs, dan bot aktif.
Bot yang salah munculSalin lagi cuplikannya dan bandingkan data-bot-id dengan bot yang diinginkan.
Widget tumpang tindih dengan kontrol halamanUbah posisi atau ukuran di Pengaturan Widget dan uji lagi di ponsel.

Apa yang harus dilakukan selanjutnya: Sesuaikan pengaturan widget dan pengambilan prospek setelah instalasi.

HTML menyematkan
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Pemasangan platform

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.
MasalahPerbaiki
React memuat widget duplikatJaga penyisipan skrip dengan ref atau render komponen hanya di tata letak root.
WordPress menghapus tag skripGunakan plugin injeksi footer atau file tema yang mengizinkan skrip.
SDK panggilan tidak dapat dimulaiPeriksa 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.

WordPress cuplikan kaki
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
komponen React
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Suara tingkat lanjut SDK
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Warna tidak diperbaruiSimpan bot, segarkan situs web, dan konfirmasikan widget yang dipasang menggunakan ID bot yang sama.
Bidang prospek tidak adaKonfirmasikan pengambilan prospek diaktifkan dan kondisi pemicu yang dipilih terpenuhi.
Pengunjung tidak dapat menggunakan suaraPeriksa 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Browser memblokir mikrofonIzinkan izin mikrofon di browser dan muat ulang halaman.
Opsi suara terkunciBuka Penagihan dan konfirmasikan paket ruang kerja menyertakan fitur suara.
Transkrip kosongKonfirmasikan 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.
MasalahPerbaiki
Kualitas klon burukRekam sampel yang lebih bersih dengan satu speaker, volume stabil, dan tanpa musik.
Unggahan avatar khusus tidak tersediaPeriksa Penagihan untuk mengetahui batas avatar yang dibatasi paket.
Suara lama masih terdengarSimpan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Crawler mengimpor halaman yang tidak relevanHapus halaman tersebut dari hasil yang dipilih dan tambahkan instruksi manual yang lebih jelas.
Harga produk sudah basiSegarkan feed dan konfirmasikan feed URL itu sendiri berisi nilai saat ini.
Bot membuat jawabanTambahkan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Balasan gagal dikirimPeriksa status jaringan, status percakapan, dan apakah dukungan langsung telah diklaim.
Bahasa pengunjung salahGunakan terjemahan atau perbarui pengaturan bahasa bot sebelum membalas.
Percakapan tidak ada di Kotak MasukCari 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.
MasalahPerbaiki
Agen melewatkan permintaanAktifkan pemberitahuan browser/email/push dan tambahkan proses untuk kepemilikan antrean.
AI terus mengambil alih terlalu cepatSesuaikan instruksi dan aturan serah terima sehingga kendali manusia tetap aktif hingga diselesaikan atau diserahkan kembali.
CRM eksternal tidak sinkronGunakan 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.
MasalahPerbaiki
Kontak hilang dari KontakKonfirmasikan pengambilan prospek diaktifkan dan pengunjung mengirimkan formulir.
Ekspor terlalu besarPersempit rentang tanggal atau filter bot sebelum mengekspor.
Sinkronisasi SendPulse tidak tersediaHubungkan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Token Telegram gagalBuat atau setel ulang token di Botfather dan tempelkan lagi.
Slack pesan tidak sampaiPeriksa cakupan aplikasi, langganan acara URL, token bot, rahasia penandatanganan, dan keanggotaan saluran.
Koneksi saluran meta gagalKonfirmasikan bahwa akun Facebook/Instagram/WhatsApp memiliki izin admin dan memerlukan akses bisnis.
Sinkronisasi SendPulse gagalHubungkan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
1Masukkan nama, deskripsi, durasi, lokasi, dan buffer.
2Tetapkan ketersediaan, jangka waktu pemesanan, pertanyaan, opsi acara berbayar, dan aturan pembatalan.
3Simpan acara sebelum membagikan tautannya.
/buku/:nama pengguna/:eventSlugHalaman pemesanan publik
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Tidak ada waktu yang muncul di halaman publikPeriksa zona waktu, ketersediaan mingguan, penggantian tanggal, jendela pemberitahuan, dan konflik kalender yang terhubung.
Email pemesanan hilangPeriksa pengaturan email dan folder spam, lalu kirim pemesanan tes lainnya.
Pembayaran gagal pada acara berbayarKonfirmasikan 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.
MasalahPerbaiki
Tautan satu kali memperlihatkan slot yang salahBuat ulang tautan dengan kumpulan slot yang lebih kecil atau rentang tanggal yang lebih ketat.
Pemesanan tertanam terlalu sempitTempatkan penyematan dalam wadah konten yang lebih luas dan periksa tata letak seluler.
Analytics terlihat kosongBuat 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
1Pilih rentang tanggal atau tanggal khusus.
2Baca metrik percakapan, kepuasan, bahasa, saluran, dan konversi.
3Ekspor CSV untuk analisis offline.
Pengaturan / LaporanPengaturan laporan email
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Metrik tampaknya terlalu tinggiPeriksa apakah pementasan/pengujian conversations disertakan dalam rentang tanggal yang dipilih.
Kepuasan itu kosongAktifkan peringkat di Pengaturan Widget dan tunggu pengunjung memberikan peringkat.
Notulen suara tidak sesuai ekspektasiKonfirmasikan 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.
MasalahPerbaiki
Email laporan tidak sampaiPeriksa ejaan penerima, folder spam, dan status riwayat laporan.
Orang yang salah menerima laporanPerbarui penerima dan simpan sebelum jadwal pengiriman berikutnya.
Konten laporan terasa berisikSesuaikan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
2

Bandingkan rencana

Tinjau chat, suara, tim, API, avatar, integrasi, penjadwalan, dan batas dukungan.

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.
MasalahPerbaiki
Fitur tetap terkunci setelah peningkatanRefresh aplikasi, tunggu sebentar untuk sinkronisasi langganan, lalu periksa kembali Penagihan.
Pembayaran dibatalkanKembali ke Penagihan dan mulai checkout lagi; tidak ada perubahan paket yang terjadi setelah pembayaran dibatalkan.
Perlu faktur atau perubahan kartuBuka 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.
MasalahPerbaiki
Email undangan tidak adaPeriksa spam, kirim ulang undangan, dan verifikasi alamat.
Rekan satu tim melihat terlalu banyakTurunkan perannya dan tinjau pengaturan akses bot.
Pengaturan 2FA gagalPeriksa 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.
MasalahPerbaiki
Tautan rujukan tidak adaBergabunglah dengan program ini terlebih dahulu atau segarkan halaman afiliasi setelah bergabung.
Permintaan pembayaran tidak tersediaPeriksa ambang pembayaran minimum, status komisi yang memenuhi syarat, dan email pembayaran.
Rujukan tidak diatribusikanKonfirmasikan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
Tidak ada pemberitahuan yang masukPeriksa preferensi pemberitahuan Pengaturan, izin browser, dan apakah peristiwa tersebut benar-benar terjadi.
Terlalu banyak peringatanNonaktifkan kategori yang berisik atau kirimkan hanya ke anggota tim yang bertanggung jawab.
Hitungan yang belum dibaca sepertinya terhentiSegarkan 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.
3

Petakan perubahan pada alur kerja Anda

Identifikasi apakah pembaruan memengaruhi bot, widget, dukungan, penjadwalan, penagihan, atau pengembang.

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.
MasalahPerbaiki
Pembaruan menyebutkan fitur terkunciBuka Penagihan untuk mengonfirmasi apakah paket saat ini menyertakannya.
Tim melewatkan perubahanTambahkan ulasan App Updates ke rilis atau rutinitas operasi mingguan.
Dokumentasi tampak basi setelah pembaruanGunakan 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
Tangkapan layar nyata dari ruang kerja demo sem.chat
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.
MasalahPerbaiki
401 atau respons yang tidak sahPeriksa ejaan x-api-key, salin kunci lengkap, dan konfirmasikan bahwa kunci tersebut belum dicabut.
Bot tidak ditemukanGunakan list-bots lagi dan konfirmasikan bahwa bot tersebut milik pemilik kunci API.
Masalah CORS perambanPindahkan 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.
MasalahPerbaiki
Duplikat tiket CRMGunakan conversationId sebagai kunci idempotensi di jembatan CRM Anda.
Balasan datang tidak berurutanSimpan stempel waktu pesan dan hindari balasan bersamaan dari beberapa sistem.
Balasan AI saat agen sedang bekerjaKlaim 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.
MasalahPerbaiki
Tanda tangan tidak cocokGunakan isi mentah, bukan JSON yang diuraikan, dan konfirmasikan rahasia webhook yang benar.
Webhook tidak menerima acaraKonfirmasikan bahwa daftar peristiwa mencakup peristiwa yang Anda uji dan titik akhirnya adalah HTTPS.
Waktu webhook habisAkui dengan cepat dan proses pekerjaan panjang secara asinkron.

Apa yang harus dilakukan selanjutnya: Tautkan teknisi ke /api-docs untuk detail dan contoh titik akhir.

Daftarkan webhook
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": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Verifikasi tanda tangan webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Peta titik akhir

Gunakan API publik berbasis tindakan dengan benar

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.
MasalahPerbaiki
Ketidakcocokan metodeGunakan metode yang ditunjukkan pada tabel titik akhir. Beberapa tindakan hanya GET atau POST saja.
Nilai yang diperlukan tidak adaPeriksa botId, conversationId, id webhook, dan ejaan tindakan.

Apa yang harus dilakukan selanjutnya: Gunakan Quick Start untuk permintaan pertama, lalu /api-docs untuk referensi lengkap.

MetodeTindakanTujuan
GETlist-botsCantumkan semua bot yang tersedia untuk pemilik kunci API.
GETget-botAmbil satu konfigurasi bot berdasarkan ID bot.
POSTchatKirim pesan pengunjung ke bot dan kembalikan balasan AI.
GETconversationsCantumkan conversations terbaru untuk bot, hingga 100 catatan.
GETusagePaket pengembalian, kredit, jumlah bot, conversations, dan kunci API usage.
GETlive-support-listDaftar conversations menunggu atau ditangani oleh agen manusia.
GETlive-support-messagesAmbil thread handoff dengan pesan dan info pengunjung.
POSTlive-support-replyKirim balasan agen manusia dari sistem eksternal.
POSTlive-support-claimKlaim percakapan serah terima yang menunggu.
POSTlive-support-resolveSelesaikan handoff atau kembalikan kendali ke AI.
POSTwebhook-registerDaftarkan titik akhir webhook HTTPS.
GETwebhook-listDaftar pendaftaran webhook tanpa mengembalikan rahasia.
POSTwebhook-deleteHapus 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.
MasalahPerbaiki
Rute berfungsi tetapi navigasi tidak menyorotPeriksa pencocokan rute sidebar dan jalur pengalihan.
Data berfungsi secara lokal tetapi tidak diterapkanKonfirmasikan migrasi, kebijakan RLS, dan variabel lingkungan fungsi edge.
Dokumen publik hilang dari peta situsJalankan 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.
MasalahPerbaiki
Penanda tangkapan layar melayang di perangkat selulerSimpan penanda di dalam gambar tangkapan layar atau gunakan koordinat penanda responsif.
Pencarian melewatkan panduan baruTambahkan kata kunci yang berguna ke judul data dan sertakan istilah produk yang tepat yang dicari pengguna.
Dokumentasi terlokalisasi menjadi usangSetelah 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.

Buka API Dokumen