Copy page

Hubungkan Channel

Pasang Widget Web

Widget Web menaruh jendela chat di situs Anda. Percakapan pengunjung masuk ke OneInbox sebagai channel Website. Setiap widget adalah satu akun channel WEB tersendiri.

Sebelum mulai

• Anda masuk sebagai Owner atau Admin.
• Anda tahu domain situs yang akan memasang widget.
• Anda bisa menempel kode HTML di situs tersebut.

Langkah

1. Buka menu Platform > Widget Web.
2. Isi Widget name (hanya nama yang wajib), lalu klik Create widget.
3. Pada kartu widget, klik ikon pengaturan untuk membuka panel Kustomisasi.
4. Di bagian Domain yang diizinkan, ketik domain situs lalu tekan Enter. Anda juga bisa menempel beberapa domain sekaligus.
5. Klik Simpan widget.
6. Salin Embed snippet dari kartu widget dan tempel di HTML situs Anda.

Snippet berbentuk seperti ini. Salin snippet asli dari dashboard, karena alamat dan kunci berbeda untuk tiap widget.

Code
<script
  src="https://<domain-anda>/api/widget.js"
  data-key="KUNCI-PUBLIK-WIDGET"
  async></script>

Aturan domain

• Domain wajib diisi. Tanpa domain, widget ditolak di semua situs dan kartu menampilkan peringatan.
• Contoh yang valid: example.com (otomatis menjadi https://example.com) dan https://shop.example.com.
• Wildcard hanya boleh berupa awalan seperti https://*.example.com. Wildcard tidak mencakup domain utama (example.com).
• Skema dan port harus cocok dengan alamat situs Anda.
• Entri yang tidak valid tetap ada di kolom dan harus diperbaiki sebelum bisa disimpan.

Kustomisasi

Panel Kustomisasi punya beberapa bagian:

• Tampilan: warna utama, gaya bubble (Membulat atau Kotak), dan ukuran jendela chat (Ringkas, Standar, Besar).
• Tombol launcher: ikon, gaya (ikon dan teks, ikon saja, teks saja), teks, posisi (kiri atau kanan), jarak dari sisi dan bawah, buka otomatis setelah beberapa detik, dan Sembunyikan di ponsel.
• Header dan pesan: judul dan subjudul header, URL avatar atau unggah gambar, pesan sambutan, placeholder kotak pesan, dan Saran balasan (maksimal 4).
• Formulir sebelum chat: tampilkan kolom Nama, Nomor HP, Email, dan kolom kustom CRM. Atur Tampilkan, Wajib, dan urutannya. Maksimal 20 kolom.
• Kembalikan ke bawaan mengembalikan tampilan ke bawaan di form saja. Perubahan baru tersimpan setelah Simpan widget.

Pratinjau langsung tampil di samping form.

Widget dengan AI

Widget dapat dibalas otomatis oleh alur kerja AI. Pengaturannya ada di AI Automation > Alur Kerja, bukan di halaman Widget Web.

1. Buat widget dulu seperti di atas, cukup dengan nama.
2. Terbitkan dan aktifkan alur kerja yang akan dipakai. Hanya alur kerja yang sudah terbit yang bisa dipilih.
3. Di Pemilih workflow default, cari baris dengan nama widget Anda (kelompok "Kanal"), lalu pilih alur kerjanya. Bila belum dipilih, widget memakai workflow default global atau workflow terbit terbaru.
4. Gunakan saklar AI aktif / AI nonaktif pada baris itu untuk menyalakan atau mematikan AI hanya di widget tersebut. Saklar ini terpisah dari saklar transport widget di halaman Widget Web, yang menghidupkan atau mematikan widget itu sendiri.

Di Kustomisasi widget, bagian Saran balasan menyediakan pertanyaan sekali ketuk (maksimal 4) yang tampil di bawah pesan sambutan untuk pengunjung baru. Ini bagian dari tampilan widget, bukan pengaturan AI.

Hasil yang diharapkan

• Launcher chat muncul di situs yang domainnya terdaftar.
• Pesan pengunjung masuk ke OneInbox. Balasan AI dan agen tampil di jendela chat.
• Perubahan tema berlaku setelah Anda menyimpan widget.

Kunci publik dan keamanan

• Kunci publik terlihat di HTML situs. Perlindungannya adalah daftar domain, bukan autentikasi sungguhan.
• Bila kunci bocor, klik Rotasi kunci dan konfirmasi. Semua situs harus memakai snippet baru.
• Nomor telepon dari formulir pra-chat dianggap klaim yang belum terverifikasi. Pengunjung tidak otomatis disatukan dengan pelanggan lama hanya karena nomornya sama.

Batas

• Pesan dan pra-chat: 60 per menit per widget dan alamat IP.
• Unggahan: 15 per menit.
• Unggahan gambar atau dokumen maksimal 10 MB.

Menonaktifkan atau menghapus

• Sakelar Widget transport mematikan widget tanpa menghapusnya.
• Delete widget menghapus widget beserta riwayat percakapannya secara permanen. Anda diminta konfirmasi dulu.

Masalah umum

• Launcher tidak muncul: periksa domain terdaftar, termasuk skema dan port. Pastikan sakelar transport aktif.
• Snippet lama berhenti bekerja: kunci mungkin sudah dirotasi. Pasang snippet terbaru.
• Pengunjung tidak bisa mengirim: bisa jadi batas 60 pesan per menit tercapai.

Lihat juga Masalah koneksi. Atur balasan otomatis di Alur kerja AI.