Lewati ke konten utama

Widget Obrolan Web

Saluran Web Chat memasang jendela obrolan di situs web Anda. Pengunjung mengklik tombol obrolan di sudut halaman lalu menulis kepada Anda. Percakapan mereka masuk ke kotak masuk MonoChat seperti saluran lainnya, tempat tim, alur, dan agen AI Anda membalasnya.

Hubungkan saluran​

  1. Buka Pengaturan › Obrolan › Saluran lalu klik Hubungkan.
  2. Pilih Web Chat.
  3. Isi pengaturan di bawah ini lalu simpan. Setiap kolom menjelaskan kegunaannya, dan sisi kanan formulir menampilkan pratinjau jendela yang berubah saat Anda mengedit. Alihkan pratinjau antara tombol obrolan yang tertutup, jendela yang terbuka, dan contoh percakapan.
  4. Salin cuplikan kode yang ditampilkan saluran dan tambahkan ke situs web Anda (lihat Pasang cuplikan kode).

Anda dapat menghubungkan beberapa saluran Web Chat, misalnya satu untuk setiap situs web.

Pengaturan​

PengaturanFungsinya
Nama saluranNama saluran di MonoChat. Jendela menampilkannya sebagai judul saat Judul widget kosong.
Judul widgetJudul jendela obrolan.
SubjudulBaris di bawah judul, misalnya seberapa cepat Anda biasanya membalas. Kosongkan kolom untuk menyembunyikan baris ini.
LogoGambar yang ditampilkan di samping judul: file PNG, JPEG, GIF, SVG, atau WebP.
WarnaWarna tombol obrolan, kepala jendela, dan pesan pengunjung. Teks di atasnya menjadi hitam atau putih agar tetap terbaca.
PosisiKanan bawah atau kiri bawah halaman.
LampiranMengizinkan pengunjung mengirim gambar, video, audio, dan dokumen hingga 10 MB.
Tombol emojiMenampilkan tombol berisi emoji yang umum dipakai di samping kotak pesan. Aktif secara default.
Sembunyikan tombol obrolanMenyembunyikan tombol obrolan; Anda membuka jendela dari tombol Anda sendiri dengan API JavaScript.
Tampilan selulerCara jendela terbuka di ponsel: Layar penuh, atau Ringkas, panel yang menutupi tiga perempat bagian bawah halaman.
Domain yang diizinkanSitus tempat jendela boleh muncul: host persis (www.example.com) atau semua subdomain (*.example.com), dengan port opsional (localhost:3000). Jika dikosongkan, situs mana pun boleh menampilkannya.

Bahasa​

Tombol dan label jendela mengikuti bahasa peramban pengunjung, dan tampil dalam bahasa Inggris jika MonoChat tidak memiliki bahasa tersebut.

Judul widget, Subjudul, Pengantar formulir, dan Teks persetujuan memiliki versi untuk setiap bahasa workspace Anda; bahasa-bahasa ini diatur di Pengaturan › CRM › Bahasa (lihat Pengaturan Bahasa). Klik kolomnya untuk menulis setiap versi. Jendela menampilkan versi dalam bahasa peramban pengunjung, atau versi dalam bahasa default Anda jika bahasa tersebut tidak memiliki versi.

Untuk menampilkan jendela dalam satu bahasa apa pun bahasa perambannya, panggil MonoChat('setLocale', 'tr-TR') dari API JavaScript.

Formulir pra-obrolan​

Saat formulir nonaktif, pengunjung langsung mulai menulis. Untuk meminta alamat email atau nomor telepon, gunakan alur (lihat Alur dan widget).

Saat formulir aktif, jendela meminta data berikut sebelum pesan pertama:

KolomOpsi
NamaNonaktif, opsional, atau wajib
EmailNonaktif, opsional, atau wajib
TeleponNonaktif, opsional, atau wajib

Anda juga dapat menulis teks yang tampil di atas kolom dan menambahkan kotak centang persetujuan dengan teks Anda sendiri serta tautan ke kebijakan privasi Anda. Jika kotak centang aktif, pengunjung harus mencentangnya untuk memulai obrolan. Nama, alamat email, dan nomor telepon disimpan ke profil pelanggan.

Pasang cuplikan kode​

Saluran menampilkan cuplikan kode yang alamat widget dan kunci salurannya sudah terisi, tepat setelah Anda menghubungkannya dan di bawah pratinjau saat Anda mengedit saluran. Tempelkan sebelum tag penutup </body> di setiap halaman yang harus menampilkan obrolan:

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

Jendela dimuat setelah halaman Anda, jadi tidak memperlambat halaman.

Beralih dari WebChat lama

Jika situs Anda masih memuat cuplikan kode saluran WebChat lama, hapus cuplikan itu dan tempelkan cuplikan kode saluran Web Chat yang baru sebagai gantinya.

Mode halaman penuh​

Untuk memberi obrolan halamannya sendiri, misalnya halaman bantuan, tambahkan &mode=fullpage ke tag kedua cuplikan kode:

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

Jendela lalu memenuhi seluruh halaman dan tetap terbuka, tanpa kepala jendela dan tombol obrolan, sementara close dan toggle tidak melakukan apa pun. Jendela dimuat bersama halaman, bukan setelahnya, dan pengaturan Tampilan seluler tidak berlaku.

Google Tag Manager​

  1. Di container Anda, tambahkan tag Custom HTML dan tempelkan cuplikan kode apa adanya.
  2. Pilih pemicu All Pages, atau pemicu yang hanya aktif di halaman yang harus menampilkan obrolan.
  3. Klik Submit, lalu Publish.

Jika skrip halaman Anda sendiri memanggil MonoChat, skrip itu bisa berjalan sebelum tag. Biarkan juga <script> pertama dari cuplikan kode di halaman, agar panggilannya menunggu jendela.

Pembuat situs web dan toko online​

Jika Anda tidak bisa mengedit kode situs, tempelkan cuplikan kode apa adanya ke kolom yang disediakan platform Anda untuk kode di setiap halaman, di akhir halaman atau di footer:

PlatformTempat cuplikan kode
WordPressPasang plugin WPCode dan tempelkan cuplikan kode ke kotak Footer-nya. Di WordPress.com, bisa tidaknya Anda menambahkan kode bergantung pada paket Anda.
ShopifyOnline Store › Edit code: buka theme.liquid dan tempelkan cuplikan kode tepat sebelum </body>.
WixSettings › Custom Code › Add Custom Code: pilih semua halaman dan Body – end. Situs harus sudah dipublikasikan dan memiliki domain yang terhubung.
SquarespaceKolom Footer di Code Injection, pada paket Core, Plus, dan Advanced.
WebflowSite settings › Custom code › Footer code, lalu publikasikan situs.
ikasSales Channel › Extensions › Scripts › Add Script: tempelkan cuplikan kode sebagai isi skrip, simpan, dan pastikan skrip aktif.

API JavaScript​

Cuplikan kode mendefinisikan fungsi MonoChat di halaman Anda. Panggil fungsi ini dari skrip, tautan, dan tombol Anda sendiri untuk mengendalikan jendela. Panggilan yang dibuat sebelum jendela dimuat akan menunggu sampai jendela siap, jadi Anda dapat memanggilnya tepat setelah cuplikan kode.

Perintah​

PanggilanFungsinya
MonoChat('open')Membuka jendela.
MonoChat('close')Menutup jendela.
MonoChat('toggle')Membuka jendela jika tertutup, menutupnya jika terbuka.
MonoChat('hideLauncher')Menyembunyikan tombol obrolan. Jendela tetap dapat dibuka dengan open dan toggle.
MonoChat('showLauncher')Menampilkan tombol obrolan lagi.
MonoChat('setUser', { name, email, phone })Meneruskan apa yang sudah Anda ketahui tentang pengunjung. Lihat Pengunjung yang sudah masuk.
MonoChat('setLocale', 'tr-TR')Menampilkan jendela dalam bahasa ini, apa pun bahasa browser-nya. Lihat Bahasa.
MonoChat('on', event, callback)Memanggil callback setiap kali event terjadi. Lihat Peristiwa.

Peristiwa​

PeristiwaKapanYang diterima callback
readyJendela sudah dimuat.Tidak ada
openJendela terbuka, dari tombol obrolan atau melalui panggilan.Tidak ada
closeJendela tertutup.Tidak ada
unreadJumlah balasan yang belum dibaca berubah: balasan masuk saat jendela tertutup, atau pengunjung membukanya.Jumlah balasan yang belum dibaca

Daftarkan callback Anda tepat setelah cuplikan kode agar tidak melewatkan ready.

Pengunjung yang sudah masuk​

Jika pengunjung sudah masuk ke situs Anda, teruskan datanya dengan setUser. Semua kolom bersifat opsional, dan jendela hanya membaca name, email, dan phone.

  • Formulir pra-obrolan diisi dengan data tersebut. Formulir dilewati jika sudah memiliki semua yang dimintanya, kecuali kotak centang persetujuan aktif: pengunjung selalu mencentangnya sendiri.
  • Data disimpan ke profil pelanggan di MonoChat, sehingga tim Anda melihat siapa yang menulis.
  • Jika alamat email atau nomor telepon tidak valid, tidak ada satu pun data yang disimpan.

Contoh​

Buka jendela dari tombol Anda sendiri dan sembunyikan tombol obrolan:

<button onclick="MonoChat('open')">Chat dengan kami</button>
<script>
MonoChat('hideLauncher')
</script>

Teruskan pengguna yang sudah masuk dan tampilkan jendela dalam bahasa halaman:

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

Tampilkan jumlah balasan yang belum dibaca pada tombol Anda sendiri:

<button onclick="MonoChat('open')">Bantuan <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

Kirim peristiwa ke alat analitik Anda saat pengunjung membuka jendela:

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

Percakapan​

Setiap pengunjung adalah pelanggan di MonoChat, dan percakapannya disimpan di perambannya: pengunjung yang kembali dengan peramban yang sama melihat 200 pesan terakhir, selama 90 hari setelah pesan terakhir. Peramban atau perangkat lain memulai percakapan baru. Balasan tim Anda dan indikator mengetik langsung muncul di jendela.

Tombol emoji di samping kotak pesan menyediakan emoji yang umum dipakai. Pengunjung juga dapat mengetik emoji apa pun dari keyboard mereka.

Pesan yang dikirim pengunjung menampilkan tanda centang, seperti di WhatsApp: satu centang abu-abu saat pesan terkirim, dua centang abu-abu saat pesan sudah sampai di MonoChat, dan dua centang biru setelah seseorang di tim Anda membuka percakapan. Di MonoChat, balasan Anda tampil sebagai terkirim saat jendela pengunjung menerimanya, dan sebagai dibaca saat pengunjung membuka jendela.

Saat jendela tertutup, balasan baru menampilkan jumlah pesan yang belum dibaca pada tombol obrolan dan memutar suara singkat. Peramban hanya memutar suara setelah pengunjung mengklik atau mengetik di mana pun pada halaman.

Tipe pesan​

Jendela menampilkan pesan seperti layar obrolan MonoChat: nama agen di atas balasannya, baris berisi tanggal di awal hari baru, dan waktu di dalam setiap gelembung, dengan tanda centang pada pesan pengunjung.

Selain teks, emoji, dan file, balasan Anda dapat menggunakan tipe di bawah ini. Kirim tipe tersebut dari node alur Kirim Pesan, pesan singkat, aplikasi, dan fungsi (lihat Tipe Pesan).

TipeCara jendela menampilkannya
Gambar, video, audio, stikerDi dalam gelembung.
DokumenKartu berisi tipe dan nama file yang mengunduh file tersebut.
Balasan cepatTombol di bawah pesan terakhir. Klik mengirim judul tombol sebagai balasan pengunjung.
TombolPesan dengan header opsional (teks, gambar, video, atau dokumen), footer, dan tombol yang mengirim balasan, membuka alamat web, atau menelepon nomor telepon.
CTA UrlPesan dengan satu tombol yang membuka alamat web.
DaftarBaris-baris di dalam gelembung, dikelompokkan per bagian. Klik pada sebuah baris mengirimnya sebagai balasan pengunjung.
KorselKartu yang digeser pengunjung ke samping, masing-masing dengan gambar atau video, judul, subjudul, dan tombol.
LokasiPenanda dengan nama dan alamat tempat yang membuka tempat itu di Google Maps.
Permintaan lokasiTombol Kirim lokasi. Peramban meminta izin pengunjung, lalu lokasinya sampai di MonoChat sebagai pesan lokasi.
KontakNama dan perusahaan setiap kontak, dengan tautan untuk menelepon nomor teleponnya dan menulis ke alamat emailnya.

Balasan cepat, tombol balasan, baris daftar, dan permintaan lokasi hanya berfungsi pada pesan terakhir, sehingga pengunjung tidak dapat menjawab pertanyaan lama.

Ikon tombol​

Tombol yang membuka alamat web dapat menampilkan ikon: pilih ikon di kolom Ikon pada pesan CTA Url atau tombol URL Web. Kolom ini hanya muncul saat Anda menyusun pesan untuk Web Chat: saluran lain tidak menampilkan ikon. Ikon yang tersedia adalah Tautan, Situs web, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Telepon, Email, dan Lokasi; tombol tanpa ikon menampilkan ikon tautan.

Alur dan widget​

Pesan sambutan, jam kerja, balasan di luar jam kerja, permintaan alamat email atau nomor telepon, dan pesan proaktif diatur dengan alur, bukan dengan pengaturan saluran.

Event Tindakan Pelanggan Diterima memulai alur dari jendela:

  • Widget chat dibuka pertama kali: pengunjung membuka jendela dan tidak memiliki percakapan terbuka. MonoChat memulai percakapan, atau membuka kembali percakapannya yang sudah ditutup, sehingga alur dapat menulis kepada pengunjung sebelum pengunjung menulis. Membuka jendela lagi selama percakapan masih terbuka tidak memicunya lagi.
  • Widget chat dibuka: pengunjung membuka jendela, setiap kali, termasuk yang pertama. Pengunjung tanpa percakapan terbuka mendapatkan percakapan, seperti di atas.
  • Widget chat ditutup: pengunjung menutup jendela selama percakapan terbuka.

Jika formulir pra-obrolan aktif, jendela dihitung sebagai dibuka setelah pengunjung mengisinya.

Sekadar melihat halaman yang memuat widget tidak memicu satu pun. Pengunjung yang belum menulis menjadi pelanggan di MonoChat hanya jika ada alur yang mendengarkan tindakan tersebut.

Dalam mode halaman penuh, jendela terbuka bersama halaman, jadi memuat halaman dihitung sebagai membuka jendela. Setiap saluran menghitung paling banyak 60 pembukaan jendela per menit; pembukaan selebihnya tidak memulai alur.

Untuk menyapa pengunjung, mulai alur dengan Tindakan Pelanggan Diterima yang diatur ke Widget chat dibuka pertama kali dan tambahkan node Kirim Pesan berisi pesan sambutan Anda. Susun pesan itu dengan pembuat pesan, dengan tombol balasan, daftar, atau tautan dengan ikon.

Powered by MonoChat​

Jendela menampilkan baris kecil Powered by dengan logo MonoChat. Ini bukan pengaturan saluran: baris ini hanya dapat disembunyikan untuk seluruh instalasi MonoChat.