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. Semua hal lainnya — warna, posisi, sapaan, bahasa — berasal dari dasbor Anda sehingga Anda tidak perlu men-deploy ulang situs Anda untuk mengubahnya.

Widget ditampilkan dalam bahasa yang diatur di Instal → Language your bot speaks: tombol, placeholder, dan pemberitahuannya, serta arah tata letaknya (Arab dan Urdu ditulis dari kanan ke kiri). Teksnya datang bersama konfigurasi widget, jadi tidak ada permintaan kedua dan tidak ada yang perlu Anda terjemahkan sendiri.

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:

Contoh — buka obrolan dari tombol "Hubungi kami" milik Anda sendiri:

<button onclick="KeydaBot.open()">Chat with us</button>

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 logonya, bukan tombolnya: peluncur (launcher) tetap pada ukurannya dan logo membesar di dalamnya. Ukuran tombol (Instal → Tampilan) adalah yang mengubah ukuran tombol itu sendiri — kecil, sedang, atau besar — apa pun bentuknya.
• Empat bentuk tombol: pil dengan label Anda, gelembung bulat, kotak membulat, dan gelembung obrolan dengan ekor. Ekornya berada di sisi yang menghadap halaman Anda.
• 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 setelahnya. Membuka kembali panel akan memulihkan percakapan itu — termasuk file, dan pertanyaan alur sambutan yang masih menunggu jawaban.
• Ikon penjepit kertas pada kolom pesan memungkinkan pengunjung melampirkan hingga tiga foto atau dokumen ke sebuah pesan (ukuran dan jenisnya ada di Limits and security). Foto diperkecil resolusinya di peramban sebelum diunggah, sehingga foto 12 megapiksel meninggalkan halaman hanya dengan ukuran beberapa ratus kilobyte. Matikan fitur file di Instal dan tombolnya akan hilang.
• Alur sambutan berjalan sebagai gelembung obrolan biasa: pilihan menjadi tombol di bawah gelembung, tombol Lewati muncul saat sebuah langkah bersifat opsional, dan placeholder pada kolom pesan berubah menjadi pertanyaannya. Alur yang telah selesai diingat di peramban pengunjung selama 30 hari.
• Jika asisten tidak dapat dihubungi, widget akan menampilkan pesan singkat dan tidak akan pernah memunculkan error di halaman Anda.

Di dalam SDK aplikasi

Obrolan yang sama berjalan di setiap SDK, sehingga lampiran dan alur sambutan sampai ke aplikasi Anda tanpa perlu rilis baru — dengan satu pengecualian. Membuka pemilih file dari sebuah web view adalah tugas aplikasi host. Paket iOS, React Native, dan Ionic sudah melakukannya; Android dan Flutter memerlukan SDK 0.1.4 atau yang lebih baru. Pada versi yang lebih lama, widget mengenali shell tersebut dan menyembunyikan ikon penjepit kertas alih-alih menampilkan tombol yang tidak berfungsi.