الرسائل التسويقية

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

نظرة عامة

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

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

المتطلبات

• يجب أن تمتثل لكل سياسات المطوّرين المعمول بها عند استخدام الرسائل التسويقية أو غيرها من ميزات منصة Messenger

• يمكنك فقط إرسال طلب للمستخدم للاشتراك في الرسائل التسويقية خلال نافذة المراسلة القياسية. لا يؤدي اشتراك المستخدم في الرسائل التسويقية إلى فتح نافذة المراسلة القياسية

• يجب ألا يتلقى تطبيقك و/أو تجربة المراسلة التي توفرها العديد من الملاحظات السلبية من جانب المستخدمين. قد يتم تقييد إمكانات المراسلة أو إزالتها إذا وجدنا أن تجربة المراسلة في تطبيقك قد تلقت العديد من التقييمات السلبية من جانب المستخدمين

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

• يجب الامتثال للتقييدات التي نوفرها فيما يتعلق بوظائف منصة Messenger والرسائل التسويقية حتى تظل في نطاق الخدمة التي نوفرها لك

التقييدات

• لا يمكنك إرسال سوى طلب اشتراك واحد كل أسبوع بالعنوان المحدد نفسه إلى الشخص يتضمن ذلك القيمة الافتراضية لـ "التحديثات والعروض الترويجية".
• لا ترسل طلبات اشتراك مكررة إلى الشخص. يتم تحديد طلب الاشتراك المكرر كالحصول على title ذاته للإشعارات من صفحة فيسبوك أو title وimage_url ذاتهما للإشعارات من الحساب الاحترافي على Instagram
• لا يمكنك إرسال طلبات الاشتراك أثناء عرض نافذة المراسلة القياسية
• إذا اشترك شخص ما لتلقي الرسائل التسويقية، فإن هذا الإجراء لا يؤدي إلى فتح نافذة المراسلة القياسية
• لا يمكنك سوى عرض ما إذا اشترك الشخص في تلقي الرسائل التسويقية وليس حالات طلبات الاشتراك المعلقة
• إذا قرر شخص ما التوقف عن تلقي رسائل تسويقية، فلن يتم تسليم إشعاراتك إلى ذلك الشخص وستتلقى خطأ
• يمكن لأي شخص حظر مراسلتك أو كتمها أو الإبلاغ عنها
• بالنسبة إلى الرسالة التسويقية المرسلة من حساب احترافي على Instagram، بشكل عام، يمكن إرسال ما يصل إلى 10 طلبات اشتراك لعناوين مختلفة لكل شخص على مدار 7 أيام. كما يمكن إرسال 5 طلبات اشتراك للمستخدم يوميًا وفقًا للتقييد الفرعي. ومع ذلك، يجب مراعاة مدى ملاءمة كل طلب اشتراك وأهميته بالنسبة للمستخدم قبل إرساله.

تخضع هذه المتطلبات والتقييدات للتغيير نظرًا لأننا نسعى دائمًا لتوفير أفضل تجربة للمستخدمين والأنشطة التجارية.

أفضل الممارسات

يجب أن ترسل للأشخاص رسائل تسويقية ملائمة وذات قيمة لتوفير تجربة عالية الجودة للمستخدمين عن طريق القيام بما يلي:

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

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

يجب أن تكون الرسائل التسويقية ملائمة ومناسبة لحالات الاستخدام التي من المحتمل أن تكون ذات قيمة للمستخدم.

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

معدل تكرار الرسالة

ينطبق على رموز رسائل الإشعارات التي تم إنشاؤها قبل 2 فبراير 2023.

• بعدما يشترك الشخص، يمكنك إرسال رسائل للشخص بمعدل يومي أو أسبوعي أو شهري استنادًا إلى المعدل الذي حدده الشخص أثناء الاشتراك.

طلب الإذن لإرسال الرسائل التسويقية

يجب على الشخص منح إذن الاشتراك لتلقي الرسائل التسويقية من صفحة فيسبوك أو الحساب الاحترافي على Instagram. توفر منصة Messenger العديد من الطرق للاشتراك. يمكنك إنشاء طلبات الاشتراك في تجارب المراسلة التالية:

• إعلانات النقر لفتح محادثة في Messenger - عندما ينقر شخص ما على الإعلان
• المكون الإضافي "مربع الاختيار" - عندما ينقر الشخص على مربع الاختيار في النموذج ويرسل النموذج
• m.me الروابط – عندما ينقر الشخص على رابط m.me الموجود على موقع الويب ورسائل البريد الإلكتروني ومنشورات وسائل تواصل اجتماعي والمزيد
• الردود الخاصة - عندما ينشر شخص ما منشور زائر أو يعلق على صفحة فيسبوك لنشاطك التجاري
• رموز QR – عندما يمسح الشخص رمز QR ضوئيًا على الأسطح الرقمية والمطبوعة (المدعومة بواسطة روابط m.me)
• المكون الإضافي "إرسال إلى Messenger" - عندما يبدأ الشخص محادثة باستخدام قائمة تضم أزرار دعوة لاتخاذ إجراء أو نصوص محددة مسبقًا

عينة من طلب الاشتراك

لإرسال طلب الاشتراك لتلقي رسالة تسويقية، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تعيين نوع قالب الرسالة على notification_messages. معرف الصفحة هو معرف صفحة فيسبوك أو صفحة فيسبوك المرتبطة بالحساب الاحترافي على Instagram.

ملاحظة: المعلمة title مطلوبة للرسائل التسويقية التي تحتوي على إعلان دوّار من صفحة فيسبوك أو الحساب الاحترافي على Instagram .

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

في حالة نجاح العملية، يتلقى تطبيقك استجابة JSON التالية التي تحتوي على معرفات للمستلم والرسالة.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

مرجع كائن مرفق الرسالة

يجب تضمين كائن JSON messageattachment الموجود في طلب POST إلى نقطة النهاية /PAGE-ID/messages لطلب الاشتراك لتلقي رسالة تسويقية.

رموز رسالة الإشعار

عندما يشترك شخص ما، سيتلقى النشاط التجاري إشعار webhooks messaging_optin يتضمن رمز رسالة الإشعار ومعلومات مثل عنوان الرسائل والمنطقة الزمنية للشخص الذي اشترك. يتيح لك رمز رسالة الإشعار إرسال الرسائل التسويقية إلى الشخص المشترك.

إشعار Webhook للاشتراك

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

سيتم تمديد تواريخ انتهاء صلاحية الرمز للأشخاص الذين اختاروا مواصلة الاشتراك في تلقي الرسائل التسويقية. بإمكان الأشخاص إلغاء الاشتراك في أي وقت.

الاشتراك في رسائل المتابعة

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

لإرسال رسالة متابعة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages تتضمن الكائن recipient الذي يحتوي على رمز رسالة الإشعار والكائن message الذي يحتوي على نص رسائل المتابعة. تكون بنية طلبات API لكل رسائل المتابعة الثلاث مماثلة.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

الحصول على قائمة بالرموز

للحصول على قائمة بكل رموز رسالة الإشعار الصالحة، أرسل طلب GET إلى نقطة النهاية /PAGE-ID/notification_message_tokens.

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

يتم إرجاع قائمة تضم ما يصل إلى 25 رمزًا بشكل افتراضي ويتم ترتيبهم حسب وقت التحديث. لقراءة المزيد، يمكنك إضافة المعلمة limit. حاليًا، يوجد تقييد يتضمن 100 رمز يمكن إرجاعه. يمكنك استخدام المعلمة after لتقسيم الصفحات، ومع ذلك، لا تتوفر المعلمة before.

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية التي تتضمن الرمز ومعرف المستلم سواء معرف على مستوى Instagram أو معرف على مستوى الصفحة ووقت إنشاء الرمز وعنوان الإشعار ومتى يمكن إرسال الرسالة التسويقية التالية إلى المستلم.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

الحصول على معلومات الرمز

بينما نوصي باستخدام حدث webhook messaging_optin للحصول على معلومات الرسالة التسويقية، يمكنك إرسال طلب GET إلى نقطة نهاية الرمز حيث يتم إرفاق الرمز إلى notification_messages_ وnotification_messages_NOTIFICATION-MESSAGES-TOKEN للحصول على معلومات الرمز.

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

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

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

سيتم احتساب استدعاءات API هذه ضمن حد تقييد معدلات الاستدعاء في تطبيقك.

إرسال رسالة تسويقية

قبل البدء

ستحتاج إلى ما يلي:

• رمز رسالة الإشعار‏ للشخص الذي اشترك في تلقي الإشعارات
• معرف صفحة النشاط التجاري على فيسبوك
• رمز وصول الصفحة المطلوب من الشخص الذي يمكنه تنفيذ مهمة MESSAGING بالصفحة
• إذن pages_messaging، باستخدام تسجيل دخول فيسبوك
• أي أصول يجب تضمينها في الرسالة التسويقية
• اشتراك webhook للحدث messaging_referrals في تطبيقك

لإرسال رسالة تسويقية، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages يتضمن القيمة NOTIFICATION-MESSAGES-TOKEN للمستلم ومعلومات الرسالة في مرفق الرسالة.

التقييدات

• لا يمكنك إلا إرسال رسالة واحدة يوميًا لكل رمز رسالة إشعار. إذا كنت ترسل رسائل متعددة، تأكد من تأخير الرسائل اللاحقة لمدة 24 ساعة أو ستتلقى خطأً. (لا ينطبق على رسائل متابعة الاشتراك.)

التوصيات

• نوصي بشدة بالإشارة إلى المنطقة الزمنية للمستلم عند إرسال الرسائل التسويقية لضمان استلام الرسائل في الوقت المناسب من جانب المستلم.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، سيتلقى تطبيقك الاستجابة التالية:

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

اختبار الرسائل التسويقية

يمكنك اختبار الرسائل التسويقية في أي وقت.

قبل البدء

ستحتاج إلى ما يلي:

• شخص، مختبر، لتلقي الإشعار. يجب أن يكون لهذا الشخص دورًا في التطبيق.

اختبار طلبات الاشتراك

يمكنك اختبار الرسائل التسويقية في أي وقت باتباع هذه الخطوات.

• الخطوة الأولى. أرسل إلى المختبِر رسالة باستخدام قالب الاشتراك في الرسالة التسويقية.
• الخطوة الثانية. تأكد من نقر الشخص المُختبِر على زر الاشتراك، مثل احصل على خصم 50% على رسائل المبيعات، في المحادثة.
• الخطوة الثالثة. أرسل الرسالة التسويقية الأولى للمختبِر
• الخطوة الرابعة. أرسل رسالة تسويقية أخرى فورًا بعد الأولى مع تعيين المعلمة developer_action إلى ENABLE_FOLLOWUP_MESSAGE.
• الخطوة الخامسة. أرسل رسالة تسويقية أخرى إلى المختبِر؛ هذه هي رسالة الاختبار.

عينة من الطلب

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية التي تحتوي على success الذي تم تعيينه على true.

{ "success": true }

لاختبار عمليات إعادة الاشتراك، كرّر الخطوات مع تعيين المعلمة developer_action على SEND_RE_OPTIN في الخطوة الرابعة.

الخطوات التالية

• إشعار Webhooks للاشتراك في المراسلة
• تفضل بزيارة نظرة عامة على أنواع الرسائل للتعرف أنواع الرسائل المختلفة التي يمكنك إرسالها.

راجع أيضًا

• مرجع رسائل الصفحة لمزيد من المعلومات حول حقول الرسائل المتكررة المتوفرة.
• قائمة المناطق الزمنية المتوفرة
• رموز الأخطاء في منصة Messenger