تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

واجهة برمجة التطبيقات (API) للملف الشخصي في Messenger: التحية وزر Get Started وكاسرات الجليد والقائمة الثابتة

يُضبط الملف الشخصي لـ Messenger لصفحة Facebook عبر نقطة النهاية (endpoint) /{page-id}/messenger_profile، باستخدام رمز الوصول (token) الخاص بالصفحة مع صلاحية pages_messaging. يكتب طلب POST خصائص مثل get_started، greeting، ice_breakers، persistent_menu، commands، ويقرأ GET الخصائص المحددة في fields، ويحذف DELETE الخصائص التي تذكرها مصفوفة fields. تسمح Meta بـ 10 استدعاءات كل 10 دقائق لكل صفحة، ولا يُستبدل إلا ما يُرسل من الخصائص.

يرد easyCoexistence على محادثات Messenger الخاصة بالصفحة بـ send_social_dm ضمن نافذة 24 ساعة، من Claude وChatGPT أو من كودك الخاص، مع تمرير الرسائل الجديدة إلى نقطة النهاية الخاصة بك فور وصولها.

10 per 10 min

عدد استدعاءات Messenger Profile API المسموح بها لكل صفحة في كل فترة زمنية مدتها 10 دقائق.

4 questions

أكبر عدد من كاسرات الجليد التي تضبطها API؛ وعند ضبط الاثنين معاً تسبق كاسرات الجليد التي تضبطها API زر Get Started.

20 items

أكبر عدد من العناصر في القائمة الثابتة على المستوى الأعلى؛ يقتصر عنوان كل عنصر على 30 حرفاً.

24 hours

المدة التي قد يستغرقها تحديث القائمة الثابتة على مستوى الصفحة؛ والقائمة المضبوطة لشخص واحد تتحدث فوراً.

Deprecated

نص التحية، وتقول مرجعية Meta إنه لم يعد يعمل في Messenger على Android وiOS.

ما الذي يتضمنه الملف الشخصي لـ Messenger؟

الإعدادات التي تبدأ منها تجربة Messenger في الصفحة. تسرد واجهة Messenger Profile API هذه الخصائص، ويُضبط كل منها ويُقرأ على نقطة النهاية نفسها؛ وفي تطبيق في وضع التطوير لا تظهر الإعدادات إلا للأشخاص الذين لديهم دور في التطبيق:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

كيف تُقرأ الخصائص وتُضبط وتُحذف؟

بثلاث طرق على نقطة نهاية واحدة، وتُستدعى برمز وصول الصفحة. يأخذ POST نصاً بصيغة JSON من الخصائص ويستبدل ما يسمّيه فقط، ويأخذ GET الحقول مفصولة بفواصل، ويأخذ DELETE نصاً بصيغة JSON تحدد مصفوفة fields فيه ما يُحذف، ويعيد POST وDELETE الحقل result بالقيمة success. ضبط زر Get Started والقائمة في استدعاء واحد:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

كيف يعمل زر Get Started؟

يظهر على شاشة الترحيب، التي تعرض اسم الصفحة وصورتها الشخصية وصورة الغلاف والمدة التي يستغرقها النشاط التجاري عادةً للرد. عند النقر ينشر Get Started في المحادثة، ويرسل get_started.payload إلى التطبيق كحدث messaging_postbacks، ويفتح نافذة المراسلة المعتادة. تنبّه Meta إلى أن الزر غير مدعوم عندما يعمل Messenger داخل المتصفح المدمج في تطبيق Facebook، والقائمة الثابتة تحتاج إلى ضبطه أولاً.

هل ما زالت التحية تعمل؟

ليس على الهواتف. عنوان مرجع Meta الآن هو [Deprecated] Greeting Text: لم تعد الميزة تعمل في Messenger على Android وiOS، وقد تقبل الواجهة خاصية greeting، لكن العملاء لن يرونها، لذلك تطلب Meta من المطورين تجنبها. وكما هو موثق، تحمل greeting نصاً واحداً لكل locale والافتراضي مطلوب، بحد أقصى 160 حرفاً، ويمكن تخصيصه بـ {{user_first_name}} أو {{user_last_name}} أو {{user_full_name}}، ويحتاج ضبطه إلى دور المسؤول (Administrator) على الصفحة.

كيف تعمل كاسرات الجليد؟

تعرض حتى 4 أسئلة يمكن للشخص النقر عليها لبدء محادثة؛ يُنشر السؤال في المحادثة كأن الشخص هو من طرحه، ويعود payload الخاص به كحدث postback. ومنذ أبريل 2022 صارت مترجمة: يحتوي كل عنصر في ice_breakers على call_to_actions وlocale، واللغة الافتراضية مطلوبة، وحذف ice_breakers يزيل الكل بطلب DELETE. ترتّب Meta العناصر المتنافسة على محادثة جديدة:

  • تتقدم كاسرات الجليد التي تضبطها API على زر Get Started عندما يُضبط الاثنان.
  • وكلاهما يسبق الأسئلة المخصصة التي تُضبط في صندوق الوارد بالصفحة، ويُعطَّل تحريرها طالما كانت كاسرات الجليد عبر API مضبوطة.

كيف تُبنى القائمة الثابتة؟

مصفوفة من القوائم، واحدة لكل locale والافتراضي مطلوب، تحتوي كل واحدة على 20 call_to_actions كحد أقصى من النوع web_url أو postback. يتسع العنوان لـ 30 حرفاً، وحمولة postback لـ 1,000 حرف، وضبط composer_input_disabled على true يجعل القائمة والأزرار والنوافذ webviews الطريقة الوحيدة للتفاعل. شروط Meta قبل أن تظهر:

  • زر Get Started مضبوط مسبقاً، وإذن pages_messaging.
  • صفحة منشورة، والتطبيق مضبوط على عام (public).
  • دور المسؤول على الصفحة لمن يضبطها.
  • Messenger بالإصدار v106 أو أحدث على iOS أو Android، خارج المتصفح المدمج في تطبيق Facebook.
  • التغييرات على مستوى الصفحة قد تستغرق حتى 24 ساعة؛ أما القائمة لشخص واحد، المضبوطة عبر custom_user_settings مع PSID، فتتحدث فوراً.

ما هي الأوامر؟

كلمات مفتاحية يمكن للشخص استدعاؤها في أي وقت من قائمة الأوامر بجانب حقل الكتابة، بكتابة شرطة مائلة أو علامة @، أو من نافذة منبثقة عندما يكتب كلمة مطابقة. تحتوي كل locale على 1 إلى 100 أمر، باسم من 1 إلى 32 حرفاً دون شرطة مائلة في البداية، ووصف من 1 إلى 64 حرفاً؛ وعند ضبط الأوامر تتقدم على القائمة الثابتة. تصل الأوامر المستدعاة إلى التطبيق داخل حدث messages في message.commands.

ما وظيفة whitelisted_domains وaccount_linking_url؟

كلاهما يخدم تجربة خارج المحادثة نفسها. يسرد whitelisted_domains حتى 50 نطاقاً يحق لنافذة Messenger webview أن تفتحها من أجل Messenger Extensions SDK ومكوّن checkbox plugin، ويجب أن يُقدَّم كل منها عبر HTTPS باسم نطاق كامل، لا عنوان IP ولا localhost، ويحتاج ضبطه إلى دور المسؤول على الصفحة. أما account_linking_url فهو رابط الاستدعاء (callback) عبر HTTPS الذي يربط حساب الشخص في Messenger بحسابه لدى النشاط التجاري.

كيف يضبط easyCoexistence الملف الشخصي لصفحة Facebook في Messenger؟

لا يفعل: لا توجد أداة تستدعي {page-id}/messenger_profile، ولا تُسلَّم رموز الصفحات، لذا فضبط الملف الشخصي خارج نطاق هذا الاتصال. تصل الأوامر التي يستدعيها الأشخاص في حدث messages الذي يمرره easyCoexistence وتقرؤه الأتمتة. أما النقرات التي تبلغ عنها Meta كأحداث messaging_postbacks، من Get Started وعناصر القائمة الثابتة من نوع postback وكاسرات الجليد، فلا تُمرَّر، لأن الصفحات مشتركة في feed وmessages وmention.

الأخطاء الشائعة

  • ضبط القائمة الثابتة قبل Get Started. تشترط Meta وجود زر Get Started، لذا اضبط get_started أولاً.
  • نسيان اللغة الافتراضية. كاسرات الجليد والقوائم والأوامر تحتاج كلٌ منها إلى عنصر بقيمة locale تساوي default كاحتياطي.
  • استدعاء واجهة الملف الشخصي داخل حلقة تكرار. تسمح Meta بـ 10 استدعاءات كل 10 دقائق لكل صفحة، لذا ضع عدة خصائص في طلب POST واحد.
  • توقّع ظهور تغيير القائمة فوراً. قد يستغرق تحديث القائمة على مستوى الصفحة حتى 24 ساعة ليصل إلى الأشخاص.
إنجاز ذلك باستخدام EasyCoexistence

ضبط الملف الشخصي لـ Messenger ليس من بين أدواته. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام تبدأ من أول اتصال.

الأسئلة الشائعة

هل يمكن أن تختلف القائمة الثابتة من شخص لآخر؟

نعم. يتجاوز custom_user_settings مع PSID الشخص قائمة الصفحة لذلك الشخص، ويتحدث فوراً ويسمح بـ 10 استدعاءات لكل شخص كل 10 دقائق.

ما اللغات التي يدعمها الملف الشخصي لـ Messenger؟

تلك الواردة في قائمة Meta للغات المدعومة، مثل en_GB أو pt_BR أو ja_JP، إضافة إلى default، وهي الاحتياطية عندما لا تطابق أي لغة لغة الشخص.

من يمكنه تغيير الملف الشخصي لصفحة Messenger؟

تطبيق يملك رمز وصول الصفحة مع الإذن pages_messaging. تحتاج القائمة الثابتة والتحية وقائمة النطاقات أيضاً إلى دور المسؤول على الصفحة.

كم تكلف easyCoexistence لصفحة Facebook؟

كل صفحة تمثل اتصالاً واحداً: من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما زاد عدد اتصالاتك، مع فترة تجريبية مجانية مدتها 3 أيام.

تابع القراءة

واجهة Send API في Messenger: إرسال الرسائل من صفحة Facebookكيف ترسل صفحة Facebook رسائل Messenger عبر POST /{page-id}/messages: معرّف الشخص PSID، وmessaging_type، والنص والمرفقات، وحدود المعدل والأخطاء.بروتوكول تسليم Messenger: مشاركة صندوق وارد الصفحة بين وكيل ذكاء اصطناعي والأشخاصكيف تنتقل محادثات Messenger لصفحة Facebook بين التطبيقات وصندوق الوارد، عبر Conversation Routing و pass_thread_control ومالكي المحادثة.وسوم رسائل Messenger في 2026: ما الذي يمكن لصفحة Facebook إرساله بعد نافذة الـ24 ساعةما يمكن لصفحة Facebook إرساله بعد نافذة الـ24 ساعة في Messenger لعام 2026: HUMAN_AGENT وCUSTOMER_FEEDBACK والوسوم الثلاثة المتقاعدة وبدائلها.حقول خطاف الويب (webhook) لصفحات Facebook: القائمة الكاملةالحقول الـ64 لـ webhook صفحات Facebook التي توثّقها Meta: المنشورات والإشارات ورسائل Messenger وحقول الملف الشخصي، وصلاحية كل منها.خطاف الويب (webhook) لـ Messenger في صفحات Facebook: الرسائل وأحداث الإشاراتحقول webhook الخاصة بصفحات Facebook لرسائل Messenger والإشارات: شكل الحمولة ومعرّفات المرسلين والمرفقات، وكيف تصل الأحداث إلى نقطة النهاية الخاصة بك.أذونات واجهة برمجة التطبيقات (API) لصفحات Facebook ومتطلبات مراجعة التطبيقالأذونات التسعة لصفحات Facebook، وما يتيحه كل منها، وما تطلبه مراجعة التطبيق من Meta: Advanced Access، والتحقق من النشاط التجاري، وتسجيل الشاشة.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في