ספריית ה-JavaScript של הווידג'ט של Business Messages מפעילה אותו באופן פרוגרמטי מפעילה מעקב אחר אינטראקציות בווידג'טים של Business Messages.
פונקציות ומאפיינים
פונקציות ומאפיינים מספקים שליטה פרטנית על הרכיב באתחול.
Init
מאתחל באופן דינמי רכיב HTML שישמש הווידג'ט של Business Messages. הפונקציה מחזירה הבטחה שניתנת לפתרון האתחול הושלם.
window.bmwidget.init(HTMLElement, {agentId, context}):Promise
HTMLElementהוא הרכיב לאתחול כווידג'ט.{agentId, context}הם הערכים שלdata-bm-widget-agent-idוגםdata-bm-widget-contextמאפייני HTML.
סריקה
סריקת המסמך לאיתור רכיבי HTML שמכילים
data-bm-widget-agent-id וממיר את הרכיבים האלה ל'עסק'
ווידג'טים של 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
הרכיב נכשל. הדבר עשוי לקרות בגלל כשל באימות כתובת האתר או
בגלל כשל כללי בקבלת רכיב ה-HTML. האימות נכשל
אם כתובת ה-URL לא נרשמה כרשומה בווידג'ט של Business Messages
או שהמכשיר של המשתמש אינו נתמך.
פרטי הנכס event.data
הגורם לכשל.
domNode.addEventListener('bm-widget-bind-fail', (event) => {
console.log(event.data);
});
טריגר של Intent
האירוע bm-widget-intent-trigger מופעל כשמשתמש מקיש על עסק שהופעל
נקודת הכניסה לווידג'ט של Messages. האירוע הזה מציין הקשה, אבל הוא לא מציין
אם פלטפורמת השיחה של Business Messages הופעלה.
domNode.addEventListener('bm-widget-intent-trigger', (event) => {
console.log(event.data);
});