API الملف الشخصي في Messenger

الملف الشخصي لصفحتك في Messenger هو المكان الذي تقوم فيه بتعيين الخصائص التي تحدد الجوانب المختلفة لميزات منصة Messenger التالية. لمزيد من المعلومات، راجع جدول خصائص الملف الشخصي في Messenger أدناه.

• زر بدء الاستخدام
• صفحة الترحيب
• أدوات تشجيع التفاعل
• القائمة الثابتة
• قائمة النطاق البيضاء
• ربط الحساب
• الأوامر
• علامة التبويب "استكشاف" (تم إيقاف الاستخدام)

تتيح لك API الملف الشخصي في Messenger تعيين الخصائص وتحديثها واستردادها وحذفها من صفحة الملف الشخصي في Messenger.

الأذونات

يلزم توفير رمز وصول الصفحة مع الإذن pages_messaging للتفاعل مع نقطة النهاية هذه.

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

المحتويات

• محدد URI للطلب
• خصائص الملف الشخصي في Messenger
• استرداد الخصائص
• تعيين/تحديث الخصائص
• حذف الخصائص
• تقييد معدلات الاستدعاء

محدد URI للطلب

https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

خصائص الملف الشخصي في Messenger

يمكن تضمين الخصائص التالية في الملف الشخصي لصفحتك في Messenger. راجع الأوصاف في الجدول أدناه للتعرف على نوع كل خاصية والغرض منها.

استرداد الخصائص

يمكن استرداد القيمة الحالية لواحدة من خصائص الملف الشخصي في Messenger أو أكثر حسب الاسم.

معلمات الطلب

يتم تضمين المعلمات التالية في سلسلة الاستعلام الخاصة بالطلب:

مثال على الطلب

curl -X GET "https://graph.facebook.com/v19.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

مثال على الاستجابة

سيتم إرجاع القيمة الحالية للخصائص المطلوبة ضمن مصفوفة data:

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

تعيين/تحديث الخصائص

يمكن تعيين القيم لواحدة من خصائص الملف الشخصي في Messenger أو أكثر. وسيتم استبدال الخصائص التي تم تعيينها في نص الطلب فقط.

مثال على الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v18.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

مثال على الاستجابة

{
    "result": "success"
}

حذف الخصائص

يمكن حذف واحدة من خصائص الملف الشخصي في Messenger أو أكثر. وسيتم حذف الخصائص المحددة ضمن مصفوفة fields فقط.

مثال على الطلب

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

مثال على الاستجابة

{
    "result": "success"
}