هناك أنواع مختلفة من المحتوى الخام (غير منظم) الذي يمكن إرساله إلى المستخدمين.
{
type: "TEXT",
text: "مرحبا بالعالم!"
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | TEXT | نعم |
text | سلسلة نصية؛ محدود بـ 2000 حرف | نعم |
صورة
الخاصية | الوصف | مطلوب |
---|
type | IMAGE | نعم |
url | رابط ملف الصورة | نعم |
attachment_id | سلسلة نصية؛ معرف الصورة التي تم تحميلها | لا |
- يجب أن تكون الصورة بتنسيق ملف صورة صالح، بما في ذلك
.jpg
، .jpeg
، .png
، .gif
، .tiff
و .bmp
- الحد الأقصى لحجم الملف هو 2 ميغابايت
- يمكنك إرسال أزرار الرد السريع مع صورة
صوت
الخاصية | الوصف | مطلوب |
---|
type | AUDIO | نعم |
url | رابط ملف الصوت | نعم |
attachment_id | سلسلة نصية؛ معرف الصوت الذي تم تحميله | لا |
- يجب أن يكون الصوت بتنسيق ملف صوت صالح، بما في ذلك
.aac
، .flac
، .m4a
، .m4p
، .mp3
، .wav
و .wma
- يمكنك إرسال أزرار الرد السريع مع رسالة صوتية
فيديو
الخاصية | الوصف | مطلوب |
---|
type | VIDEO | نعم |
url | رابط ملف الفيديو | نعم |
attachment_id | سلسلة نصية؛ معرف الفيديو الذي تم تحميله | لا |
- يجب أن يكون الفيديو بتنسيق ملف فيديو صالح، بما في ذلك
.mkv
، .gif
، .avi
، .wmv
، .rmvb
، .mp4
، .m4v
، .mpg
، .mpeg
و .3gp
- الحد الأقصى لحجم الملف هو 25 ميجابايت
- يمكنك إرسال أزرار الرد السريع مع رسالة الفيديو
ملف
الخاصية | الوصف | مطلوب |
---|
type | FILE | نعم |
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"
}
نسخ
كائن الاستجابة
الخاصية | الوصف | مطلوب |
---|
type | CAROUSEL | نعم |
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"
}]
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | BUTTON | نعم |
text | سلسلة نصية؛ محدودة بـ 640 حرفًا | نعم |
buttons | مصفوفة من الأزرار؛ الحد الأقصى 3 أزرار تظهر كدعوة لاتخاذ إجراء | نعم |
زر عنوان 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,
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | web_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"
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | postback | نعم |
title | سلسلة نصية؛ محدودة بـ 20 حرفًا | نعم |
payload | حمولة مخصصة مُعرفة مسبقًا المحفزات؛ محدودة بـ 1,000 حرف | نعم |
زر الاتصال
يمكن استخدام زر الاتصال لبدء مكالمة هاتفية مباشرة.
{
type: "phone_number",
title: "اتصل بنا",
payload: "+85281930208"
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | phone_number | نعم |
title | سلسلة نصية؛ محدودة بـ 20 حرفًا | نعم |
payload | يجب أن يبدأ التنسيق بعلامة "+" تليها رمز الدولة ورمز المنطقة والرقم المحلي بدون فراغات | نعم |
زر تسجيل الدخول
يمكن استخدام زر تسجيل الدخول لربط حساب مستخدم طرف ثالث بـ Facebook Messenger.
الخاصية | الوصف | مطلوب |
---|
type | account_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"
}]
}
نسخ
كائن الاستجابة
الخاصية | الوصف | مطلوب |
---|
type | QUICK_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" |
- يجب أن تكون الصورة لـ 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"
}]
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | MEDIA | نعم |
media_type | تعيين "image" أو "video" | نعم |
attachment_id | نص؛ معرف الملف الذي قمت بتحميله | نعم |
buttons | صفيف من الأزرار؛ بحد أقصى 3 أزرار تظهر كدعوة لاتخاذ إجراء | لا |
- يمكنك إرسال أزرار الرد السريع مع قالب الوسائط
الرد العام
الرد العام يشير إلى الرد على تعليقات المستخدمين على منشور فيسبوك.
{
type: "PUBLIC_REPLY",
text: "some text",
attachment_id: "attachmentId",
attachment_url: "https://img.url"
}
نسخ
الخاصية | الوصف | مطلوب |
---|
type | PUBLIC_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 |