الإشعار لمرة واحدة (الإصدار التجريبي)

الملخص

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

الأذونات

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

المحتويات

• الاستخدام
• إرسال طلب الإشعار لمرة واحدة
• إرسال رسالة متابعة
• أحداث Webhook
• القيود والتقييدات

الاستخدام

• احرص على عدم إرباك أي شخص أو خداعه أو الاحتيال عليه أو تضليله أو إرسال محتوى غير مهم أو احتيالي إليه أو مفاجأته. وتأكد من وجود علاقة واضحة وصريحة بين المطالبة ومحتوى الرسالة. كما يجب أن يمتثل محتوى طلب الإشعار لمرة واحدة والرسالة إلى معايير المجتمع.
• ستفقد الصفحات، التي تتلقى عددًا كبيرًا من ملاحظات المستخدمين السلبية أو تحاول إرباك المستخدمين أو خداعهم أو الاحتيال عليهم أو تضليلهم أو مفاجأتهم بشكل سلبي، صلاحية الوصول إلى API.

إرسال طلب الإشعار لمرة واحدة

عند استخدام API الإرسال، يمكن للصفحة إرسال رسالة تتضمن طلب الإشعار في صورة قالب. ويجب أن يكون القالب بالنوع one_time_notif_req. يتبع النص الأساسي للطلب تنسيقًا قياسيًا في كل أنواع القوالب، مع توفير الخاصية message.attachment.payload التي تحتوي على النوع وتفاصيل المحتوى لكل نوع من أنواع القوالب. ولا يجوز لك سوى تخصيص العنوان وحمولة بيانات الطلب. يستوعب الحقل title 65 حرفًا كحد أقصى.

{
  "recipient": {
    "id":"

سيتم عرض قالب طلب الإشعار لمرة واحدة وبمجرد أن ينقر المستخدم على الزر "إرسال إشعار إليّ"، سيتم تسليم إشعار webhook بحدث message_optins إلى الواجهة الخلفية لديك ويمكن استخدام one_time_notif_token لإرسال رسالة متابعة لمرة واحدة إلى المستخدم خارج الفترة المحددة التي تبلغ 24 ساعة.

إرسال رسالة متابعة

لإرسال رسالة متابعة، يجب إرسال طلب POST إلى API الإرسال والحصول على one_time_notif_token عبر حدث webhook وتعيين message.text في النص الأساسي للطلب:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

لإرسال رسالة منسقة، استبدل النص بمحتوى منسق. يُرجى الرجوع إلى مرجع API الإرسال للحصول على القائمة الكاملة بأنواع الرسائل المدعومة. لا يمكن استخدام الرمز one_time_notif_token إلا لمرة واحدة، وسيتم إبطاله بمجرد إرسال الرسالة بنجاح.

أحداث Webhooks

عندما يوافق المستخدم على أن يتم إبلاغه عند توفير تحديث معين، ستحصل على حدث webhook يتضمن payload وone_time_notif_token. وستحتاج إلى تخزين حمولة البيانات والرمز لإرسال رسالة متابعة عندما تصبح المعلومات متوفرة. يُرجى ملاحظة أنه لن تتوفر API منفصلة للاستعلام عن قائمة one_time_notif_token؛ ولذلك فمن المهم معالجة معلومات حدث webhook وتخزينها بمجرد استلامها. يمكن استخدام كل رمز لمرة واحدة فقط وستنتهي صلاحيته خلال عام واحد من وقت الإنشاء.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

الحدود والتقييدات

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

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

يمكنك الحصول على مزيد من المعلومات في صفحة الأسئلة المتكررة.