أنواع رسائل فيسبوك: دليل شامل لأنواع المحتوى

أنواع رسائل الفيسبوك

هناك أنواع مختلفة من المحتوى الخام (غير منظم) الذي يمكن إرساله إلى المستخدمين.

نص

نص
نص
{
type: "TEXT",
text: "مرحبا بالعالم!"
}
نسخ
الخاصيةالوصفمطلوب
typeTEXTنعم
textسلسلة نصية؛ محدود بـ 2000 حرفنعم


صورة

صورة
صورة
{
type: "IMAGE",
url: "http://image.png",
attachment_id: "SomeStringID"
}
نسخ
الخاصيةالوصفمطلوب
typeIMAGEنعم
urlرابط ملف الصورةنعم
attachment_idسلسلة نصية؛ معرف الصورة التي تم تحميلهالا
معلومات
ملاحظة
  • يجب أن تكون الصورة بتنسيق ملف صورة صالح، بما في ذلك .jpg، .jpeg، .png، .gif، .tiff و .bmp
  • الحد الأقصى لحجم الملف هو 2 ميغابايت
  • يمكنك إرسال أزرار الرد السريع مع صورة


صوت

صوت
صوت
{
type: "AUDIO",
url: "http://audio.mp3",
attachment_id: "SomeStringID",
}
نسخ
الخاصيةالوصفمطلوب
typeAUDIOنعم
urlرابط ملف الصوتنعم
attachment_idسلسلة نصية؛ معرف الصوت الذي تم تحميلهلا
معلومات
ملاحظة
  • يجب أن يكون الصوت بتنسيق ملف صوت صالح، بما في ذلك .aac، .flac، .m4a، .m4p، .mp3، .wavو .wma
  • يمكنك إرسال أزرار الرد السريع مع رسالة صوتية


فيديو

فيديو
فيديو
{
type: "VIDEO",
url: "http://video.mp4",
attachment_id: "SomeStringID"
}
نسخ
الخاصيةالوصفمطلوب
typeVIDEOنعم
urlرابط ملف الفيديونعم
attachment_idسلسلة نصية؛ معرف الفيديو الذي تم تحميلهلا
معلومات
ملاحظة
  • يجب أن يكون الفيديو بتنسيق ملف فيديو صالح، بما في ذلك .mkv، .gif، .avi، .wmv، .rmvb، .mp4، .m4v، .mpg، .mpegو .3gp
  • الحد الأقصى لحجم الملف هو 25 ميجابايت
  • يمكنك إرسال أزرار الرد السريع مع رسالة الفيديو


ملف

ملف
ملف
{
type: "FILE",
url: "http://file.pdf",
attachment_id: "SomeStringID",
}
نسخ
الخاصيةالوصفمطلوب
typeFILEنعم
urlرابط الملف المرفقنعم
attachment_idسلسلة نصية؛ معرف الملف الذي تم تحميلهلا
معلومات
ملاحظة
  • يجب أن يكون الملف بتنسيق صالح، بما في ذلك .pdf
  • الحد الأقصى لحجم الملف هو 25 ميجابايت
  • يمكنك إرسال أزرار الرد السريع مع ملف


كاروسيل

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

كاروسيل
كاروسيل
{
type: "CAROUSEL",
carousel: [{
title: "قميص كلاسيكي",
subtitle: "رمادي متوسط\n29.99$",
image_url: "http://img.url",
default_action: {
type: "web_url",
url: "https://zuckstees.com"
},
buttons: [{
type: "web_url",
url: "https://sanuker.com",
title: "عرض التفاصيل"
}, {
type: "postback",
title: "تسوق الآن",
payload: "A_LONG_PAYLOAD_HERE"
}, {
type: "phone_number",
title: "some title 3",
payload: "PHONE_NUMBER"
}]
}],
image_aspect_ratio: "square"
}
نسخ
كائن الاستجابة
الخاصيةالوصفمطلوب
typeCAROUSELنعم
carouselمصفوفة من عناصر الكاروسيل؛ الحد الأقصى 10 عناصرنعم
image_aspect_ratioتعيين "أفقي" (1.91:1) أو "مربع" (1:1)؛ الافتراضي هو "أفقي"لا
كائن الكاروسيل
الخاصيةالوصفمطلوب
titleسلسلة نصية؛ محدودة بـ 80 حرفًانعم
subtitleسلسلة نصية؛ محدودة بـ 80 حرفًالا
image_urlرابط الصورة المعروضةلا
default_actionرابط الموقع الافتراضي عند النقر على الصورةلا
buttonsمصفوفة من الأزرار؛ الحد الأقصى 3 أزرار تظهر كدعوة لاتخاذ إجراءلا
معلومات
ملاحظة
  • يمكنك إرسال أزرار الرد السريع مع كاروسيل
  • قد لا تحتاج بالضرورة إلى تضمين أزرار للكاروسيل إذا لم يكن هناك نية لاتخاذ إجراء


الأزرار

زر
زر
{
type: "BUTTON",
text: "كيف يمكنني المساعدة؟",
buttons: [{
type: "web_url",
url: "https://sanuker.com",
title: "تحقق من حالة الطلب"
}, {
type: "phone_number",
title: "اتصل بي",
payload: "PHONE_NUMBER"
}, {
type: "postback",
title: "some title 2",
payload: "A_LONG_PAYLOAD_HERE"
}]
}
نسخ
الخاصيةالوصفمطلوب
typeBUTTONنعم
textسلسلة نصية؛ محدودة بـ 640 حرفًانعم
buttonsمصفوفة من الأزرار؛ الحد الأقصى 3 أزرار تظهر كدعوة لاتخاذ إجراءنعم

زر عنوان URL

أزرار عنوان URL
أزرار عنوان URL
فتح عرض الويب
فتح عرض الويب

يمكن استخدام زر عنوان URL لفتح صفحة ويب في المتصفح داخل التطبيق. يمكن استخدام هذا الزر مع قالب الأزرار، والعرض الدائري، والقائمة. يمكن عرض عرض الويب بثلاث طرق مختلفة: مضغوط، طويل أو كامل.

{
type: "web_url",
title: "some title",
url: "https://sanuker.com",
webview_height_ratio: "tall",
messenger_extensions: true,
fallback_url: "https://sanuker.com",
webview_share_button: "hide",
urlTracking: false,
}
نسخ
الخاصيةالوصفمطلوب
typeweb_urlنعم
titleسلسلة نصية؛ محدودة بـ 20 حرفًانعم
urlرابط الوجهة؛ يجب أن يكون HTTPS إذا كانت messenger_extensions تساوي "true"نعم
webview_height_ratioارتفاع نافذة عرض الويب؛ اضبطها على "compact" أو "tall" أو "full"؛ القيمة الافتراضية "full"اختياري
fallback_urlرابط للاستخدام على العملاء الذين لا يدعمون امتدادات Messenger؛ اضبطه فقط إذا كانت messenger_extensions تساوي "true"؛ القيمة الافتراضية هي url إذا لم يتم تحديدهااختياري
webview_share_buttonاضبط على "hide" أو اتركه بدون ضبطاختياري
urlTrackingالقيمة الافتراضية "true"اختياري

يمكن تمكين تحليلات URL أثناء إنشاء زر عنوان URL في الاستجابة.

بمجرد أن ينقر المستخدم على زر عنوان URL، سيتم تتبعه وتسجيله في لوحة تحليلات البيانات.



زر الإرجاع

زر الإرجاع

يساعد زر الإرجاع في استدعاء إجراء داخل روبوت الدردشة الخاص بك. يمكنك تعيين حمولة إلى الزر.


{
type: "postback",
title: "some title",
payload: "some payload"
}
نسخ
الخاصيةالوصفمطلوب
typepostbackنعم
titleسلسلة نصية؛ محدودة بـ 20 حرفًانعم
payloadحمولة مخصصة مُعرفة مسبقًا المحفزات؛ محدودة بـ 1,000 حرفنعم


زر الاتصال

زر الاتصال

يمكن استخدام زر الاتصال لبدء مكالمة هاتفية مباشرة.


{
type: "phone_number",
title: "اتصل بنا",
payload: "+85281930208"
}
نسخ
الخاصيةالوصفمطلوب
typephone_numberنعم
titleسلسلة نصية؛ محدودة بـ 20 حرفًانعم
payloadيجب أن يبدأ التنسيق بعلامة "+" تليها رمز الدولة ورمز المنطقة والرقم المحلي بدون فراغاتنعم


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

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

يمكن استخدام زر تسجيل الدخول لربط حساب مستخدم طرف ثالث بـ Facebook Messenger.

{
"type": "account_link",
"url": "https://stella.sanuker.com"
}
نسخ
الخاصيةالوصفمطلوب
typeaccount_linkنعم
urlرابط الوجهة؛ يجب أن يكون HTTPSنعم


الرد السريع

يقدم الرد السريع طريقة مختلفة لعرض الأزرار في رسالة. يحتوي على نص وصورة اختيارية.

الفرق الوحيد بين الرد السريع وزر هو أن الرد السريع يظهر مرة واحدة فقط وسيتم اختفاؤه بمجرد النقر عليه، بينما يظل الزر في الرسالة حتى بعد النقر عليه. هذا يمنع السيناريو حيث يمكن للمستخدمين النقر على أزرار الرد السريع القديمة المرفقة بالرسائل السابقة في المحادثة.

الردود السريعة على فيسبوك
الردود السريعة على فيسبوك
{
type: "QUICK_REPLIES",
text: "some text",
quickReplies: [{
content_type: "text",
title: "Red",
payload: "PAYLOAD_STRING",
image_url: "http://red.img.url"
}, {
content_type: "text",
title: "Green",
payload: "PAYLOAD_STRING",
image_url: "http://green.img.url"
}, {
content_type: "text"
}]
}
نسخ
كائن الاستجابة
الخاصيةالوصفمطلوب
typeQUICK_REPLIESنعم
textنص؛ محدود إلى 2000 حرفنعم
quickRepliesمصفوفة من أزرار الرد السريع؛ بحد أقصى 13 زرنعم
كائن quickReplies
الخاصيةالوصفمطلوب
content_typeتعيين "text"، "user_phone_number" أو "user_email"نعم
titleنص؛ عنوان الزر؛ محدود إلى 20 حرفًافقط إذا كان content_type هو "text"
image_urlرابط الصورة للرد السريع النصيلا
payloadحمل مخصص معرف مشغلات؛ محدود إلى 1000 حرففقط إذا كان content_type هو "text"
Idea
ملاحظة
  • يجب أن تكون الصورة لـ image_url على الأقل 24×24 وسيتم اقتصاصها وتغيير حجمها.
  • إذا لم يكن لدى المستخدم رقم هاتف أو بريد إلكتروني في الملف الشخصي، فلن يتم عرض زر الرد السريع "user_phone_number" و "user_email".


الوسائط

الوسائط تشبه الكاروسيل ولكن بدون عنوان أو وصف فرعي، ويمكنها أيضًا عرض الفيديو.

وسائط فيسبوك
وسائط فيسبوك
{
type: "MEDIA",
media_type: "image",
attachment_id: "attachmentId",
buttons: [{
type: "postback",
title: "أرني المزيد!",
payload: "A_LONG_PAYLOAD_HERE"
}]
}
نسخ
الخاصيةالوصفمطلوب
typeMEDIAنعم
media_typeتعيين "image" أو "video"نعم
attachment_idنص؛ معرف الملف الذي قمت بتحميلهنعم
buttonsصفيف من الأزرار؛ بحد أقصى 3 أزرار تظهر كدعوة لاتخاذ إجراءلا
معلومات
ملاحظة
  • يمكنك إرسال أزرار الرد السريع مع قالب الوسائط


الرد العام

الرد العام يشير إلى الرد على تعليقات المستخدمين على منشور فيسبوك.

رد فيسبوك العام
رد فيسبوك العام
{
type: "PUBLIC_REPLY",
text: "some text",
attachment_id: "attachmentId",
attachment_url: "https://img.url"
}
نسخ
الخاصيةالوصفمطلوب
typePUBLIC_REPLYنعم
textنص؛ محدود بـ 5000 حرفيجب تعيين إما النص أو attachment_id أو attachment_url
attachment_idنص؛ معرف ملف الوسائط الذي قمت بتحميلهيجب تعيين إما النص أو attachment_id أو attachment_url
attachment_urlرابط الملف الذي تريد نشرهيجب تعيين إما النص أو attachment_id أو attachment_url


أنواع الرسائل

تدعم Meta ثلاثة أنواع من الرسائل لضمان امتثال الرسائل المرسلة لسياسات الرسائل وتفضيلات المستلم.

يرجى الرجوع إلى هنا لمزيد من التفاصيل حول أنواع الرسائل.

رد

{  
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "RESPONSE"
  },
  "text": "Test Text"
}
نسخ

التحديثات

{  
  "type": "TEXT",
  "messagingMeta": {
    "messaging_type": "UPDATE"
  },
  "text": "Test Text"
}
نسخ

علامة الرسالة

{  
  "type": "TEXT",
  "messagingMeta": {
    "tag": "ACCOUNT_UPDATE",
    "messaging_type": "MESSAGE_TAG"
  },
  "text": "Test Text"
}
نسخ
الخاصيةالوصف
tagواحدة من هذه: ACCOUNT_UPDATE, CONFIRMED_EVENT_UPDATE, CUSTOMER_FEEDBACK أو HUMAN_AGENT