Manual SEMJAT yang disokong tangkapan skrin yang dibina daripada aliran papan pemuka sem.chat sebenar. Setiap panduan memberitahu anda perkara yang perlu diklik, perkara yang perlu berlaku selepas klik, cara mengujinya, cara menyelesaikan masalah dan perkara yang perlu dilakukan seterusnya.
Tiada panduan yang sepadan ditemui. Cuba kata kunci yang lebih pendek seperti widget, API, suara, pengebilan, webhook, WordPress, SendPulse atau penjadualan.
Nota tangkapan skrin: setiap imej dalam manual ini ditangkap daripada aplikasi sem.chat sebenar menggunakan ruang kerja demo. Butiran akaun sensitif, data pelanggan, kunci API, butiran pembayaran dan kandungan perbualan peribadi disamarkan sebelum diterbitkan.
01
Bermula
Buat akaun, selesaikan onboarding, fahami papan pemuka, buat bot pertama, uji secara peribadi, pasang dan pilih pelan yang betul.
/authDaftar, percubaan dan bot pertama
1Mulakan dengan Daftar atau Log Masuk daripada tapak atau apl awam.
2Sahkan alamat e-mel sebelum bergantung pada pemberitahuan atau mesej pengebilan.
3Gunakan onboarding untuk membuat bot pertama sebelum membuka papan pemuka.
/ gambaran keseluruhanGambaran keseluruhan selepas log masuk
1Gunakan tindakan pantas untuk membuat bot, melihat bot, membuka analitis atau mengurus pengebilan.
2Semak bot aktif, conversations, minit suara dan kepuasan sebelum membuat perubahan.
3Semak aktiviti terkini selepas setiap ujian persediaan.
Pelancaran pertama
Daftar, mulakan percubaan dan fahami papan pemuka
Untuk apa ini: Gunakan aliran kerja ini untuk ruang kerja yang serba baharu atau apabila menyertai rakan sepasukan yang tidak pernah menggunakan sem.chat.
Sebelum anda bermula
Gunakan e-mel perniagaan yang boleh menerima e-mel pengesahan dan pengebilan.
Tentukan siapa yang harus memiliki ruang kerja sebelum menjemput seluruh pasukan.
Simpan tapak web ujian selamat atau halaman pementasan sedia untuk pemasangan widget.
1
Buka halaman pendaftaran apl
Pergi ke app.sem.chat/auth daripada butang Log Masuk / Daftar tapak web.
Hasil yang dijangkakan: Halaman pengesahan menunjukkan pilihan log masuk dan penciptaan akaun.
2
Buat akaun
Masukkan e-mel perniagaan, buat kata laluan dan serahkan borang pendaftaran.
Hasil yang dijangkakan: Apl meminta pengesahan atau beralih ke onboarding selepas akaun diterima.
3
Sahkan e-mel
Buka e-mel pengesahan dan klik pautan pengesahan.
Hasil yang dijangkakan: Akaun boleh menerima pengebilan, jemputan, laporan dan mesej makluman.
4
Penyertaan lengkap
Masukkan nama perniagaan, huraikan matlamat pembantu, pilih warna permulaan dan buat bot pertama.
Hasil yang dijangkakan: Ruang kerja dibuka dengan draf bot dan keadaan percubaan aktif.
5
Buka Gambaran Keseluruhan
Klik Gambaran Keseluruhan di bar sisi kiri.
Hasil yang dijangkakan: Papan pemuka menunjukkan usage kad, tindakan pantas dan aktiviti terkini.
6
Pilih tindakan seterusnya
Gunakan Cipta Bot Baharu untuk persediaan, Lihat Semua Bot untuk pengurusan, Analitis untuk prestasi atau Pengebilan untuk had pelan.
Hasil yang dijangkakan: Anda tahu tempat untuk meneruskan berdasarkan keadaan ruang kerja.
Cara mengujinya: Buat satu bot ujian peribadi dan hantar mesej ujian sebelum menjemput rakan sepasukan. Sahkan perubahan aktiviti Gambaran keseluruhan selepas ujian.
Masalah
Betulkan
E-mel pengesahan tidak sampai
Semak spam, sahkan ejaan e-mel, kemudian minta e-mel pengesahan lain.
Papan pemuka dibuka pada Pengebilan
Ruang kerja mungkin memerlukan percubaan atau pelan aktif. Mulakan percubaan atau pilih pelan yang betul sebelum persediaan.
Rakan sepasukan tidak boleh mengakses ruang kerja
Jemput mereka daripada Tetapan, Pasukan dan bukannya berkongsi log masuk pemilik.
Perkara yang perlu dilakukan seterusnya: Buat bot pertama, uji secara peribadi, kemudian pasang widget pada halaman pementasan.
Ujian pelancaran persendirian
Buat ujian bot peribadi pertama sebelum disiarkan secara langsung
Untuk apa ini: Gunakan ini untuk mengesahkan penjejakan akaun, bot, widget dan sejarah sebelum pelanggan melihat pembantu.
Sebelum anda bermula
Sediakan satu contoh soalan pelanggan.
Sediakan halaman pementasan atau halaman ujian HTML tempatan.
Jangan gunakan data pelanggan sebenar dalam ujian pertama.
1
Buka My Bots
Klik My Bots dalam bar sisi atau gunakan Lihat Semua Bot daripada Gambaran Keseluruhan.
Hasil yang dijangkakan: Anda boleh melihat bot yang dibuat semasa onboarding atau keadaan kosong dengan butang Bot Baharu.
2
Buka pembina bot
Klik Bot Baharu atau Edit pada bot sedia ada.
Hasil yang dijangkakan: Bot Builder dibuka dengan Asas, Widget, Pengetahuan, Suara dan kawalan penyepaduan.
3
Simpan bot sekali
Isikan nama bot yang diperlukan dan mesej pertama, kemudian klik Simpan.
Hasil yang dijangkakan: Bot menerima ID yang sah dan boleh menjana kod benam.
4
Pratonton secara peribadi
Gunakan panel pratonton dan tanyakan contoh soalan anda.
Hasil yang dijangkakan: Jawapannya harus sepadan dengan arahan anda atau mendedahkan pengetahuan yang hilang.
5
Pasang pada pementasan
Buka Benam, salin coretan HTML dan tampalkannya sebelum teg badan penutup pada halaman pementasan.
Hasil yang dijangkakan: Widget muncul di sudut yang dikonfigurasikan pada desktop dan mudah alih.
6
Sahkan penjejakan
Buka Peti Masuk atau Chat History selepas perbualan ujian.
Hasil yang dijangkakan: Perbualan ujian muncul dengan bot, saluran dan sejarah mesej yang betul.
Cara mengujinya: Hantar satu mesej teks dan satu ujian suara jika suara didayakan. Sahkan kedua-duanya muncul dalam Chat History.
Masalah
Betulkan
Kod benam tidak tersedia
Simpan bot dahulu. Jika penyegerakan suara masih belum selesai, tunggu penyegerakan atau simpan semula selepas medan yang diperlukan selesai.
Widget menunjukkan bot yang salah
Sahkan data-bot-id dalam coretan sepadan dengan ID bot daripada modal Benam.
Tiada perbualan muncul dalam sejarah
Muat semula Chat History, sahkan bot aktif dan pastikan ujian berlaku pada widget yang dipasang, bukan halaman lapuk.
Perkara yang perlu dilakukan seterusnya: Teruskan ke Bot Builder persediaan dan latihan pengetahuan.
02
Buat Dan Konfigurasi Bot
Bina, edit, pratonton, aktifkan, pindahkan atau alih keluar bot daripada My Bots dan Bot Builder.
/papan pemukaMy Bots pusat kawalan
1Klik Bot Baharu untuk memulakan pembantu baharu.
2Gunakan Edit, Benamkan, Pindahkan, Aktifkan atau Padam pada setiap kad bot.
3Semak keadaan aktif dan masa dikemas kini terakhir sebelum ujian.
/bots/:id/editBot Builder tab asas
1Isikan nama bot, avatar, mesej pertama dan arahan sistem.
2Gunakan Pratonton untuk menguji sebelum menerbitkan.
3Simpan dan segerakkan sebelum menyalin kod benam.
Buat bot
Buat bot baharu daripada My Bots
Untuk apa ini: Gunakan aliran kerja ini apabila jenama, tapak web, baris gilir sokongan atau kempen baharu memerlukan pembantunya sendiri.
Sebelum anda bermula
Sediakan nama bot, matlamat, mesej pertama dan dua atau tiga contoh soalan.
Kumpulkan tapak web awam URL jika anda bercadang untuk mengimport kandungan.
Sahkan pelan membenarkan bilangan bot dan ciri suara/avatar yang anda perlukan.
1
Buka My Bots
Klik My Bots dalam bar sisi.
Hasil yang dijangkakan: Bot sedia ada dan butang Bot Baharu kelihatan.
2
Klik Bot Baru
Mulakan bot baharu dari halaman My Bots.
Hasil yang dijangkakan: Bot Builder dibuka dengan pembantu draf.
3
Tetapkan identiti bot
Masukkan Nama Bot, muat naik atau pilih avatar, dan tulis mesej pertama yang akan dilihat oleh pelawat.
Hasil yang dijangkakan: Panel pratonton mencerminkan nama pembantu, avatar dan sapaan.
4
Tulis arahan sistem
Terangkan perkara yang patut dilakukan oleh bot, bagaimana ia harus bercakap, perkara yang harus dielakkan dan bila ia harus meminta bantuan manusia.
Hasil yang dijangkakan: Pembantu mempunyai peraturan tingkah laku yang jelas sebelum pengetahuan ditambah.
5
Tambah pengetahuan asas
Tampalkan maklumat penting syarikat, produk, sokongan, harga dan hubungan ke dalam bidang pengetahuan.
Hasil yang dijangkakan: Bot boleh menjawab soalan biasa tanpa perlu mengimport tapak web lagi.
6
Simpan bot
Klik Simpan dan tunggu pengesahan yang disimpan atau disegerakkan.
Hasil yang dijangkakan: Bot mempunyai ID yang stabil, pratonton boleh diuji dan pilihan benam tersedia.
7
Pratonton keputusan
Tanya contoh soalan yang disediakan dalam Pratonton.
Hasil yang dijangkakan: Jawapan hendaklah mengikut arahan dan menggunakan pengetahuan yang anda masukkan.
8
Aktifkan hanya apabila sedia
Hidupkan bot aktif selepas ujian peribadi lulus.
Hasil yang dijangkakan: Bot sedia untuk widget atau trafik saluran.
Cara mengujinya: Tanya sekurang-kurangnya lima soalan yang realistik. Semak sama ada jawapan itu betul, sama ada ia kekal pada jenama dan sama ada ia meminta bantuan manusia apabila diperlukan.
Masalah
Betulkan
Jawapannya terlalu generik
Tambah pengetahuan yang lebih khusus dan tulis semula arahan dengan contoh jawapan yang baik.
Bot itu menolak soalan yang patut dijawabnya
Alih keluar arahan yang terlalu ketat dan tambahkan pengetahuan yang dipercayai untuk topik itu.
Simpan tidak menjana kod benam
Semak medan yang diperlukan dan simpan semula selepas penyegerakan pembekal suara selesai.
Perkara yang perlu dilakukan seterusnya: Konfigurasikan tetapan widget, tambah pengetahuan tapak web, kemudian pasang bot.
Urus bot
Edit, klon aliran kerja, pindahkan, nyahaktifkan atau padam bot
Untuk apa ini: Gunakan aliran kerja ini apabila bot memerlukan kemas kini, perubahan pemilikan, jeda sementara atau pengalihan keluar kekal.
Sebelum anda bermula
Eksport sebarang perbualan atau data kenalan yang anda mesti simpan sebelum memadamkan bot.
Sahkan bot tidak dibenamkan pada tapak web langsung sebelum memadam atau memindahkannya.
Beritahu rakan sepasukan sebelum menyahaktifkan bot pengeluaran.
1
Buka My Bots
Cari kad bot mengikut nama atau status.
Hasil yang dijangkakan: Kad menunjukkan keadaan semasa dan tindakan yang tersedia.
2
Klik Edit
Buka pembina bot dan buat perubahan yang diperlukan.
Hasil yang dijangkakan: Editor memuatkan konfigurasi semasa.
3
Simpan dan uji semula
Klik Simpan selepas setiap perubahan bahan, kemudian jalankan soalan pratonton.
Hasil yang dijangkakan: Konfigurasi yang disimpan digunakan oleh pratonton dan widget yang dipasang.
4
Nyahaktifkan buat sementara waktu
Gunakan togol aktif jika bot sepatutnya berhenti mengendalikan pelawat buat masa ini.
Hasil yang dijangkakan: Bot berhenti menyediakan trafik langsung sambil mengekalkan konfigurasi.
5
Memindahkan pemilikan
Gunakan Pemindahan, masukkan e-mel penerima dan sahkan.
Hasil yang dijangkakan: Akaun yang dipilih menerima pemilikan mengikut aliran pemindahan apl.
6
Padam hanya selepas semakan
Gunakan Padam, baca amaran dan sahkan hanya apabila bot tidak diperlukan lagi.
Hasil yang dijangkakan: Bot dan konfigurasi yang berkaitan dialih keluar mengikut amaran.
Cara mengujinya: Selepas mengedit, buka widget yang dipasang dan tanya soalan tepat yang mendorong perubahan itu. Sahkan jawapan langsung telah berubah.
Masalah
Betulkan
Jawapan lama masih muncul
Muat semula halaman tapak web, sahkan anda menyimpan bot yang betul dan semak sama ada pengetahuan yang diimport memerlukan penyegerakan.
Pemindahan gagal
Sahkan e-mel penerima adalah sah dan akaun destinasi boleh menerima bot.
Padam tersalah klik
Berhenti sebelum pengesahan akhir. Amaran pemadaman wujud kerana tindakan itu boleh mengalih keluar data bot secara kekal.
Perkara yang perlu dilakukan seterusnya: Semak analitis dan sejarah selepas perubahan langsung untuk memastikan pengalaman pelawat bertambah baik.
03
Pasang Widget
Salin kod benam yang betul, pasangkannya dalam konteks HTML, WordPress, React atau SDK lanjutan, kemudian sahkan kelakuan desktop dan mudah alih.
Benamkan modalSalin coretan pemasangan tapak web
1Pilih HTML, WordPress, React atau NPM/SDK berdasarkan susunan tapak.
2Salin kod selepas bot disimpan dan disegerakkan.
3Tampalkan coretan sebelum teg isi penutup atau dalam reka letak rangka kerja.
HTML pasang
Pasang widget pada tapak web HTML standard
Untuk apa ini: Gunakan ini apabila anda boleh mengedit templat halaman, pengaki tema atau reka letak HTML global.
Sebelum anda bermula
Simpan bot dahulu supaya modal benam mempunyai ID bot sebenar.
Gunakan tapak pementasan sebelum pengeluaran.
Simpan versi skrip yang tepat dan data-bot-id daripada modal.
1
Buka My Bots
Cari bot yang ingin anda pasang dan klik Benamkan.
Hasil yang dijangkakan: Modus Benam dibuka dengan tab pemasangan.
2
Pilih HTML
Pilih tab HTML dan klik Salin Kod.
Hasil yang dijangkakan: Skrip widget disalin dengan ID bot yang dilampirkan.
3
Buka templat tapak web
Edit fail pengaki atau susun atur global yang dipaparkan pada setiap halaman tempat widget sepatutnya dipaparkan.
Hasil yang dijangkakan: Anda sedang mengedit cangkerang tapak kongsi, bukan satu halaman terpencil melainkan ia disengajakan.
4
Tampal sebelum menutup badan
Tampalkan coretan sejurus sebelum teg badan penutup.
Hasil yang dijangkakan: Skrip dimuatkan selepas kandungan halaman dan boleh melekapkan bekas widget.
5
Terbitkan atau gunakan
Simpan templat dan gunakan tapak.
Hasil yang dijangkakan: Skrip widget disiarkan secara langsung pada halaman sasaran.
6
Uji desktop dan mudah alih
Buka tapak dalam tetingkap penyemak imbas baharu dan pada port pandangan mudah alih.
Hasil yang dijangkakan: Widget muncul dalam kedudukan yang dikonfigurasikan dan dibuka tanpa ralat konsol.
Cara mengujinya: Hantar mesej daripada halaman langsung, kemudian buka Peti Masuk dan Chat History untuk mengesahkan perbualan itu milik bot yang betul.
Masalah
Betulkan
Widget tiada
Sahkan kod sebelum teg isi penutup, skrip tidak disekat oleh pembina tapak dan bot aktif.
Bot yang salah muncul
Salin coretan sekali lagi dan bandingkan data-bot-id dengan bot yang dikehendaki.
Kawalan halaman bertindih widget
Tukar kedudukan atau saiz dalam Tetapan Widget dan uji sekali lagi pada mudah alih.
Perkara yang perlu dilakukan seterusnya: Tala tetapan widget dan tangkapan petunjuk selepas pemasangan.
Pasang dalam aliran WordPress, React atau suara lanjutan SDK
Untuk apa ini: Gunakan ini apabila tapak web diurus oleh CMS, apl React atau penyepaduan suara tersuai.
Sebelum anda bermula
Ketahui timbunan yang memiliki reka letak yang dikongsi.
Gunakan coretan tepat yang ditunjukkan dalam sem.chat untuk bot yang dipilih.
Untuk penggunaan SDK lanjutan, sahkan anda mempunyai Vapi kunci awam dan ID pembantu yang diperlukan.
1
WordPress pilihan
Gunakan Penampilan, Editor Tema, footer.php atau pemalam pengepala dan pengaki yang dipercayai.
Hasil yang dijangkakan: Coretan dimuatkan pada halaman WordPress awam.
2
React pilihan
Buat komponen ChatWidget kecil, tambahkan skrip dalam useEffect, dan jadikannya dalam reka letak akar.
Hasil yang dijangkakan: Widget dimuatkan sekali dan dibersihkan jika susun atur dinyahlekap.
3
Pilihan SDK lanjutan
Gunakan tab NPM/SDK hanya apabila anda memerlukan kawalan panggilan suara tersuai di luar widget lalai.
Hasil yang dijangkakan: Apl anda mengawal sesi suara manakala sem.chat kekal sebagai sumber pembantu yang dikonfigurasikan.
4
Sahkan ID bot
Sahkan kod yang dipasang merujuk kepada ID bot daripada modal Benam.
Hasil yang dijangkakan: Widget langsung bersambung kepada pembantu yang dimaksudkan.
5
Periksa konsol
Buka alat pembangun penyemak imbas dan muat semula.
Hasil yang dijangkakan: Tiada skrip yang disekat, bekas pendua atau ralat rangkaian.
Cara mengujinya: Lengkapkan satu mesej ujian daripada tapak yang dipasang, kemudian sahkan ia muncul dalam Peti Masuk dengan halaman yang dijangkakan URL.
Masalah
Betulkan
React memuatkan widget pendua
Pengawal sisipan skrip dengan ref atau jadikan komponen hanya dalam reka letak akar.
WordPress menanggalkan tag skrip
Gunakan pemalam suntikan pengaki atau fail tema yang membenarkan skrip.
SDK panggilan tidak boleh dimulakan
Semak kunci awam, ID pembantu, kebenaran penyemak imbas dan rancangan akses untuk suara.
Perkara yang perlu dilakukan seterusnya: Beralih ke Tetapan Widget untuk mengawal tingkah laku, penjenamaan dan tangkapan petunjuk.
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
Tetapan Widget
Konfigurasikan mod, tema, saiz, kedudukan, warna, penjenamaan, reaksi, bunyi, persetujuan, tangkapan petunjuk, penilaian, e-mel susulan dan keadaan pengaktifan.
Bot Builder / WidgetPenampilan widget dan tingkah laku pelawat
1Pilih chat, suara atau mod hibrid.
2Tetapkan tema, warna, kedudukan, saiz, penjenamaan, persetujuan dan bunyi.
3Konfigurasikan penangkapan petunjuk, penilaian, tindak balas dan tingkah laku susulan.
Tingkah laku widget
Konfigurasikan tingkah laku widget yang menghadap pelawat
Untuk apa ini: Gunakan ini selepas pemasangan pertama atau bila-bila masa widget perlu sepadan dengan tapak web dan menangkap petunjuk yang lebih baik.
Sebelum anda bermula
Pasang widget pada halaman pementasan.
Ketahui sama ada pelawat harus bermula dengan chat, suara atau kedua-duanya.
Sediakan salinan kebenaran dan tangkapan petunjuk jika diperlukan untuk wilayah tersebut.
1
Buka pembina bot
Buka My Bots, klik Edit, kemudian pilih tab Widget.
Hasil yang dijangkakan: Kawalan widget muncul untuk bot yang dipilih.
2
Pilih mod
Pilih Sembang, Suara atau Hibrid berdasarkan pengalaman pelawat yang anda inginkan.
Hasil yang dijangkakan: Pratonton berubah untuk menunjukkan mod yang dipilih.
3
Tetapkan penampilan
Pilih tema, warna, saiz, kedudukan butang dan pilihan penjenamaan.
Hasil yang dijangkakan: Widget sepadan dengan tapak tanpa meliputi kandungan penting.
4
Dayakan kawalan pelawat
Hidupkan atau matikan reaksi, bunyi, penilaian dan gesaan persetujuan.
Hasil yang dijangkakan: Pelawat hanya melihat kawalan yang anda mahu mereka gunakan.
5
Konfigurasikan penangkapan petunjuk
Pilih medan yang diperlukan, medan penerangan pilihan dan apabila borang muncul.
Hasil yang dijangkakan: Kenalan dikumpulkan sebelum atau semasa conversations mengikut persediaan anda.
6
Tetapkan e-mel susulan
Konfigurasikan tingkah laku e-mel susulan jika rancangan anda menyertakannya.
Hasil yang dijangkakan: Pelawat boleh menerima mesej susulan selepas diselesaikan conversations.
7
Simpan dan uji
Klik Simpan, muat semula halaman pementasan dan buka widget.
Hasil yang dijangkakan: Widget langsung sepadan dengan tetapan yang disimpan.
Cara mengujinya: Buka widget pada desktop dan mudah alih, serahkan borang petunjuk, tinggalkan penilaian dan sahkan kenalan dan perbualan direkodkan.
Masalah
Betulkan
Warna tidak dikemas kini
Simpan bot, muat semula tapak web dan sahkan widget yang dipasang menggunakan ID bot yang sama.
Medan petunjuk tiada
Sahkan penangkapan petunjuk didayakan dan syarat pencetus yang dipilih dipenuhi.
Pelawat tidak boleh menggunakan suara
Semak tetapan Suara, kebenaran mikrofon penyemak imbas, akses pelan dan had minit suara.
Perkara yang perlu dilakukan seterusnya: Tambahkan tetapan suara/avatar dan sumber pengetahuan sebelum pelancaran pengeluaran.
05
Suara Dan Avatar
Pilih suara stok, konfigurasikan mod dan had suara, baca transkrip, klon suara, tetapkan suara klon dan urus stok atau avatar tersuai.
Bot Builder / SuaraSuara, had, transkrip dan avatar
1Pilih suara saham atau suara klon yang disimpan.
2Tetapkan had minit suara dan penjimatan transkrip.
3Pilih avatar saham atau muat naik avatar tersuai jika pelan membenarkannya.
Persediaan suara
Sediakan panggilan suara dan transkrip
Untuk apa ini: Gunakan ini apabila pelawat harus bercakap dengan bot dan bukannya hanya menaip.
Sebelum anda bermula
Sahkan rancangan termasuk minit suara dan pilihan suara/avatar yang diingini.
Gunakan persekitaran penyemak imbas yang tenang untuk ujian.
Sediakan satu soalan sokongan atau jualan yang realistik untuk diuji melalui suara.
1
Buka tetapan Suara
Buka pembina bot dan pilih kawasan Suara atau Suara dan Avatar.
Hasil yang dijangkakan: Kawalan suara dan pemilihan suara semasa kelihatan.
2
Pilih suara saham
Pratonton suara yang tersedia, pilih yang paling sesuai dan simpan pilihan.
Hasil yang dijangkakan: Bot menggunakan suara yang dipilih untuk panggilan.
3
Konfigurasikan mod suara
Gunakan Tetapan Widget untuk memilih Suara atau Hibrid apabila suara seharusnya tersedia kepada pelawat.
Hasil yang dijangkakan: Pelawat melihat pilihan suara dalam widget.
4
Tetapkan had suara
Tentukan had setiap pengguna atau ruang kerja jika tersedia.
Hasil yang dijangkakan: Panggilan panjang atau berulang tidak boleh menggunakan lebih minit daripada yang dimaksudkan.
5
Dayakan transkrip
Hidupkan penjimatan transkrip jika anda memerlukan semakan panggilan dalam sejarah.
Hasil yang dijangkakan: Panggilan suara mencipta transkrip yang boleh dibaca selepas sesi.
6
Uji panggilan
Buka widget, benarkan akses mikrofon, mulakan panggilan dan tanya soalan yang disediakan.
Hasil yang dijangkakan: Bot bertindak balas dengan suara dan panggilan ditamatkan dengan bersih.
7
Baca transkrip
Buka Chat History dan cari perbualan suara.
Hasil yang dijangkakan: Transkrip menunjukkan apa yang dikatakan pelawat dan bot.
Cara mengujinya: Lengkapkan satu panggilan pendek dan sahkan minit suara, transkrip dan mod perbualan dirakam.
Masalah
Betulkan
Penyemak imbas menyekat mikrofon
Benarkan kebenaran mikrofon dalam penyemak imbas dan muat semula halaman.
Pilihan suara dikunci
Buka Pengebilan dan sahkan pelan ruang kerja termasuk ciri suara.
Transkrip kosong
Sahkan penjimatan transkrip didayakan dan panggilan ditamatkan seperti biasa.
Perkara yang perlu dilakukan seterusnya: Tambah atau perhalusi pengetahuan supaya jawapan suara adalah tepat.
Klon suara dan avatar
Klonkan suara dan tetapkan avatar tersuai
Untuk apa ini: Gunakan ini apabila pembantu memerlukan suara berjenama atau pengalaman avatar bercakap.
Sebelum anda bermula
Gunakan hanya audio dan imej yang anda mempunyai kebenaran untuk digunakan.
Rakam sampel suara bersih dengan bunyi latar belakang yang rendah.
Sahkan had pelan untuk suara klon dan avatar tersuai.
1
Buka Pengklonan Suara
Klik Clone Voice dari kawasan Voice.
Hasil yang dijangkakan: Dialog muat naik menunjukkan keperluan sampel yang diterima.
2
Muat naik sampel
Muat naik satu hingga lima rakaman yang jelas dan serahkan permintaan klon.
Hasil yang dijangkakan: Suara klon muncul selepas pemprosesan atau dialog menunjukkan keperluan seterusnya.
3
Tetapkan suara klon
Pilih suara klon dalam pemilih suara dan simpan.
Hasil yang dijangkakan: Panggilan masa hadapan menggunakan suara klon.
4
Pilih avatar saham
Pilih avatar yang disertakan jika muat naik avatar tersuai tidak diperlukan.
Hasil yang dijangkakan: Pengalaman suara mempunyai identiti visual.
5
Muat naik avatar tersuai
Muat naik imej wajah yang jelas atau video pendek jika rancangan anda menyokongnya.
Hasil yang dijangkakan: Avatar diproses dan tersedia untuk dipilih.
6
Jalankan pratonton penuh
Mulakan panggilan suara dan sahkan gelagat suara, avatar dan transkrip bersama-sama.
Hasil yang dijangkakan: Pengalaman pelawat sepadan dengan jenama yang dikonfigurasikan.
Cara mengujinya: Tanya soalan pendek dengan suara klon dipilih dan sahkan panggilan menggunakan suara/avatar yang dijangkakan.
Masalah
Betulkan
Kualiti klon kurang baik
Rakam sampel yang lebih bersih dengan satu pembesar suara, kelantangan stabil dan tiada muzik.
Muat naik avatar tersuai tidak tersedia
Semak Pengebilan untuk had avatar berpagar pelan.
Suara lama masih kedengaran
Simpan bot selepas memilih suara baharu dan muat semula halaman widget.
Perkara yang perlu dilakukan seterusnya: Teruskan ke Pengetahuan dan Data supaya pengalaman suara mempunyai jawapan yang tepat.
06
Pengetahuan Dan Data
Tambahkan pengetahuan manual, import kandungan tapak web, gunakan hasil rangkak, segerakkan kandungan yang diimport, tambah suapan produk URLs, muat semula atau alih keluar suapan dan sahkan jawapan dengan soalan ujian.
Bot Builder / PengetahuanSumber pengetahuan dan ujian jawapan
1Tambahkan pengetahuan manual untuk dasar, harga dan peraturan jenama.
2Import halaman tapak web dan gunakan hasil rangkak.
3Tambahkan suapan produk dan segerakkannya apabila inventori berubah.
Sumber ilmu
Latih bot dengan pengetahuan manual, import tapak web dan suapan produk
Untuk apa ini: Gunakan ini apabila pembantu memberikan jawapan yang tidak lengkap atau memerlukan maklumat produk, dasar atau tapak web baharu.
Sebelum anda bermula
Sediakan URLs sumber dan suapan produk URLs.
Tentukan halaman mana yang tidak boleh diimport, seperti halaman pentadbir atau peribadi.
Buat soalan ujian untuk setiap topik yang anda tambah.
1
Ilmu Terbuka
Buka Bot Builder dan pilih tab Pengetahuan atau Data.
Hasil yang dijangkakan: Pengetahuan manual, import tapak web dan alatan suapan produk boleh dilihat.
2
Tambah pengetahuan manual
Tampal fakta ringkas, dasar, harga, butiran hubungan dan nota gaya jawapan.
Hasil yang dijangkakan: Bot mempunyai sumber yang dipercayai segera untuk jawapan keutamaan tinggi.
3
Import kandungan tapak web
Tampalkan tapak web awam URL dan mulakan rangkak/import.
Hasil yang dijangkakan: Hasil rangkak menunjukkan halaman yang ditemui atau status import.
4
Semak dan gunakan keputusan
Simpan halaman yang berguna, alih keluar halaman yang tidak berkaitan, kemudian gunakan kandungan yang dipilih.
Hasil yang dijangkakan: Hanya kandungan tapak web yang diluluskan memasuki pangkalan pengetahuan.
5
Tambahkan suapan produk URLs
Tampal Google Merchant Center atau suapan yang disokong URLs dan import.
Hasil yang dijangkakan: Produk, harga, ketersediaan dan atribut tersedia untuk bot.
6
Muat semula atau alih keluar suapan
Gunakan muat semula apabila data katalog berubah dan alih keluar suapan yang tidak digunakan lagi.
Hasil yang dijangkakan: Bot mengelakkan data produk lapuk atau pendua.
7
Simpan dan segerakkan
Simpan bot dan tunggu penyegerakan selesai.
Hasil yang dijangkakan: Pengetahuan terkini digunakan oleh pratonton dan jawapan widget langsung.
8
Tanya soalan pengesahan
Tanya satu soalan ujian bagi setiap sumber yang anda tambahkan.
Hasil yang dijangkakan: Jawapan memetik atau mencerminkan kandungan yang dikemas kini dengan tepat.
Cara mengujinya: Tanya soalan tentang harga, pulangan, ketersediaan, maklumat syarikat dan topik yang tidak disokong. Sahkan bot menjawab topik yang diketahui dan tidak mencipta butiran yang tidak diketahui.
Masalah
Betulkan
Crawler mengimport halaman yang tidak berkaitan
Alih keluar halaman tersebut daripada hasil yang dipilih dan tambahkan arahan manual yang lebih jelas.
Harga produk sudah basi
Muat semula suapan dan sahkan suapan URL itu sendiri mengandungi nilai semasa.
Bot membuat jawapan
Tambahkan peraturan bahawa bot harus mengatakan ia tidak pasti dan menawarkan sokongan manusia apabila pengetahuan tiada.
Perkara yang perlu dilakukan seterusnya: Kembali ke Pratonton, uji sekali lagi, kemudian pasang atau kemas kini widget.
07
Peti masuk, Live Support, Sejarah, Kenalan
Kendalikan conversations setiap hari, tuntut permintaan sokongan langsung, kawalan tangan kembali ke AI, eksport sejarah, urus kenalan dan segerakkan kenalan ke SendPulse.
/peti masukAliran kerja perbualan peti masuk
1Tapis mengikut bot atau saluran.
2Buka perbualan dan balas sebagai manusia apabila diperlukan.
3Gunakan kawalan terjemah, selesaikan dan serahan dengan berhati-hati.
/live-supportKawalan penyerahan sokongan langsung
1Tuntut serahan menunggu dengan cepat.
2Balas sebagai ejen atau serahkan semula perbualan kepada AI.
3Selesaikan apabila pelawat tidak lagi memerlukan bantuan manusia.
/chat-sejarahSejarah perbualan dan eksport
1Cari mengikut pelawat, bot, saluran atau tarikh.
2Buka transkrip penuh untuk sesi teks dan suara.
3Eksport CSV atau JSON apabila diperlukan.
/kenalanKenalan dan SendPulse eksport
1Tapis kenalan mengikut bot atau sumber.
2Buka butiran hubungan dan konteks perbualan.
3Eksport atau segerakkan kenalan yang dipilih ke SendPulse.
Balasan peti masuk
Buka perbualan dan hantar balasan manusia
Untuk apa ini: Gunakan ini apabila pengendali perlu bertindak balas kepada pelanggan daripada sem.chat dan bukannya membiarkan AI meneruskan sahaja.
Sebelum anda bermula
Sahkan pengendali mempunyai akses kepada bot atau ruang kerja.
Baca perbualan sebelum membalas.
Ketahui sama ada pelawat mengharapkan bahasa yang sama.
1
Buka Peti Masuk
Klik Peti Masuk dalam bar sisi.
Hasil yang dijangkakan: conversations baru-baru ini muncul dengan bot, saluran, pelawat, status dan masa.
2
Tapis jika perlu
Gunakan penapis saluran, bot, belum dibaca atau status untuk mencari perbualan.
Hasil yang dijangkakan: Senarai menyempitkan kepada set perbualan yang anda perlukan.
3
Buka perbualan
Klik baris pelawat.
Hasil yang dijangkakan: Urutan penuh, maklumat pelawat dan kawalan balasan boleh dilihat.
4
Terjemah jika perlu
Gunakan kawalan terjemahan apabila bahasa pelawat berbeza daripada bahasa ejen.
Hasil yang dijangkakan: Ejen boleh memahami dan membalas dengan sewajarnya.
5
Hantar balasan
Tulis jawapan manusia dan hantarkannya.
Hasil yang dijangkakan: Mesej itu ditambahkan pada urutan sebagai balasan ejen/manusia.
6
Selesaikan atau terus terbuka
Selesaikan perbualan jika selesai, atau biarkan ia terbuka untuk tindakan susulan.
Hasil yang dijangkakan: Status peti masuk sepadan dengan keadaan pelanggan sebenar.
Cara mengujinya: Hantar balasan ujian selamat kepada perbualan ujian dan sahkan ia muncul dalam widget pelawat dan Chat History.
Masalah
Betulkan
Balasan gagal dihantar
Semak keadaan rangkaian, status perbualan dan sama ada sokongan langsung telah dituntut.
Bahasa pelawat adalah salah
Gunakan terjemahan atau kemas kini tetapan bahasa bot sebelum membalas.
Perbualan tiada dalam Peti Masuk
Cari Chat History dan sahkan ujian widget menggunakan bot yang betul.
Perkara yang perlu dilakukan seterusnya: Gunakan Live Support untuk baris gilir serahan aktif dan Chat History untuk audit.
Sokongan langsung
Tuntut, balas, serahkan kembali kepada AI, dan selesaikan serahan
Untuk apa ini: Gunakan ini apabila AI meminta manusia atau pelawat secara eksplisit memerlukan ejen.
Sebelum anda bermula
Sediakan ejen sebelum mendayakan sokongan langsung.
Tentukan bila AI harus meminta pelepasan dalam arahan bot.
Pastikan tetapan pemberitahuan didayakan untuk makluman lepas tangan.
1
Buka Live Support
Klik Live Support dalam bar sisi.
Hasil yang dijangkakan: Menunggu dan serahan aktif conversations kelihatan.
2
Tuntut permintaan itu
Klik Tuntut pada perbualan yang menunggu.
Hasil yang dijangkakan: Ejen lain boleh melihat perbualan dikendalikan secara aktif.
3
Baca konteks
Buka mesej dan butiran pelawat sebelum membalas.
Hasil yang dijangkakan: Ejen faham mengapa penyerahan itu berlaku.
4
Hantar balasan manusia
Balas dengan jelas dan pastikan urutan dikemas kini.
Hasil yang dijangkakan: Pelawat menerima respons manusia.
5
Serahkan kembali kepada AI jika sesuai
Gunakan tangan kembali apabila isu itu dijawab dan AI boleh diteruskan.
Hasil yang dijangkakan: AI menyambung semula mengendalikan perbualan.
6
Selesaikan apabila selesai
Klik Selesaikan selepas pelawat tidak memerlukan bantuan lagi.
Hasil yang dijangkakan: Handoff ditutup dan dialih keluar daripada baris gilir aktif.
Cara mengujinya: Buat penyerahan ujian, tuntutnya, balas sekali, serahkan kembali dan sahkan perubahan status dalam Live Support dan Chat History.
Masalah
Betulkan
Ejen terlepas permintaan
Dayakan pemberitahuan penyemak imbas/e-mel/tolak dan tambahkan proses untuk pemilikan baris gilir.
AI terus mengambil alih terlalu cepat
Laraskan arahan dan peraturan penyerahan supaya kawalan manusia kekal aktif sehingga diselesaikan atau diserahkan semula.
CRM luaran tidak segerak
Gunakan webhooks atau tinjauan pendapat daripada bahagian Resipi Pembangun.
Perkara yang perlu dilakukan seterusnya: Sambungkan CRM/webhooks jika pasukan sokongan bekerja di luar sem.chat.
Sejarah dan kenalan
Cari, eksport dan gunakan rekod perbualan/hubungan
Untuk apa ini: Gunakan ini untuk audit, semakan petunjuk, CSV eksport dan SendPulse penyegerakan.
Sebelum anda bermula
Tentukan sama ada anda memerlukan conversations, kenalan atau kedua-duanya.
Gunakan julat tarikh yang betul sebelum mengeksport.
Jangan eksport lebih banyak data peribadi daripada yang diperlukan.
1
Buka Chat History
Klik Chat History dalam bar sisi.
Hasil yang dijangkakan: Penapis perbualan, statistik dan senarai transkrip kelihatan.
2
Cari dan tapis
Tapis mengikut bot, saluran, mod, pelawat atau julat tarikh.
Hasil yang dijangkakan: Hanya padanan conversations kekal kelihatan.
3
Buka transkrip
Klik perbualan untuk membaca urutan mesej penuh.
Hasil yang dijangkakan: Konteks penuh, butiran hubungan dan metadata perbualan boleh dilihat.
4
Eksport conversations
Klik Eksport dan pilih format yang diperlukan jika tersedia.
Hasil yang dijangkakan: Eksport mengandungi data perbualan yang ditapis.
5
Buka Kenalan
Klik Kenalan dalam bar sisi.
Hasil yang dijangkakan: Rekod petunjuk/kenalan muncul dengan sumber, bot dan status.
6
Tapis dan eksport kenalan
Cari kenalan, pilih rekod yang dikehendaki, kemudian eksport atau segerakkan ke SendPulse.
Hasil yang dijangkakan: Kenalan yang dipilih tersedia di luar sem.chat mengikut tindakan yang dipilih.
Cara mengujinya: Eksport CSV kecil yang ditapis dan bukanya secara setempat untuk mengesahkan lajur dan julat tarikh adalah betul.
Masalah
Betulkan
Kenalan hilang daripada Kenalan
Sahkan penangkapan petunjuk didayakan dan pelawat menyerahkan borang.
Eksport terlalu besar
Kecilkan julat tarikh atau penapis bot sebelum mengeksport.
SendPulse penyegerakan tidak tersedia
Sambungkan SendPulse dalam Integrasi dahulu, kemudian kembali ke Kenalan.
Perkara yang perlu dilakukan seterusnya: Semak Analitis untuk memahami arah aliran prestasi selepas operasi dijalankan.
08
Saluran Dan Integrasi
Sambungkan Slack, Facebook, Instagram, WhatsApp, Telegram melalui BotFather, kelayakan manual, pautan alternatif chat, SendPulse dan CRM penyepaduan.
/integrasiSaluran, CRM dan sambungan e-mel
1Pilih saluran atau CRM kad penyepaduan.
2Ikuti OAuth atau langkah kelayakan untuk setiap pembekal.
3Putuskan sambungan atau uji semula penyepaduan dari halaman yang sama.
Sambungkan saluran
Sambungkan saluran pemesejan atau penyepaduan CRM
Untuk apa ini: Gunakan ini apabila sem.chat sepatutnya menerima conversations di luar widget tapak web atau menghantar kenalan ke alatan lain.
Sebelum anda bermula
Mempunyai akses pentadbir kepada platform luaran.
Ketahui bot mana yang patut menerima mesej saluran.
Gunakan saluran ujian sebelum menyambungkan akaun pengeluaran.
1
Integrasi Terbuka
Klik Integrasi dalam bar sisi.
Hasil yang dijangkakan: Saluran tersedia, alat CRM, SendPulse dan pilihan widget tapak web boleh dilihat.
2
Pilih penyepaduan
Klik Sambung pada Slack, saluran Meta, Telegram, SendPulse, CRM atau bukti kelayakan manual.
Hasil yang dijangkakan: Dialog persediaan atau aliran OAuth dibuka.
3
Lengkapkan persediaan pembekal
Untuk saluran OAuth, luluskan kebenaran yang diminta. Untuk saluran manual, tampal token, rahsia, ID akaun atau webhook yang diperlukan URL.
Hasil yang dijangkakan: sem.chat menyimpan sambungan dan menunjukkan integrasi sebagai disambungkan.
4
Tetapkan bot
Pilih bot yang harus mengendalikan mesej daripada saluran itu apabila dialog bertanya.
Hasil yang dijangkakan: Laluan mesej masuk ke pembantu yang betul.
5
Uji saluran
Hantar mesej ujian daripada saluran luaran.
Hasil yang dijangkakan: Mesej muncul dalam Peti Masuk atau Chat History di bawah saluran yang betul.
6
Putuskan sambungan jika perlu
Gunakan Putuskan sambungan daripada kad penyepaduan apabila saluran harus berhenti.
Hasil yang dijangkakan: sem.chat berhenti menerima atau menghantar melalui penyepaduan itu.
Cara mengujinya: Hantar satu mesej ujian melalui saluran yang disambungkan dan sahkan balasan bot, baris Peti masuk dan rekod sejarah.
Masalah
Betulkan
Telegram token gagal
Cipta atau tetapkan semula token dalam BotFather dan tampalkannya semula.
Slack mesej tidak sampai
Semak skop apl, langganan acara URL, token bot, rahsia tandatangan dan keahlian saluran.
Sambungan saluran meta gagal
Sahkan akaun Facebook/Instagram/WhatsApp mempunyai kebenaran pentadbir dan akses perniagaan yang diperlukan.
SendPulse penyegerakan gagal
Sambung semula SendPulse dan sahkan medan kenalan dipetakan.
Perkara yang perlu dilakukan seterusnya: Dokumen pemilikan saluran untuk pasukan dan pantau Peti Masuk selepas pelancaran.
09
Penjadualan
Buat jenis acara, konfigurasikan ketersediaan, sambungkan kalendar, urus tempahan, buat pautan sekali sahaja, konfigurasikan e-mel tempahan, semak analitik, tetapkan acara berbayar dan uji pautan tempahan awam.
/penjadualanMenjadualkan ruang kerja
1Gunakan tab untuk Jenis Acara, Tempahan, Analitis, Pautan Sekaligus, Kalendar, E-mel dan Tetapan.
2Edit, salin, benamkan, aktifkan atau jeda jenis acara.
3Salin pautan awam dan jalankan ujian tempahan peribadi.
Editor acaraKonfigurasi jenis acara
1Masukkan nama, perihalan, tempoh, lokasi dan penimbal.
2Tetapkan ketersediaan, tetingkap tempahan, soalan, pilihan acara berbayar dan peraturan pembatalan.
3Simpan acara sebelum berkongsi pautan.
/book/:username/:eventSlugHalaman tempahan awam
1Pelawat memilih tarikh daripada halaman tempahan awam.
2Pelawat memilih slot masa yang tersedia.
3Pelawat mengesahkan tempahan dan menerima e-mel pengesahan.
Jenis acara
Buat jenis acara dan terbitkan pautan tempahan
Untuk apa ini: Gunakan ini apabila pelawat perlu menempah demo, perundingan, panggilan jualan, onboarding atau sesi sokongan.
Sebelum anda bermula
Pilih nama acara, tempoh, jenis mesyuarat dan pemilik.
Tetapkan zon waktu dan ketersediaan sebelum berkongsi pautan.
Sambungkan kalendar jika tempahan dua kali penting.
1
Buka Penjadualan
Klik Penjadualan dalam bar sisi.
Hasil yang dijangkakan: Ruang kerja penjadualan menunjukkan tab untuk jenis acara, tempahan, analitis, pautan sekali sahaja, kalendar, e-mel dan tetapan.
2
Buat jenis acara
Klik Buat, kemudian tambahkan nama, perihalan, tempoh, lokasi, penimbal dan peraturan tempahan.
Hasil yang dijangkakan: Acara ini mempunyai maklumat awam yang mencukupi untuk pelawat memahaminya.
3
Tetapkan ketersediaan
Konfigurasikan waktu perniagaan mingguan, penggantian tarikh, tetingkap notis dan tetingkap tempahan.
Hasil yang dijangkakan: Pelawat hanya melihat masa yang anda sanggup tawarkan.
4
Tambah soalan
Tambahkan soalan yang diperlukan seperti telefon, syarikat, tapak web atau matlamat mesyuarat.
Hasil yang dijangkakan: Tempahan mengumpulkan konteks yang diperlukan oleh pasukan anda sebelum panggilan.
5
Sambungkan kalendar
Buka Kalendar dan sambungkan Google, Outlook atau iCal jika tersedia.
Hasil yang dijangkakan: Masa sibuk boleh disekat dan tempahan yang disahkan boleh ditulis ke kalendar.
6
Tetapkan e-mel dan peringatan
Buka E-mel dan konfigurasikan mesej pengesahan, peringatan, pembatalan dan jadualkan semula.
Hasil yang dijangkakan: Pelawat menerima komunikasi tempahan yang betul.
7
Kongsi dan uji pautan awam
Salin pautan acara, bukanya dalam tetingkap peribadi, pilih slot dan lengkapkan tempahan ujian.
Hasil yang dijangkakan: Tempahan muncul dalam tab Tempahan dan mesej pengesahan dihantar.
Cara mengujinya: Lengkapkan satu tempahan ujian, satu jadual semula dan satu pembatalan. Sahkan setiap acara muncul dalam Penjadualan dan kalendar yang disambungkan.
Masalah
Betulkan
Tiada masa muncul di halaman awam
Semak zon waktu, ketersediaan mingguan, penggantian tarikh, tetingkap notis dan konflik kalendar yang disambungkan.
E-mel tempahan tiada
Semak tetapan e-mel dan folder spam, kemudian hantar tempahan ujian lain.
Pembayaran gagal pada acara berbayar
Sahkan tetapan penyepaduan pengebilan/pembayaran dan mata wang adalah sah sebelum diterbitkan.
Perkara yang perlu dilakukan seterusnya: Benamkan pautan tempahan dalam bot, tapak web atau e-mel susulan.
Penjadualan lanjutan
Gunakan pautan sekali sahaja, analitis, benaman dan acara berbayar
Untuk apa ini: Gunakan ini apabila penjadualan memerlukan ketersediaan sementara, pelaporan, tempahan terbenam atau pembayaran.
Sebelum anda bermula
Buat sekurang-kurangnya satu jenis acara dahulu.
Sambungkan kalendar sebelum menggunakan pautan sekali sahaja.
Tentukan dasar bayaran balik/pembatalan sebelum mendayakan acara berbayar.
1
Buat pautan sekali sahaja
Buka Pautan Sekaligus, pilih slot atau peraturan yang ditawarkan, kemudian jana pautan.
Hasil yang dijangkakan: Penerima boleh menempah hanya dari ketersediaan yang dipilih.
2
Benamkan penjadualan
Gunakan pilihan benam kad acara jika aliran tempahan akan muncul di tapak web anda.
Hasil yang dijangkakan: UI tempahan boleh diletakkan di halaman tempat pelawat menukar.
3
Semak analitik penjadualan
Buka Analitis dalam Penjadualan.
Hasil yang dijangkakan: Anda boleh melihat tempahan, aliran penyiapan dan prestasi jenis acara.
4
Dayakan acara berbayar
Buka editor acara, tetapkan harga, mata wang dan gelagat pembayaran.
Hasil yang dijangkakan: Pelawat mesti melengkapkan langkah pembayaran mengikut persediaan acara.
5
Tempahan audit
Buka Tempahan dan semak penyertaan yang akan datang, selesai, dibatalkan dan dijadualkan semula.
Hasil yang dijangkakan: Pasukan boleh menguruskan kehadiran dan susulan.
Cara mengujinya: Tempah melalui halaman awam dan melalui halaman terbenam jika digunakan. Sahkan kedua-duanya mencipta jenis rekod tempahan yang sama.
Masalah
Betulkan
Pautan sekali sahaja mendedahkan slot yang salah
Jana semula pautan dengan set slot yang lebih kecil atau julat tarikh yang lebih ketat.
Tempahan terbenam terlalu sempit
Letakkan benam dalam bekas kandungan yang lebih luas dan semak reka letak mudah alih.
Analitis kelihatan kosong
Buat atau tunggu tempahan sebenar; analitik bergantung pada rekod tempahan.
Perkara yang perlu dilakukan seterusnya: Sambungkan hasil penjadualan kepada Laporan dan Analitis.
10
Analitis Dan Laporan
Pilih julat tarikh, gunakan tarikh tersuai, baca metrik teras, eksport CSV, semak aliran kepuasan dan perbualan, konfigurasikan laporan e-mel dan sahkan penghantaran.
/analitikPapan pemuka analitis
1Pilih julat tarikh atau tarikh tersuai.
2Baca metrik perbualan, kepuasan, bahasa, saluran dan penukaran.
3Eksport CSV untuk analisis luar talian.
Tetapan / LaporanPersediaan laporan e-mel
1Pilih irama laporan harian, mingguan atau bulanan.
2Tambah penerima laporan.
3Hantar laporan segera untuk menguji penghantaran.
Kajian analitis
Baca analisis dan eksport data prestasi
Untuk apa ini: Gunakan ini untuk semakan mingguan, semakan pelancaran, semakan kualiti sokongan dan analisis penukaran.
Sebelum anda bermula
Pilih julat tarikh sebelum membaca metrik.
Ketahui bot atau saluran yang anda nilai.
Kecualikan tarikh ujian peribadi apabila melaporkan prestasi pengeluaran.
1
Buka Analitis
Klik Analitis dalam bar sisi.
Hasil yang dijangkakan: Metrik papan pemuka dan panel carta kelihatan.
2
Pilih julat tarikh
Pilih hari ini, 7 hari, 30 hari atau tarikh tersuai.
Hasil yang dijangkakan: Semua carta dikemas kini kepada tempoh yang dipilih.
3
Baca metrik teras
Semak conversations, minit suara, kepuasan, penukaran dan campuran saluran.
Hasil yang dijangkakan: Anda memahami jumlah dan kualiti interaksi pelanggan.
4
Semak trend
Lihat arah aliran perbualan, perubahan kepuasan, soalan teratas dan corak bahasa/saluran.
Hasil yang dijangkakan: Anda boleh mengenal pasti tempat untuk menambah baik arahan atau kakitangan bot.
5
Eksport CSV
Gunakan Eksport CSV apabila pasukan memerlukan analisis hamparan.
Hasil yang dijangkakan: CSV mengandungi julat tarikh dan metrik yang dipilih.
6
Tukar penemuan kepada perubahan
Kemas kini arahan bot, pengetahuan, tetapan widget atau liputan sokongan berdasarkan data.
Hasil yang dijangkakan: Analitis membawa kepada peningkatan produk konkrit.
Cara mengujinya: Eksport tarikh tersuai kecil CSV dan sahkan julat tarikh serta metrik sepadan dengan apa yang ditunjukkan oleh papan pemuka.
Masalah
Betulkan
Metrik kelihatan terlalu tinggi
Semak sama ada pementasan/ujian conversations disertakan dalam julat tarikh yang dipilih.
Kepuasan kosong
Dayakan penilaian dalam Tetapan Widget dan tunggu pelawat meninggalkan penilaian.
Minit suara tidak sepadan dengan jangkaan
Sahkan mod suara didayakan hanya pada bot yang dimaksudkan.
Perkara yang perlu dilakukan seterusnya: Jadualkan laporan e-mel untuk keterlihatan berulang.
Laporan
Konfigurasikan laporan e-mel berulang dan penghantaran ujian
Untuk apa ini: Gunakan ini apabila pemilik, pengurus atau pelanggan memerlukan ringkasan prestasi automatik.
Sebelum anda bermula
Tentukan siapa yang patut menerima laporan.
Gunakan alamat e-mel yang disahkan.
Pilih irama yang sepadan dengan irama ulasan perniagaan.
1
Buka Tetapan, kemudian Laporan
Pergi ke Tetapan dan pilih tab Laporan atau gunakan ubah hala Laporan jika tersedia.
Hasil yang dijangkakan: Irama laporan, penerima dan sejarah kelihatan.
2
Pilih irama
Dayakan laporan harian, mingguan atau bulanan.
Hasil yang dijangkakan: Jadual laporan disimpan untuk ruang kerja.
3
Tambah penerima
Masukkan alamat e-mel yang sepatutnya menerima laporan.
Hasil yang dijangkakan: Laporan dihantar kepada pihak berkepentingan yang betul.
4
Hantar laporan segera
Klik Hantar Sekarang atau tindakan laporan segera yang setara.
Hasil yang dijangkakan: E-mel laporan dihantar serta-merta untuk pengesahan.
5
Semak sejarah laporan
Semak panel sejarah selepas laporan dihantar.
Hasil yang dijangkakan: Anda boleh mengesahkan status penghantaran dan masa.
Cara mengujinya: Hantar laporan segera kepada penerima ujian dan sahkan penerimaan dan pemformatan.
Masalah
Betulkan
E-mel laporan tidak sampai
Semak ejaan penerima, folder spam dan status sejarah laporan.
Orang salah terima laporan
Kemas kini penerima dan simpan sebelum penghantaran berjadual seterusnya.
Kandungan laporan berasa bising
Laraskan jangkaan julat tarikh dan gunakan Analitis untuk semakan manual yang lebih mendalam.
Perkara yang perlu dilakukan seterusnya: Gunakan irama laporan sebagai rentak operasi untuk penambahbaikan bot.
11
Pengebilan, Pasukan, Keselamatan, Tetapan, Ahli Gabungan
Mulakan atau tingkatkan rancangan, urus portal pengebilan, jemput rakan sepasukan, tetapkan peranan, edit profil/bahasa, konfigurasikan pemberitahuan, dayakan 2FA, gunakan tindakan zon bahaya dan jalankan aliran kerja ahli gabungan.
/bilPelan dan kawalan pengebilan
1Semak pelan semasa, keadaan percubaan dan had usage.
2Bandingkan ciri pelan sebelum menaik taraf.
3Buka portal pengebilan untuk invois, kaedah pembayaran, pembatalan atau pengaktifan semula.
/tetapanTetapan, pasukan dan keselamatan
1Gunakan Umum untuk profil dan bahasa.
2Gunakan Pasukan untuk jemputan dan peranan.
3Gunakan Keselamatan untuk kekunci 2FA, API dan tindakan zon bahaya.
/bersekutuKawalan program gabungan
1Sertai program untuk membuat pautan rujukan.
2Salin pautan rujukan untuk kempen.
3Tetapkan e-mel pembayaran dan minta pembayaran yang layak.
Pengebilan
Mulakan, tingkatkan, batalkan atau aktifkan semula rancangan
Untuk apa ini: Gunakan ini apabila ruang kerja memerlukan pengaktifan percubaan, lebih banyak had, invois, kemas kini pembayaran atau perubahan langganan.
Sebelum anda bermula
Pemilik akaun atau pentadbir pengebilan harus melakukan tindakan pengebilan.
Sahkan ciri yang berpagar pelan: suara, suara klon, avatar tersuai, API, pasukan, CRM dan saluran.
Gunakan portal pengebilan selamat untuk kaedah pembayaran dan perubahan invois.
1
Buka Pengebilan
Klik Pengebilan dalam bar sisi.
Hasil yang dijangkakan: Pelan semasa, keadaan percubaan, had usage dan kad pelan kelihatan.
2
Bandingkan rancangan
Semak chat, suara, pasukan, API, avatar, penyepaduan, penjadualan dan had sokongan.
Hasil yang dijangkakan: Anda tahu pelan mana yang membuka kunci ciri yang diperlukan.
3
Pilih selang masa pengebilan
Pilih bulanan atau tahunan jika togol tersedia.
Hasil yang dijangkakan: Kemas kini harga dan penjimatan untuk selang yang dipilih.
4
Tingkatkan atau mulakan pembayaran
Pilih pelan yang diingini dan lengkapkan pembayaran.
Hasil yang dijangkakan: Langganan menjadi aktif selepas pengesahan pembayaran.
5
Buka portal pelanggan
Gunakan portal pengebilan untuk kaedah pembayaran, invois, pembatalan atau pengaktifan semula.
Hasil yang dijangkakan: Tindakan pengebilan sensitif berlaku dalam portal penyedia selamat.
6
Sahkan akses ciri
Kembali ke ciri yang telah dikunci dan muat semula apl.
Hasil yang dijangkakan: Ciri yang tidak berkunci kini tersedia jika rancangan itu menyertakannya.
Cara mengujinya: Selepas menaik taraf, buka ciri yang dikunci sebelum ini, seperti kekunci klon suara atau API dan sahkan kunci telah hilang.
Masalah
Betulkan
Ciri kekal dikunci selepas naik taraf
Muat semula apl, tunggu seketika untuk penyegerakan langganan, kemudian semak Pengebilan sekali lagi.
Daftar keluar telah dibatalkan
Kembali ke Pengebilan dan mulakan pembayaran semula; tiada perubahan pelan berlaku selepas pembayaran yang dibatalkan.
Perlukan invois atau tukar kad
Buka portal pelanggan dan bukannya mengedit butiran pembayaran di dalam apl.
Perkara yang perlu dilakukan seterusnya: Jemput rakan sepasukan dan selamatkan akaun pemilik.
Untuk apa ini: Gunakan ini apabila ruang kerja beralih daripada persediaan solo kepada operasi pasukan.
Sebelum anda bermula
Ketahui setiap peranan rakan sepasukan sebelum menghantar jemputan.
Gunakan akses dengan keistimewaan paling rendah: Pemilik, Pentadbir, Editor, Penonton.
Sediakan apl pengesah untuk 2FA.
1
Buka Tetapan
Klik Tetapan dalam bar sisi.
Hasil yang dijangkakan: Umum, pemberitahuan, pasukan, laporan, pembangun, keselamatan dan tab yang berkaitan kelihatan.
2
Edit profil dan bahasa
Kemas kini nama paparan, maklumat profil dan bahasa pilihan secara Umum.
Hasil yang dijangkakan: Apl ini mengenal pasti pengguna dengan betul dan menggunakan bahasa yang dipilih jika tersedia.
3
Jemput ahli pasukan
Buka Pasukan, masukkan e-mel, pilih peranan dan hantar jemputan.
Hasil yang dijangkakan: Rakan sepasukan menerima pautan jemputan dan muncul sebagai belum selesai sehingga diterima.
4
Tetapkan kebenaran peranan
Gunakan Pemilik untuk kawalan penuh, Pentadbir untuk pengurusan, Editor untuk perubahan kandungan dan Viewer untuk akses baca sahaja.
Hasil yang dijangkakan: Setiap pengguna mempunyai akses yang sesuai dengan tanggungjawab mereka.
5
Konfigurasikan pemberitahuan
Pilih e-mel, penyemak imbas, tolak, sokongan langsung, pengebilan dan pemberitahuan laporan.
Hasil yang dijangkakan: Orang yang betul mendapat makluman tanpa bunyi yang tidak perlu.
6
Dayakan 2FA
Buka Keselamatan, dayakan pengesahan dua faktor, imbas kod dan simpan butiran pemulihan.
Hasil yang dijangkakan: Akaun memerlukan faktor kedua selepas log masuk kata laluan.
7
Gunakan tindakan zon bahaya dengan berhati-hati
Eksport data yang diperlukan dan sahkan widget/integrasi aktif sebelum tindakan akaun yang merosakkan.
Hasil yang dijangkakan: Ruang kerja mengelakkan kehilangan data secara tidak sengaja.
Cara mengujinya: Jemput rakan sepasukan ujian, terima jemputan dalam penyemak imbas yang berasingan dan sahkan peranan hanya mendedahkan ciri yang dimaksudkan.
Masalah
Betulkan
E-mel jemputan tiada
Semak spam, hantar semula jemputan dan sahkan alamat.
Rakan sepasukan terlalu banyak melihat
Kurangkan peranan mereka dan semak tetapan akses bot.
Persediaan 2FA gagal
Semak masa peranti, imbas semula kod QR dan simpan butiran pemulihan sebelum bergantung padanya.
Perkara yang perlu dilakukan seterusnya: Konfigurasikan kunci API hanya untuk pengguna dan perkhidmatan yang memerlukannya.
ahli gabungan
Sertai ahli gabungan, salin pautan rujukan, tetapkan e-mel pembayaran dan minta pembayaran
Untuk apa ini: Gunakan ini apabila rakan kongsi atau pelanggan ingin merujuk pengguna sem.chat baharu dan menjejaki aktiviti komisen.
Sebelum anda bermula
Gunakan akaun yang sepatutnya memiliki atribusi rujukan.
Sediakan e-mel pembayaran sebelum meminta pembayaran.
Semak peraturan program sebelum menerbitkan kempen rujukan.
1
Buka Gabungan
Klik Gabungan dalam bar sisi atau buka tab ahli gabungan daripada Tetapan jika dipautkan di sana.
Hasil yang dijangkakan: Halaman program gabungan menunjukkan kawasan penyertaan, rujukan, pembayaran dan sejarah.
2
Sertai program ini
Klik Sertai jika akaun belum menyertai lagi.
Hasil yang dijangkakan: Kod rujukan dan pautan rujukan dibuat.
3
Salin pautan rujukan
Salin pautan unik dan gunakannya dalam kandungan, kempen atau mesej rakan kongsi.
Hasil yang dijangkakan: Pendaftaran melalui pautan boleh dikaitkan dengan akaun ahli gabungan.
4
Tetapkan e-mel pembayaran
Masukkan e-mel pembayaran dan simpannya.
Hasil yang dijangkakan: Pembayaran yang layak boleh dialihkan dengan betul.
5
Semak rujukan dan komisen
Semak senarai rujukan, status komisen dan sejarah pembayaran.
Hasil yang dijangkakan: Anda tahu perkara yang belum selesai, layak atau sudah dibayar.
6
Minta bayaran
Klik Minta Pembayaran apabila peraturan dan minimum program dipenuhi.
Hasil yang dijangkakan: Permintaan pembayaran direkodkan untuk diproses.
Cara mengujinya: Buka pautan rujukan dalam penyemak imbas peribadi dan sahkan ia mendarat pada aliran pendaftaran yang dijangkakan dengan penjejakan rujukan.
Masalah
Betulkan
Pautan rujukan tiada
Sertai program dahulu atau muat semula halaman ahli gabungan selepas menyertai.
Permintaan pembayaran tidak tersedia
Semak ambang pembayaran minimum, keadaan komisen yang layak dan e-mel pembayaran.
Rujukan tidak dikaitkan
Sahkan pelawat menggunakan pautan rujukan yang tepat dan tidak menanggalkan parameter penjejakan.
Perkara yang perlu dilakukan seterusnya: Gunakan Analitis dan Laporan untuk memantau kesan pelanggan yang dirujuk jika berkenaan.
12
Pemberitahuan Dan App Updates
Semak makluman, tandai pemberitahuan dibaca, tapis acara penting dan gunakan kemas kini apl untuk memahami perubahan produk baharu.
/pemberitahuanPusat pemberitahuan
1Gunakan Tandakan semua telah dibaca selepas menyemak makluman yang belum dibaca.
2Tapis mengikut acara yang belum dibaca, pengebilan, sokongan langsung atau sistem.
3Buka ciri berkaitan selepas membaca amaran.
/app-updatesSuapan kemas kini apl
1Baca nota keluaran untuk ciri dan pembetulan baharu.
2Gunakan butiran untuk melatih rakan sepasukan sebelum perubahan aliran kerja.
3Semak kemas kini selepas perasan UI atau perubahan tingkah laku.
Pemberitahuan
Semak pemberitahuan dan bertindak mengikut makluman
Untuk apa ini: Gunakan ini apabila apl melaporkan penyerahan, keadaan pengebilan, acara sistem, penghantaran laporan atau aktiviti ruang kerja yang penting.
Sebelum anda bermula
Pastikan pilihan pemberitahuan ditetapkan dalam Tetapan.
Dapatkan liputan sokongan langsung jika makluman lepas tangan didayakan.
Semak makluman yang belum dibaca sebelum menandakannya dibaca.
1
Buka Pemberitahuan
Klik Pemberitahuan dalam bar sisi atau entri pemberitahuan pengepala apl.
Hasil yang dijangkakan: Pusat pemberitahuan menyenaraikan makluman terkini.
2
Tapis makluman
Gunakan penapis yang belum dibaca atau kategori untuk memfokuskan pada pengebilan, sokongan langsung, bot, laporan atau acara sistem.
Hasil yang dijangkakan: Hanya makluman yang sepadan kekal kelihatan.
3
Buka halaman berkaitan
Klik makluman atau gunakan konteksnya untuk membuka Pengebilan, Live Support, Laporan atau bot yang berkaitan.
Hasil yang dijangkakan: Anda bertindak mengikut pemberitahuan itu dan bukannya membacanya sahaja.
4
Tanda baca
Tandai satu makluman dibaca atau gunakan Tandai semua dibaca selepas semakan.
Hasil yang dijangkakan: Penurunan kiraan yang belum dibaca dan item yang disemak tidak lagi diserlahkan.
5
Laraskan pilihan
Buka Tetapan, Pemberitahuan jika terlalu banyak atau terlalu sedikit makluman tiba.
Hasil yang dijangkakan: Strim pemberitahuan sepadan dengan keperluan pasukan.
Cara mengujinya: Buat acara ujian selamat seperti permintaan sokongan langsung atau laporan segera, kemudian sahkan pemberitahuan muncul dan boleh ditandakan sebagai dibaca.
Masalah
Betulkan
Tiada pemberitahuan tiba
Semak pilihan pemberitahuan Tetapan, kebenaran penyemak imbas dan sama ada peristiwa itu benar-benar berlaku.
Terlalu banyak makluman
Lumpuhkan kategori bising atau hantar hanya kepada ahli pasukan yang bertanggungjawab.
Kiraan belum dibaca nampaknya tersekat
Muat semula apl selepas menandakan semua penapis dibaca dan sahkan tidak menyembunyikan item yang belum dibaca.
Perkara yang perlu dilakukan seterusnya: Semak App Updates apabila perubahan tingkah laku atau kawalan baharu muncul.
Kemas kini apl
Gunakan kemas kini apl untuk memahami perubahan produk
Untuk apa ini: Gunakan ini apabila rakan sepasukan perlu mengetahui perkara yang berubah sebelum menggunakan ciri baharu.
Sebelum anda bermula
Buka kemas kini selepas keluaran utama atau apabila UI berubah.
Kongsi nota kemas kini yang berkaitan dengan pengguna sokongan dan jualan.
Uji semula aliran kerja kritikal selepas perubahan besar.
1
Buka App Updates
Klik App Updates dalam bar sisi.
Hasil yang dijangkakan: Suapan kemas kini menunjukkan ciri baharu, pembetulan dan nota keluaran.
2
Baca kemas kini terkini
Buka paparan kad kemas kini atau butiran terkini.
Hasil yang dijangkakan: Anda melihat perkara yang berubah dan aliran kerja yang mempengaruhinya.
3
Petakan perubahan pada aliran kerja anda
Kenal pasti sama ada kemas kini mempengaruhi bot, widget, sokongan, penjadualan, pengebilan atau pembangun.
Hasil yang dijangkakan: Ahli pasukan yang betul tahu perkara yang perlu diperiksa.
4
Uji semula laluan kritikal
Jika kemas kini menjejaskan aliran kerja pengeluaran, ulangi langkah manual yang berkaitan daripada dokumentasi ini.
Hasil yang dijangkakan: Pasukan mengesahkan aliran kerja yang diubah masih berfungsi.
5
Kongsi secara dalaman
Hantar ringkasan kemas kini kepada pengguna yang memiliki kawasan yang terjejas.
Hasil yang dijangkakan: Penerimaan pasukan lebih lancar dan soalan sokongan menurun.
Cara mengujinya: Selepas kemas kini yang berkaitan, ulangi panduan untuk ciri yang terjejas dan sahkan tangkapan skrin atau nama langkah masih sepadan.
Masalah
Betulkan
Kemas kini menyebut ciri terkunci
Buka Pengebilan untuk mengesahkan sama ada rancangan semasa menyertakannya.
Pasukan terlepas perubahan
Tambahkan ulasan App Updates pada keluaran atau rutin operasi mingguan.
Dokumentasi kelihatan basi selepas kemas kini
Gunakan Panduan Jurutera untuk mengemas kini tangkapan skrin dan langkah.
Perkara yang perlu dilakukan seterusnya: Pastikan dokumentasi awam terkini apabila ciri berkembang.
13
Resipi Pembangun
Jana kekunci API, gunakan pengesahan x-api-key, panggil titik akhir berasaskan tindakan, rapatkan sokongan langsung kepada CRM, daftarkan webhook, sahkan tandatangan dan benamkan widget dalam kod.
Tetapan / PembangunAPI kekunci, mula pantas dan usage tab
1Jana dan batalkan kekunci API daripada tab Kekunci API.
2Gunakan Quick Start untuk contoh curl pertama.
3Semak Penggunaan sebelum mendayakan automasi volum tinggi.
API mula pantas
Hasilkan kunci API dan buat API panggilan pertama
Untuk apa ini: Gunakan ini untuk skrip pelaporan, apl tersuai, jambatan CRM, sokongan langsung luaran atau automasi.
Sebelum anda bermula
Gunakan persekitaran sebelah pelayan. Jangan dedahkan kekunci API dalam penyemak imbas JavaScript.
Hasilkan kunci berasingan untuk setiap penyepaduan.
Salin kunci dengan segera kerana rahsia ditunjukkan sekali.
1
Pembangun Terbuka
Buka Tetapan dan pilih Pembangun, atau gunakan ubah hala Pembangun jika tersedia.
Hasil yang dijangkakan: Tab API Kekunci, Quick Start, Dokumentasi dan Penggunaan kelihatan.
2
Hasilkan kunci
Klik Generate Key, berikan label yang jelas dan salin dengan segera.
Hasil yang dijangkakan: Kunci bermula dengan sk_live_ dan tersedia untuk permintaan sebelah pelayan.
3
Hantar pengepala x-api-key
Sertakan x-api-key pada setiap permintaan API awam.
Hasil yang dijangkakan: Orang awam API boleh mengesahkan permintaan dan memberikan skop kepada pemiliknya.
4
Senaraikan bot
Hubungi tindakan=list-bots untuk mencari ID bot yang anda perlukan.
Hasil yang dijangkakan: Respons mengembalikan ID bot, nama, keadaan aktif dan ringkasan konfigurasi.
5
Hantar mesej chat
POST tindakan chat dengan botId dan mesej.
Hasil yang dijangkakan: Respons mengembalikan maklumat balasan, model dan usage.
6
Semak usage
Hubungi tindakan=usage sebelum menjalankan kerja volum tinggi.
Hasil yang dijangkakan: Anda tahu rancangan semasa dan keadaan usage sebelum automasi dijalankan.
7
Putar kekunci apabila diperlukan
Batalkan kunci yang tidak digunakan dan jana yang baharu untuk vendor atau perkhidmatan yang ditukar.
Hasil yang dijangkakan: Perkhidmatan lama tidak boleh terus menggunakan bukti kelayakan yang lapuk.
Cara mengujinya: Jalankan list-bots dan chat dari terminal atau persekitaran pelayan setempat, kemudian sahkan perbualan muncul dalam Chat History jika chat dihantar.
Masalah
Betulkan
401 atau respons yang tidak dibenarkan
Semak ejaan x-api-key, salin kekunci penuh dan sahkan ia tidak dibatalkan.
Bot tidak ditemui
Gunakan list-bots sekali lagi dan sahkan bot itu milik pemilik kunci API.
Isu CORS pelayar
Alihkan panggilan API ke hujung belakang anda; Kekunci API bertujuan untuk kegunaan sebelah pelayan.
Perkara yang perlu dilakukan seterusnya: Gunakan /api-docs untuk rujukan titik akhir terfokus dan simpan halaman ini sebagai panduan aliran kerja.
Senaraikan bot
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Hantar mesej 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?"
}'
Jambatan CRM sokongan langsung
Tinjau pendapat atau tolak permintaan sokongan langsung ke dalam CRM
Untuk apa ini: Gunakan ini apabila ejen bekerja dalam sistem lain tetapi sem.chat menerima perbualan pelawat.
Sebelum anda bermula
Buat kunci API khusus yang dinamakan untuk jambatan CRM.
Tentukan sama ada tinjauan pendapat atau webhook sesuai dengan infrastruktur anda.
Pastikan CRM menyimpan ID perbualan untuk balasan/peleraian masa hadapan.
1
Senaraikan serahan menunggu
GET tindakan=live-support-list dengan status=diminta atau status=semua.
Hasil yang dijangkakan: CRM menerima conversations terbuka yang memerlukan perhatian manusia.
2
Ambil mesej
GET tindakan=live-support-messages dengan conversationId.
Hasil yang dijangkakan: CRM mempunyai konteks urutan penuh dan butiran pelawat.
3
Tuntut sebelum membalas
POST tindakan=live-support-claim.
Hasil yang dijangkakan: sem.chat menandakan perbualan sebagai dikendalikan secara aktif.
4
Hantar balasan ejen
POST tindakan=live-support-reply dengan conversationId, mesej dan nama ejen.
Hasil yang dijangkakan: Pelawat menerima balasan manusia dan kemas kini urutan.
5
Selesaikan atau serahkan kembali
POST action=live-support-resolve dengan resolusi resolusi atau hand-back.
Hasil yang dijangkakan: Perbualan meninggalkan baris gilir menunggu atau AI menyambung semula kawalan.
6
Log status dalam CRM
Simpan status penyerahan terkini, ID mesej dan cap masa.
Hasil yang dijangkakan: CRM dan sem.chat kekal boleh diaudit.
Cara mengujinya: Buat serahan selamat, cerminkannya ke CRM, balas daripada jambatan dan sahkan kemas kini urutan pelawat.
Masalah
Betulkan
Duplikat CRM tiket
Gunakan conversationId sebagai kunci mati pucuk dalam jambatan CRM anda.
Balasan tiba di luar pesanan
Simpan cap masa mesej dan elakkan balasan serentak daripada berbilang sistem.
AI membalas semasa ejen sedang bekerja
Tuntut handoff dahulu dan hanya serahkan semula apabila ejen selesai.
Perkara yang perlu dilakukan seterusnya: Daftar webhooks jika pengundian terlalu lambat atau terlalu mahal.
Webhooks
Daftar webhooks dan sahkan X-SemChat-Signature
Untuk apa ini: Gunakan ini apabila sistem anda memerlukan acara masa nyata untuk penyerahan, mesej dan kemas kini resolusi.
Sebelum anda bermula
Webhook URL mestilah HTTPS dan boleh dicapai daripada internet awam.
Simpan rahsia webhook dengan segera; ia ditunjukkan sekali.
Sahkan tandatangan sebelum memproses acara.
1
Daftar webhook
POST tindakan webhook-register dengan url dan acara.
Hasil yang dijangkakan: Tanggapan termasuk butiran webhook dan rahsia tandatangan sekali sahaja.
2
Simpan rahsia
Simpan rahsia dalam persekitaran pelayan atau pengurus rahsia anda.
Hasil yang dijangkakan: Penghantaran masa hadapan boleh disahkan.
3
Sahkan tandatangan
Baca X-SemChat-Signature dan bandingkan dengan HMAC SHA-256 di atas badan permintaan mentah.
Hasil yang dijangkakan: Hanya penghantaran sem.chat tulen diterima.
4
Kendalikan percubaan semula secara idempoten
Gunakan ID acara atau ID perbualan/mesej untuk mengelakkan pemprosesan pendua.
Hasil yang dijangkakan: Percubaan semula tidak mencipta rekod CRM pendua.
5
Senaraikan webhook
GET tindakan webhook-list untuk mengaudit titik akhir yang dikonfigurasikan.
Hasil yang dijangkakan: Anda boleh melihat URLs, acara, keadaan didayakan dan keadaan penghantaran terkini.
6
Padamkan webhook yang lapuk
POST tindakan webhook-delete dengan ID webhook.
Hasil yang dijangkakan: Titik akhir lama berhenti menerima acara.
Cara mengujinya: Daftar titik akhir ujian, cetuskan acara sokongan langsung, sahkan tandatangan dan sahkan pengendali anda mengembalikan 2xx.
Masalah
Betulkan
Tandatangan tidak sepadan
Gunakan kandungan mentah, bukan dihuraikan JSON dan sahkan rahsia webhook yang betul.
Webhook tidak menerima sebarang acara
Sahkan senarai acara termasuk acara yang anda uji dan titik akhir ialah HTTPS.
Webhook tamat masa
Akui dengan cepat dan proses kerja lama secara tidak segerak.
Perkara yang perlu dilakukan seterusnya: Pautkan jurutera ke /api-docs untuk butiran dan contoh titik akhir.
Untuk apa ini: Gunakan ini apabila memilih tindakan yang betul untuk sesuatu ciri.
Sebelum anda bermula
Setiap permintaan menggunakan fungsi public-api yang sama URL.
Tindakan GET menggunakan parameter pertanyaan. POST tindakan menggunakan JSON badan.
Hantar x-api-key pada semua permintaan.
Cara mengujinya: Panggil usage dan list-bots sebagai ujian asap selepas sebarang perubahan kunci API atau titik akhir.
Masalah
Betulkan
Kaedah tidak padan
Gunakan kaedah yang ditunjukkan dalam jadual titik akhir. Sesetengah tindakan adalah GET-sahaja atau POST-sahaja.
Tiada nilai yang diperlukan
Semak botId, conversationId, id webhook dan ejaan tindakan.
Perkara yang perlu dilakukan seterusnya: Gunakan Quick Start untuk permintaan pertama, kemudian /api-docs untuk rujukan penuh.
Kaedah
Tindakan
Tujuan
GET
list-bots
Senaraikan semua bot yang tersedia kepada pemilik kunci API.
GET
get-bot
Ambil satu konfigurasi bot dengan ID bot.
POST
chat
Hantar mesej pelawat ke bot dan kembalikan balasan AI.
GET
conversations
Senaraikan conversations terbaru untuk bot, sehingga 100 rekod.
GET
usage
Pelan pengembalian, kredit, kiraan bot, conversations dan kunci API usage.
GET
live-support-list
Senaraikan conversations menunggu atau dikendalikan oleh ejen manusia.
GET
live-support-messages
Ambil urutan serahan dengan mesej dan maklumat pelawat.
POST
live-support-reply
Hantar balasan manusia-ejen daripada sistem luaran.
POST
live-support-claim
Tuntut perbualan serahan menunggu.
POST
live-support-resolve
Selesaikan serahan atau kembalikan kawalan kepada AI.
POST
webhook-register
Daftar HTTPS titik akhir webhook.
GET
webhook-list
Senaraikan pendaftaran webhook tanpa mengembalikan rahsia.
POST
webhook-delete
Padamkan pendaftaran webhook dengan ID.
14
Panduan Jurutera: Tambah Ciri
Tambahkan laluan, navigasi papan pemuka, tetapan pembina bot, Supabase jadual/fungsi/migrasi, API dokumen, dokumentasi awam, semakan SEO dan pengesahan setempat.
Aliran kerja ciri apl
Tambahkan laluan apl, halaman, item navigasi dan entri dokumen
Untuk apa ini: Gunakan ini apabila menambah ciri papan pemuka yang menghadap pelanggan baharu.
Sebelum anda bermula
Buat cawangan sebelum mengedit.
Kenal pasti sama ada ciri tersebut tergolong dalam repo apl atau repo bahagian hadapan sem.chat awam.
Periksa laluan, bar sisi, i18n dan corak tetapan sedia ada sebelum menambah struktur baharu.
1
Tambah laluan
Kemas kini src/App.tsx dengan laluan yang dilindungi untuk halaman pelanggan, atau laluan awam hanya apabila halaman tersebut mestilah awam.
Hasil yang dijangkakan: URL diselesaikan dalam apl tanpa menekan NotFound.
2
Buat atau kemas kini komponen halaman
Gunakan corak halaman sedia ada, pemuatan data, keadaan kosong, keadaan pemuatan dan kebenaran.
Hasil yang dijangkakan: Ciri ini berkelakuan konsisten dengan papan pemuka.
3
Tambah navigasi papan pemuka
Kemas kini sumber bar sisi/nav dengan label, ikon, laluan dan pintu pelan jika diperlukan.
Hasil yang dijangkakan: Pengguna boleh menemui halaman baharu daripada cangkerang apl.
4
Tambahkan tab atau tetapan pembina bot
Jika ciri tersebut dimiliki oleh bot, tambahkannya di dalam tab Bot Builder dan kekalkannya melalui aliran simpan sedia ada.
Hasil yang dijangkakan: Konfigurasi khusus bot disimpan dengan bot, tidak terkandas dalam keadaan setempat.
5
Tambah Supabase perubahan skema/fungsi
Buat migrasi untuk jadual/dasar dan fungsi tepi untuk kerja bahagian pelayan.
Hasil yang dijangkakan: Perilaku pangkalan data dan pelayan boleh digunakan berulang kali.
6
Kemas kini bentuk API jika awam
Tambah atau lanjutkan pengendalian tindakan dalam supabase/functions/public-api/index.ts dan kelakuan x-api-key dokumen.
Hasil yang dijangkakan: Penyepaduan boleh menggunakan ciri ini dengan selamat.
7
Kemas kini dokumen apl dan dokumentasi awam
Kemas kini dokumen pembangun dalam apl dan halaman /dokumentasi ini dengan tangkapan skrin dan langkah klik demi klik.
Hasil yang dijangkakan: Pengguna dan jurutera melihat ciri ini di kedua-dua tempat.
8
Jalankan pemeriksaan
Jalankan ujian/binaan apl, pengoptimum SEO di tapak awam, semakan peta laman dan pengesahan penyemak imbas.
Hasil yang dijangkakan: Ciri ini berfungsi secara tempatan dan tapak awam kekal boleh dirangkak.
Cara mengujinya: Buka laluan baharu, gunakan ciri hujung ke hujung, periksa ralat konsol/rangkaian dan sahkan sebarang perubahan pangkalan data daripada UI.
Masalah
Betulkan
Laluan berfungsi tetapi nav tidak menyerlahkan
Semak padanan laluan bar sisi dan laluan ubah hala.
Data berfungsi secara setempat tetapi tidak digunakan
Sahkan penghijrahan, dasar RLS dan pembolehubah persekitaran fungsi tepi.
Dokumen awam tiada daripada peta laman
Jalankan pengoptimum SEO dan periksa sitemap.xml untuk URL kanonik.
Perkara yang perlu dilakukan seterusnya: Tangkap atau jana semula tangkapan skrin dokumentasi apabila UI berubah.
Aliran kerja penyelenggaraan dokumen
Kemas kini halaman dokumentasi awam ini selepas perubahan produk
Untuk apa ini: Gunakan ini apabila tangkapan skrin, aliran kerja, tingkah laku API atau navigasi berubah.
Sebelum anda bermula
Gunakan data demo selamat sahaja.
Jangan sekali-kali dedahkan pelanggan sebenar, e-mel, butiran pembayaran, kunci API atau conversations peribadi.
Kemas kini manual bahasa Inggeris dahulu, kemudian segarkan setiap halaman dokumentasi setempat sebelum semakan SEO.
1
Audit laluan yang diubah
Buka laluan apl dan kenal pasti perkara yang berubah secara visual dan prosedur.
Hasil yang dijangkakan: Anda tahu baris panduan, tangkapan skrin dan penyelesaian masalah yang memerlukan pengeditan.
2
Tangkap atau jana tangkapan skrin selamat
Gunakan ruang kerja demo dan tutup rahsia sebelum menyimpan aset WebP di bawah aset/dokumentasi.
Hasil yang dijangkakan: Tangkapan skrin adalah tepat dan selamat untuk diterbitkan.
3
Kemas kini panduan
Edit bahagian yang berkaitan Untuk apa ini, Sebelum anda bermula, Langkah, Hasil yang dijangkakan, Ujian, Penyelesaian Masalah dan Seterusnya.
Hasil yang dijangkakan: Panduan memberitahu pengguna perkara yang perlu diklik dan perkara yang perlu berlaku selepas setiap klik.
4
Kemas kini navigasi jika perlu
Tambahkan bahagian pada TOC melekit, pemilih bahagian mudah alih dan indeks visual jika ia adalah halaman utama.
Hasil yang dijangkakan: Pembaca boleh mencari kandungan baharu dengan cepat.
5
Jalankan alat SEO
Jalankan alat nod/seo-optimize-static-pages.js dan alat nod/seo-optimize-static-pages.js --check.
Hasil yang dijangkakan: Keluaran kanonik, metadata, peta laman dan robot kekal betul.
6
Jalankan pemeriksaan pembersihan dan perbezaan
Jalankan alat nod/static-translation-cleanup.js --audit dan git diff --check.
Hasil yang dijangkakan: Terjemahan statik dan ruang kosong adalah bersih.
7
Pengesahan penyemak imbas
Layankan tapak secara tempatan dan uji /dokumentasi pada desktop dan mudah alih.
Hasil yang dijangkakan: Imej dimuatkan, kerja carian, butang salin berfungsi, sorotan TOC dan reka letak tidak bertindih dengan sepanduk kuki.
Cara mengujinya: Cari nama ciri yang diubah pada /dokumentasi dan sahkan blok panduan yang betul muncul.
Masalah
Betulkan
Penanda tangkapan skrin hanyut pada mudah alih
Simpan penanda di dalam imej tangkapan skrin atau gunakan koordinat penanda responsif.
Carian terlepas panduan baharu
Tambahkan kata kunci yang berguna pada tajuk data dan sertakan istilah produk tepat yang dicari pengguna.
Dokumentasi setempat menjadi lapuk
Selepas mengedit manual bahasa Inggeris, segarkan setiap halaman dokumentasi setempat, jalankan semula pengoptimum SEO, dan sahkan bahawa sitemap.xml mengandungi setiap URL dokumentasi.
Perkara yang perlu dilakukan seterusnya: Serahkan halaman dokumen, aset, pautan pengepala/pengaki, .htaccess dan perubahan peta laman bersama-sama.
Perlukan rujukan API yang difokuskan?
Halaman /api-docs yang lebih lama kekal tersedia untuk butiran API peringkat titik akhir.