วิดเจ็ต Business Messages

ไลบรารี JavaScript ของวิดเจ็ต Business Messages จะเริ่มต้นโปรแกรมโดยอัตโนมัติ และ เปิดใช้การติดตามการมีส่วนร่วมสำหรับวิดเจ็ต Business Messages

ฟังก์ชันและคุณสมบัติ

ฟังก์ชันและพร็อพเพอร์ตี้มอบการควบคุมองค์ประกอบแบบละเอียด การเริ่มต้น

Init

เริ่มต้นองค์ประกอบ HTML แบบไดนามิกเพื่อใช้เป็น วิดเจ็ต Business Messages ฟังก์ชันจะแสดงสัญญาที่จะแก้ไขปัญหาเมื่อ การเริ่มต้นเสร็จสมบูรณ์

window.bmwidget.init(HTMLElement, {agentId, context}):Promise
  • HTMLElement คือองค์ประกอบที่จะเริ่มต้นเป็นวิดเจ็ต
  • {agentId, context} คือค่าสำหรับ data-bm-widget-agent-id และ แอตทริบิวต์ HTML data-bm-widget-context

สแกน

สแกนเอกสารเพื่อหาองค์ประกอบ HTML ที่มีองค์ประกอบ data-bm-widget-agent-id แล้วแปลงองค์ประกอบเหล่านั้นเป็น "ธุรกิจ" วิดเจ็ตข้อความ ระบบจะเรียก 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 ไม่สำเร็จ ตรวจสอบไม่สำเร็จ จะเกิดขึ้นหากไม่ได้ลงทะเบียน URL เป็นรายการวิดเจ็ต Business Messages Point หรืออุปกรณ์ของผู้ใช้ไม่ได้รับการสนับสนุน รายละเอียดที่พัก 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);
});