أداة "الرسائل التجارية"

تُجري مكتبة JavaScript للتطبيق المصغّر لميزة "الرسائل التجارية" إعدادًا آليًا يتيح تتبُّع التفاعل في تطبيقات "الرسائل التجارية" المصغّرة

الدوال والخصائص

توفر الدوال والخصائص إمكانية تحكم أكثر دقة في العنصر التهيئة.

Init

يقوم بتهيئة عنصر HTML ديناميكيًا لاستخدامه كـ تطبيق "الرسائل التجارية" المصغّر تُرجع الدالة وعدًا يتم حله عندما اكتملت عملية الإعداد.

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 وتحوّل هذه العناصر إلى نشاط تجاري التطبيقات المصغّرة في تطبيق "الرسائل" يتم استدعاء window.bmwidget.scan() تلقائيًا عند تحميل الصفحة وأثناء تهيئة النص البرمجي.

window.bmwidget.scan():void

معلومات معتمَدة

علامة منطقية للقراءة فقط تكون صحيحة إذا كان جهاز المستخدم متوافقًا الرسائل التجارية

window.bmwidget.supported:boolean

فعاليات

تشغل المكتبة الأحداث على عناصر HTML التي تتم تهيئتها كـ التطبيقات المصغّرة في ميزة "الرسائل التجارية"

تم الربط بنجاح

يتم تشغيل حدث bm-widget-bind-success عندما يكون عنصر HTML تم ربطها بنجاح كأداة في ميزة "الرسائل التجارية" وجاهزة للاستخدام.

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

تعذّر الربط

يتم تشغيل حدث bm-widget-bind-fail عند محاولة الربط بملف HTML. . وقد يحدث هذا بسبب تعذُّر التحقق من عنوان URL أو بسبب إخفاق عام في الحصول على عنصر HTML. تعذّر التحقّق من الصحة إذا لم يتم تسجيل عنوان URL كإدخال في أداة "الرسائل التجارية" هذه النقطة أو جهاز المستخدم غير متوافق. تفاصيل الموقع على "event.data" سبب الفشل.

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

مشغِّل الهدف

يتم تشغيل حدث bm-widget-intent-trigger عندما ينقر المستخدم على نشاط تجاري تم إعداده. نقطة دخول التطبيق المصغّر في "الرسائل" يشير هذا الحدث إلى نقرة، ولكنه لا يشير إلى ذلك. ما إذا تم إعداد مساحة المحادثة في "الرسائل التجارية" بنجاح

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