الأزرار

تدعم معظم قوالب الرسائل، بالإضافة إلى القائمة الثابتة، الأزرار التي تعمل على استدعاء أنواع مختلفة من الإجراءات. تتيح لك هذه الأزرار إمكانية توفير إجراءات لمستلم الرسالة يمكنه القيام بها كاستجابة للقالب، مثل فتح Messenger webview وبدء دفق الدفع وإرسال رد جاهز إلى webhook الذي تستخدمه وغير ذلك.

بالنسبة إلى قوالب الرسائل، يتم تحديد الأزرار عن طريق الكائنات الموجودة في المصفوفة buttons. أما بالنسبة إلى القائمة الثابتة، يتم تحديد الأزرار عن طريق الكائنات الموجودة في المصفوفة call_to_actions.

زر عنوان URL

يفتح زر URL صفحة ويب في طريقة عرض الويب في Messenger. يتيح لك ذلك إثراء المحادثة بتجربة تستند إلى الويب حيث تتوفر لك مرونة التطوير التي يتميز بها الويب. على سبيل المثال، يمكنك عرض ملخص منتج داخل المحادثة ثم استخدام زر عنوان URL لفتح صفحة المنتج الكاملة في موقعك على الويب.

روابط التطبيق

إذا كان الموقع يحتوي على روابط التطبيق، فسيعمل الزر على تشغيل التطبيق الأصلي المحدد.

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

الاستخدام المدعوم

يتم دعم زر عنوان URL للاستخدام مع ما يلي:

• القائمة الثابتة
• القالب العام
• قالب القائمة
• قالب الزر
• قالب الوسائط

مجموعة SDK لملحقات Messenger - عملية إضافة النطاق إلى القائمة البيضاء المطلوبة

تنسيق الزر

للحصول على قائمة كاملة تتضمن خصائص الزر، راجع مرجع زر عنوان URL.

{
  "type": "web_url",
  "url": "

زر الرد

يرسل زر الرد حدث messaging_postbacks إلى حدث webhook مع تعيين السلسلة في الخاصية payload. يتيح لك ذلك إمكانية اتخاذ إجراءات عشوائية عند الضغط على الزر. على سبيل المثال، يمكنك عرض قائمة منتجات، ثم إرسال معرف المنتج في الرد الجاهز إلى webhook، حيث يمكن استخدامه لإجراء استعلام إلى قاعدة بياناتك وعرض تفاصيل المنتج كرسالة ذات بنية محددة.

الاستخدام المدعوم

يتم دعم زر الرد الجاهز للاستخدام مع ما يلي:

• القائمة الثابتة
• القالب العام
• قالب القائمة
• قالب الزر
• قالب الوسائط

تنسيق الزر

للحصول على قائمة كاملة تتضمن خصائص الزر، راجع مرجع زر الرد الجاهز.

{
  "type": "postback",
  "title": "

زر الاتصال

يتصل زر الاتصال برقم هاتفي عند الضغط عليه. يجب أن يكون رقم الهاتف بالتنسيق +<COUNTRY_CODE><PHONE_NUMBER>، مثال +15105559999.

الاستخدام المدعوم

يتم دعم زر الاتصال للاستخدام مع ما يلي:

• القالب العام
• قالب القائمة
• قالب الزر
• قالب الوسائط

تنسيق الزر

للتعرف على قائمة كاملة بخصائص الزر، راجع مرجع زر الاتصال.

{
  "type":"phone_number",
  "title":"

زر تسجيل الدخول

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

لمزيد من المعلومات حول استخدام زر تسجيل الدخول لربط الحساب، راجع ربط الحساب.

الاستخدام المدعوم

يتم دعم زر تسجيل الدخول للاستخدام مع ما يلي:

• القالب العام
• قالب القائمة
• قالب الزر
• قالب الوسائط

تنسيق الزر

للحصول على قائمة كاملة تتضمن خصائص الزر، راجع مرجع زر تسجيل الدخول.

{
  "type": "account_link",
  "url": "

زر تسجيل الخروج

يتم استخدام زر تسجيل الخروج في دفق ربط الحساب لإلغاء ربط هوية مستلم الرسالة على Messenger بالحساب في الموقع.

لمزيد من المعلومات حول استخدام زر تسجيل الخروج لإلغاء ربط الحساب، راجع ربط الحساب.

الاستخدام المدعوم

يتم دعم زر تسجيل الخروج للاستخدام مع ما يلي:

• القالب العام
• قالب القائمة
• قالب الزر
• قالب الوسائط

تنسيق الزر

للحصول على قائمة كاملة تتضمن خصائص الزر، راجع مرجع زر تسجيل الخروج.

{
  "type": "account_unlink"
}

زر تشغيل اللعبة

يُستخدم زر تشغيل اللعبة لبدء تشغيل لعبة فورية مرتبطة بصفحتك على فيسبوك. لتخصيص كيفية فتح اللعبة، يمكنك تعيين خاصية payload في الطلب الذي سيتم إرساله إلى اللعبة عند التشغيل، بالإضافة إلى خاصية game_metadata.player_id أو game_metadata.context_id اختيارية، مما يسمح للبرنامج التلقائي ببدء اللعبة في سياق محدد بالنسبة للاعب فردي أو مجموعة موجودة.

تنسيق الزر

يجب أن تكون الخاصية payload عبارة عن سلسلة بلغة JSON. يمكن إلغاء تسلسلها باستخدام مجموعة SDK الألعاب الفورية.

للحصول على قائمة كاملة تتضمن خصائص الزر، راجع مرجع زر تشغيل اللعبة.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

يمكنك الرجوع إلى حدث webhook تشغيل اللعبة لمعرفة الحدث الذي سيتم إرساله إلى البرنامج التلقائي عندما ينهي المستخدم جولة ما داخل اللعبة.

أفضل الممارسات