Library JavaScript widget Business Messages secara terprogram menginisialisasi dan mengaktifkan pelacakan interaksi untuk widget Business Messages.
Fungsi dan properti
Fungsi dan properti memberikan kontrol terperinci atas elemen inisialisasi.
Init
Secara dinamis menginisialisasi elemen HTML untuk digunakan sebagai Widget Business Messages. Fungsi ini menampilkan promise yang akan di-resolve saat inisialisasi selesai.
window.bmwidget.init(HTMLElement, {agentId, context}):Promise
HTMLElement
adalah elemen yang akan diinisialisasi sebagai widget.{agentId, context}
adalah nilai untukdata-bm-widget-agent-id
dan Atribut HTMLdata-bm-widget-context
.
Periksa
Memindai dokumen untuk menemukan elemen HTML apa pun yang berisi
data-bm-widget-agent-id
dan mengonversi elemen tersebut menjadi Business
Widget Message. window.bmwidget.scan()
otomatis dipanggil saat pemuatan halaman
dan selama inisialisasi skrip.
window.bmwidget.scan():void
Didukung
Flag boolean hanya baca yang benar jika perangkat pengguna mendukung Business Messages.
window.bmwidget.supported:boolean
Acara
Library ini memicu peristiwa pada elemen HTML yang diinisialisasi sebagai Widget Business Messages.
Pengikatan berhasil
Peristiwa bm-widget-bind-success
terpicu saat elemen HTML
berhasil dibatasi sebagai widget Business Messages dan siap digunakan.
domNode.addEventListener('bm-widget-bind-success', (event) => {
console.log(event.data);
});
Pengikatan gagal
Peristiwa bm-widget-bind-fail
dipicu saat upaya untuk mengikat ke HTML
gagal. Hal ini dapat terjadi karena kegagalan
memvalidasi URL atau
karena kegagalan umum
untuk mendapatkan elemen HTML. Gagal memvalidasi
terjadi jika URL belum terdaftar sebagai entri widget Business Messages
atau perangkat pengguna tidak didukung.
Detail properti event.data
penyebab kegagalan.
domNode.addEventListener('bm-widget-bind-fail', (event) => {
console.log(event.data);
});
Pemicu intent
Peristiwa bm-widget-intent-trigger
dipicu saat pengguna mengetuk Bisnis yang diinisialisasi
Titik entri widget Message. Peristiwa ini menandakan ketukan, tetapi tidak mengindikasikan
apakah platform percakapan Business Messages berhasil diinisialisasi.
domNode.addEventListener('bm-widget-intent-trigger', (event) => {
console.log(event.data);
});