الأسئلة المتكررة

يتم تثبيت التطبيقات من موقع التطبيق على الويب باستخدام تسجيل دخول فيسبوك ومنح إذن pages_messaging لصفحة معينة. ستظهر التطبيقات المصرح لها في إعدادات الصفحة من المراسلة المتقدمة.

نعم، يمكن لتطبيق فيسبوك واحد أن يشترك في عدة صفحات. وبمجرد أن ينتقل التطبيق للمراجعة مثل الإذن pages_messaging، فيمكن للتطبيق الاشتراك لتلقي webhooks على أكثر من صفحة. وسيرجع الأمر إليك بخصوص الحصول على سياق كل webhook بناءً على حمولة البيانات.

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

لقراءة الأسئلة المتكررة عن اللائحة العامة لحماية البيانات ومنصة Messenger، يرجى زيارة منصة Messenger، واللائحة العامة لحماية البيانات.

عند استخدام المكون الإضافي "إرسال إلى Messenger"، يمكنك استخدام معلمة مرجع البيانات كمعلمة مرور لإرسال أي معلومات تتعلق بسياق النقرة.

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

عندما يكون التطبيق في وضع التطوير، فلن يتمكن أحد بخلاف مسؤولي التطبيق ومطوريه ومختبريه من عرض المكون الإضافي. بعد مراجعة التطبيق والموافقة عليه، يمكنك توفير التطبيق للعامة من علامة تبويب مراجعة التطبيق في لوحة معلومات التطبيق.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

هناك عدة أسباب لحدوث ذلك:

• استخدام معرف من تسجيل دخول فيسبوك. لا تصلح معرفات المستخدم من تسجيل دخول فيسبوك للعمل مع واجهة API الإرسال/الاستلام. ولن تصلح سوى معرفات المستخدم التي تم الحصول عليها من خلال المصادقة عبر منصة Messenger للعمل مع منصة Messenger.
• استخدام معرف برمز وصول صفحة غير صحيح. يتم توفير معرفات المستخدم لمنصة Messenger على مستوى الصفحة، وبالتالي تكون مرتبطة بصفحة محددة. وإذا استخدمت معرف مستخدم صالح ولكن برمز وصول صفحة مرتبط بصفحة مختلفة، فلن يعمل الاستدعاء. تأكد من استخدام معرف المستخدم ورمز وصول الصفحة المقترن بالصفحة ذاتها.
• الإرسال إلى رقم هاتف لم يتم التحقق منه مؤخرًا. عند استخدام واجهة API الإرسال برقم هاتف، فلن نرسل الرسائل إلا في حالة التحقق من رقم الهاتف مؤخرًا. حتى في حالة عرض رقم الهاتف كرقم تم التحقق منه، دون أن يكون التحقق قد تم مؤخرًا، فقد يفشل الإرسال. أعد التحقق من رقم هاتفك وانتظر 24 ساعة قبل إعادة المحاولة.

إليك حل بديل لاستخدام الحسابات الاختبارية للمنصة لتكامل منصة Messenger الخاص بك:

1. من صفحة الأدوار بتطبيقك، قم بإنشاء حساب اختباري جديد بالنقر على الزر "إضافة".
2. قم بتبديل خيار هل تريد السماح للحسابات الاختبارية بالوصول إلى هذا التطبيق؟ وقم بمنح الأذونات "manage_pages" و"page_messaging".
3. استخدم الزر "تعديل" واحصل على رمز وصول لهذا المستخدم (باستخدام الإصدار 2.6). يرجى حفظ رمز الوصول لاستخدامه لاحقًا.
4. استخدم الزر تعديل لتسجيل الدخول كحساب اختباري.
5. بعد تسجيل الدخول، قم بإنشاء صفحة كحساب اختباري.
6. واستخدم رمز وصول المستخدم الخاص بالحساب الاختباري للحصول على رمز وصول الصفحة لهذا المستخدم. ويمكنك القيام بذلك باستخدام الاستدعاء التالي:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]

   (الوثائق)
7. استخدم رمز وصول الصفحة لربط تطبيق فيسبوك الخاص بك بصفحتك:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
           

   (الوثائق)
8. بعد اتباع هذه الخطوات، سوف تستلم تحديثات فورية بصفحتك الاختبارية وسوف تتمكن من مراسلة الحساب الاختباري من صفحتك الاختبارية. بالإضافة إلى ما سبق، يمكنك استبدال رمز الوصول برمز طويل الأجل إذا كانت صلاحية الرموز التي تستخدمها في الاختبارات تنتهي سريعًا. يرجى اتباع المعلومات الواردة بهذه الوثائق من هنا:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

نعم، يمكن أن يتضمن البرنامج التلقائي كل من نوعي المراسلة. سيكون على الشخص بدء المراسلة القياسية على المنصة عبر أحد بادئات التشغيل المؤهلة وسيحتاج إلى اختيار تلقي رسائل المراسلة المستندة إلى الاشتراكات.

من الناحية الفنية، لن تتمكن البرامج التلقائية من إرسال رسائل إلى المستخدمين أكثر من مرة بعد مرور فترة 24 ساعة المقررة (لن يتم إرسال الرسائل). خلال فترة الانتقال بالنسبة إلى البرامج التلقائية الحالية، ستصل هذه الرسائل لكن سيتم وضع علامة عليها عند العثور عليها.

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

توجد خطوتان لتلقي الاستدعاءات. أولاً، تأكد من إعداد webhook بشكل صحيح (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). هناك مؤشر يدل على إعداد وحدات webhook بشكل صحيح.

ثانيًا، يجب الاشتراك في كل صفحة. سيتم إدراج كل الصفحات التي تم الاشتراك فيها.

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

تحتوي استدعاءات webhook على حقل في العنوان اسمه X-Hub-Signature، والذي يمكن استخدامه للتحقق من أن الاستدعاء وارد من فيسبوك.

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

ولاحظ أيضًا أنه يتم إرسال رمز الاستجابة الناجحة بدون تأخير. تنتهي مهلة استدعاء webhook بعد 20 ثانية. تأكد من بناء الرمز البرمجي ليساعد على معالجة وحدات webhook بشكل غير متزامن كي يتم إرسال رمز حالة نجاح على الفور وتتم المعالجة بشكل منفصل.

تتوفر أداة تعرض الأخطاء الأخيرة في أحداث webhook. وإذا فشل عرض أحداث webhooks، فلن تلغي خوادم Facebook اشتراك عنوان URL الخاص بك. وللعثور على الأداة، انتقل إلى لوحة معلومات التطبيق > Messenger > الإعدادات، وضمن بطاقة أحداث Webhooks، يتوفر زر باسم عرض الأخطاء الأخيرة