Keyda API Widget
Untuk pengembang, atau siapa pun yang ingin obrolan terbuka dari tombol mereka sendiri.
Memasang
<script src="https://keyda.in/business/widget.js"
data-key="kb_live_your_key_here" async></script>Tag skrip hanya memerlukan src dan data-key. Segala hal lainnya — warna, posisi, sapaan, bahasa — berasal dari dasbor Anda sehingga Anda tidak perlu pernah menerapkan ulang situs Anda untuk mengubahnya.
Mode
Mengambang (bawaan). Tombol peluncur di sudut yang membuka panel obrolan.
Inline. Letakkan kontainer kosong di halaman dan obrolan akan mengisinya:
<div data-keyda-bot style="height:520px"></div>Wadah memerlukan tinggi. Dalam mode sebaris, obrolan selalu terlihat, jadi tidak ada yang perlu dibuka atau ditutup.
JavaScript API
Tersedia di window.KeydaBot setelah skrip dimuat:
| Telepon | Cara kerjanya |
|---|---|
KeydaBot.open() | Membuka panel obrolan |
KeydaBot.close() | Menutupnya |
KeydaBot.toggle() | Membuka atau menutup |
KeydaBot.expand() | Membuat panel setinggi jendela dan lebarnya hingga 760px |
KeydaBot.shrink() | Kembali ke kartu standar |
KeydaBot.isOpen | true saat obrolan terlihat |
KeydaBot.isExpanded | true saat panel diperluas |
KeydaBot.clientId | Client ID yang digunakan halaman ini |
Contoh — buka obrolan dari tombol "Hubungi kami" milik Anda sendiri:
<button onclick="KeydaBot.open()">Chat with us</button>Skrip dimuat secara asinkron, jadi
window.KeydaBot mungkin belum tersedia sesaat setelah halaman dimuat. Lampirkan pengendali pada klik alih-alih memanggilnya saat halaman sedang diurai.Cara kerjanya di halaman Anda
- Panel terbuka di atas tombol peluncur, yang tetap berada di tempatnya dan berubah menjadi tombol tutup. Mengetuknya lagi, simbol ✕ di header, atau menekan Escape akan menutup obrolan.
- Pengunjung dapat memperluas panel dari header — panel akan melebar hingga ukuran jendela dan lebar maksimum 760px — dan pilihan tersebut diingat di browser mereka. Pada ponsel, panel sudah memenuhi seluruh layar, sehingga tombol kontrol tidak ditampilkan di sana.
- Pengaturan ukuran logo Anda mengubah logo, bukan tombolnya: peluncur adalah pil berukuran tetap 52px (58px untuk bentuk bulat dan kotak) dan logo membesar di dalamnya.
- Semua dirender di dalam shadow root, sehingga CSS Anda tidak dapat merusak widget dan CSS widget tidak dapat memengaruhi situs Anda.
- Panel hanya dimuat saat pengunjung membukanya, sehingga tidak memperlambat halaman Anda.
- Percakapan pengunjung berlanjut selama 24 jam jika mereka kembali, lalu dimulai dari awal.
- Jika asisten tidak dapat dihubungi, widget akan menampilkan pesan singkat dan tidak akan pernah memunculkan error di halaman Anda.