Business Messages 微件

Business Messages widget JavaScript 库以编程方式初始化并 为 Business Messages 微件启用互动跟踪。

函数和属性

函数和属性提供对元素的精细控制 初始化。

Init

动态初始化要用作 Business Messages 微件。该函数返回一个在 初始化已完成。

window.bmwidget.init(HTMLElement, {agentId, context}):Promise
  • HTMLElement 是要初始化为 widget 的元素。
  • {agentId, context}data-bm-widget-agent-id 的值, data-bm-widget-context HTML 属性。

扫描

扫描文档,查找任何包含 data-bm-widget-agent-id 属性,并将这些元素转换为 Business “信息”微件。在网页加载时自动调用 window.bmwidget.scan() 以及脚本初始化期间

window.bmwidget.scan():void

支持

只读布尔标志,如果用户的设备支持,该标志为 true Business Messages。

window.bmwidget.supported:boolean

事件

该库会在初始化为以下内容的 HTML 元素上触发事件: Business Messages 微件。

绑定成功

当 HTML 元素被触发时,bm-widget-bind-success 事件 已成功绑定为 Business Messages 微件,可以使用了。

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

绑定失败

bm-widget-bind-fail 事件会在有人尝试绑定到 HTML 时触发 出现故障。这可能是因为无法验证网址或 导致出现常规错误。验证失败 如果网址尚未注册为 Business Messages 微件条目,则会发生以下情况 或者用户的设备不受支持。 event.data 属性的详细信息 以及失败的原因

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

intent 触发器

当用户点按初始化的商家时,bm-widget-intent-trigger 事件就会触发 “信息”微件入口点。此事件发送点按信号,但不指示 Business Messages 对话界面是否已成功初始化。

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