Tiện ích Business Messages

Thư viện JavaScript của tiện ích Business Messages theo phương thức lập trình khởi chạy và bật tính năng theo dõi mức độ tương tác cho các tiện ích Business Messages.

Hàm và thuộc tính

Các hàm và thuộc tính cung cấp quyền kiểm soát chi tiết đối với phần tử khởi tạo.

Init

Tự động khởi chạy một phần tử HTML được sử dụng làm phần tử Tiện ích Business Messages. Hàm này trả về một lời hứa sẽ phân giải khi quá trình khởi tạo đã hoàn tất.

window.bmwidget.init(HTMLElement, {agentId, context}):Promise

• HTMLElement là phần tử để khởi chạy dưới dạng một tiện ích.
• {agentId, context} là các giá trị của data-bm-widget-agent-id và data-bm-widget-context thuộc tính HTML.

Quét

Quét tài liệu để tìm bất kỳ phần tử HTML nào có chứa thuộc tính data-bm-widget-agent-id và chuyển đổi các thành phần đó thành Tiện ích Tin nhắn. window.bmwidget.scan() sẽ tự động được gọi khi tải trang và trong quá trình khởi tạo tập lệnh.

window.bmwidget.scan():void

Có thể làm

Cờ boolean chỉ đọc là true nếu thiết bị của người dùng hỗ trợ Business Messages.

window.bmwidget.supported:boolean

Sự kiện

Thư viện kích hoạt các sự kiện trên các phần tử HTML mà thư viện này khởi chạy dưới dạng Các tiện ích của Business Messages.

Liên kết thành công

Sự kiện bm-widget-bind-success sẽ kích hoạt khi một phần tử HTML là liên kết thành công dưới dạng tiện ích Business Messages và đã sẵn sàng để sử dụng.

domNode.addEventListener('bm-widget-bind-success', (event) => {
  console.log(event.data);
});

Không liên kết được

Sự kiện bm-widget-bind-fail kích hoạt khi bạn cố gắng liên kết với một HTML không thành công. Điều này có thể xảy ra do không xác thực được URL hoặc do lỗi chung không lấy được phần tử HTML. Không xác thực được xảy ra nếu url chưa được đăng ký làm mục nhập tiện ích của Business Messages điểm hoặc thiết bị của người dùng không được hỗ trợ. Thông tin chi tiết về thuộc tính event.data nguyên nhân thất bại.

domNode.addEventListener('bm-widget-bind-fail', (event) => {
  console.log(event.data);
});

Điều kiện kích hoạt ý định

Sự kiện bm-widget-intent-trigger kích hoạt khi người dùng nhấn vào một Doanh nghiệp đã khởi tạo Điểm truy cập vào tiện ích Tin nhắn. Sự kiện này báo hiệu một lượt nhấn nhưng không biểu thị liệu giao diện trò chuyện của Business Messages có được khởi chạy thành công hay không.

domNode.addEventListener('bm-widget-intent-trigger', (event) => {
  console.log(event.data);
});