Widget Business Messages

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 untuk data-bm-widget-agent-id dan Atribut HTML data-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);
});