ویجت پیام های تجاری

کتابخانه جاوا اسکریپت ویجت Business Messages به صورت برنامه نویسی مقداردهی اولیه می کند و ردیابی تعامل را برای ویجت های Business Messages فعال می کند.

توابع و خواص

توابع و خصوصیات کنترل دقیقی را بر روی مقداردهی اولیه عنصر فراهم می کنند.

شروع کنید

به صورت پویا یک عنصر HTML را برای استفاده به عنوان ویجت پیام های تجاری مقداردهی اولیه می کند. تابع قولی را برمی‌گرداند که پس از تکمیل اولیه حل می‌شود.

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

• HTMLElement عنصری است که به عنوان یک ویجت مقداردهی اولیه می شود.
• {agentId, context} مقادیری برای ویژگی‌های HTML data-bm-widget-agent-id و data-bm-widget-context هستند.

اسکن کنید

سند را برای هر عنصر HTML که حاوی ویژگی data-bm-widget-agent-id اسکن می‌کند و آن عناصر را به ویجت‌های Business Messages تبدیل می‌کند. window.bmwidget.scan() به طور خودکار در بارگذاری صفحه و در طول مقداردهی اولیه اسکریپت فراخوانی می شود.

window.bmwidget.scan():void

پشتیبانی می شود

اگر دستگاه کاربر از Business Messages پشتیبانی کند، پرچم بولین فقط خواندنی درست است.

window.bmwidget.supported:boolean

رویدادها

این کتابخانه رویدادهایی را در عناصر HTML فعال می‌کند و به عنوان ابزارک‌های Business Messages مقداردهی اولیه می‌کند.

موفقیت را مقید کنید

رویداد bm-widget-bind-success زمانی فعال می‌شود که یک عنصر HTML با موفقیت به‌عنوان ویجت Business Messages متصل شده و برای استفاده آماده باشد.

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

اتصال شکست

رویداد bm-widget-bind-fail زمانی فعال می‌شود که تلاش برای اتصال به یک عنصر HTML با شکست مواجه شود. این ممکن است به دلیل عدم تأیید اعتبار URL یا به دلیل شکست کلی در دریافت عنصر HTML رخ دهد. در صورتی که نشانی وب به عنوان نقطه ورود ویجت پیام‌های تجاری ثبت نشده باشد یا دستگاه کاربر پشتیبانی نشود، تأیید نشدن اتفاق می‌افتد. ویژگی event.data علت خرابی را شرح می دهد.

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

ماشه قصد

رویداد bm-widget-intent-trigger زمانی فعال می‌شود که کاربر روی نقطه ورودی ویجت Business Messages اولیه ضربه می‌زند. این رویداد یک ضربه را نشان می‌دهد اما نشان نمی‌دهد که سطح مکالمه Business Messages با موفقیت راه‌اندازی شده است یا خیر.

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