‏منصة Messenger‏

المكون الإضافي "إرسال إلى Messenger"

عندما يكون تطبيق فيسبوك لديك في وضع التطوير، لن تعمل وظائف المكون الإضافي وAPI إلا للمسؤولين والمطوّرين والمختبرين في التطبيق الذين تتوفر لديهم جلسة صالحة. وبعد الانتهاء من اعتماد تطبيقك وطرحه بشكل عام، يصبح متوفرًا للعامة.

يتم استخدام المكون الإضافي "إرسال إلى Messenger" لتشغيل حدث مصادقة في حدث webhook لديك. ويمكنك إدخال البيانات لمعرفة المستخدم والمعاملة التي تم ربطها بحدث المصادقة، وربط المستخدم في الواجهة الخلفية.

في المرة الأولى التي ينقر فيها شخص ما على هذا الزر، سيتم عرض إشعار منبثق للتأكيد.

المتطلبات

مجموعة Javascript SDK في فيسبوك

لاستخدام المكون الإضافي "إرسال إلى Messenger"، يجب تضمين مجموعة Javascript SDK في فيسبوك في الصفحة حيث سيتم عرض المكون الإضافي.

للحصول على إرشادات حول تضمين مجموعة SDK، راجع البدء السريع لمجموعة Javascript SDK في فيسبوك.

الإعداد

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

للحصول على وصف كامل للسمات المتوفرة، يمكنك الرجوع إلى مرجع المكون الإضافي "إرسال إلى Messenger".

الاشتراك في الحدث

يمكنك الاشتراك في أحداث المكون الإضافي.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

حقول الحدث

اسم الحقل النوع الوصف

event

Enum (تعداد)

اسم الحدث. القيم المحتملة: rendered وclicked وnot_you وopt_in.

ref

String (سلسلة)

يحتوي على مجموعة القيم في المعلمة data-ref ضمن المكون الإضافي. يتم دعم الأحرف الأبجدية الرقمية فقط بالإضافة إلى - و_ و=.

is_after_optin

Boolean (قيمة منطقية)

تشير إلى ما إذا كان الحدث قد وقع بعد تأكيد إشعار التأكيد المنبثق.

pluginID

غير محدد

لم يتم استخدام هذا الحقل.

حدث Webhook

يعمل المكون الإضافي "إرسال إلى Messenger" على تشغيل حدث webhook لـ messaging_optins.

تخصيص سلوك تسجيل الدخول

إذا لم يتواجد مستخدم فيسبوك قيد تسجيل الدخول، فسيتم عرض المكون الإضافي من دون عرض هوية المستخدم. وسيؤدي النقر على الزر إلى مطالبة المستخدم بتسجيل الدخول.

إذا تم تعيين allow_login على false، فلن يتم عرض المكون الإضافي للمستخدمين الذين لم يسجلوا الدخول.

لاحظ أنه سيتم عرض المكون الإضافي من دون جلسة فيسبوك فقط إذا تمت الموافقة على التطبيق ونشره للعامة.

خيارات نص الدعوى لاتخاذ إجراء

يدعم أيضًا المكون الإضافي "إرسال إلى Messenger" السمة cta_text. ويتيح لك ذلك اختيار نص الزر للمكون الإضافي من قائمة تتضمن سلاسل محددة مسبقًا. عند استخدام السمة cta_text، لن يحتاج معظم المستخدمين الذين سجلوا الدخول سوى النقر على زر المكون الإضافي ذاته للاشتراك، من دون الحاجة إلى إعادة التأكيد من خلال الإشعار المنبثق، وسيتم تسليم الحدث messaging_optins على الفور.

القيم التالية مدعومة بالنسبة للسمة cta_text:

  • GET_THIS_IN_MESSENGER
  • RECEIVE_THIS_IN_MESSENGER
  • SEND_THIS_TO_ME
  • GET_CUSTOMER_ASSISTANCE
  • GET_CUSTOMER_SERVICE
  • GET_SUPPORT
  • LET_US_CHAT
  • SEND_ME_MESSAGES
  • ALERT_ME_IN_MESSENGER
  • SEND_ME_UPDATES
  • MESSAGE_ME
  • LET_ME_KNOW
  • KEEP_ME_UPDATED
  • TELL_ME_MORE
  • SUBSCRIBE_IN_MESSENGER
  • SUBSCRIBE_TO_UPDATES
  • GET_MESSAGES
  • SUBSCRIBE
  • GET_STARTED_IN_MESSENGER
  • LEARN_MORE_IN_MESSENGER
  • GET_STARTED