‏منصة Messenger‏

قالب المنتج للمراسلة في Instagram

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

يمكنك إنشاء الرسائل التي تحتوي على منتج واحد أو إعلان دوّار للمنتجات قابل للتمرير الأفقي باستخدام قالب المنتج.

قبل البدء

يفترض هذا الدليل أنك قد قرأت نظرة عامة على منصة Messenger ونفذت المكونات اللازمة لإرسال الرسائل والإشعارات وتلقيها.

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

إرسال رسالة منتج

لإرسال رسالة منتج إلى الشخص، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تعيين الخاصية recipient.id على معرف الشخص على مستوى Instagram الذي يتلقى الرسالة. قم بتضمين الخاصيتين type وpayload في الكائن message.attachment. قم بتعيين type على template مع تعيين الخاصية payload.template_type على product وpayload.elements على قائمة أزواج القيم والمفاتيح لمعرف المنتج.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"INSTAGRAM-SCOPED-ID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

إرسال إعلان دوّار

لإرسال إعلان دوّار للمنتج، أضف المزيد من أزواج القيم والمفاتيح للمنتجات إلى الخاصية payload.elements. يمكنك تضمين ما يصل إلى 10 منتجات في الطلب.

...
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID-1"
          },
          {
            "id": "PRODUCT-ID-2"
          },
          {
            "id": "PRODUCT-ID-3"
          }
        ]
      }
...

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

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

إرسال طلب الاشتراك

لإرسال طلب الاشتراك إلى الشخص لتلقي الرسائل التسويقية المتكررة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تعيين الخاصية recipient.id على معرف الشخص على مستوى Instagram الذي يتلقى الرسالة. في الخاصية messageattachment.payload، قم بتعيين template_type على notification_messages. في الخاصية payload.elements، قم بتضمين image_url وtitle وpayload وnotification_message_frequency وnotification_messages_cta_text.

curl -X POST -H "Content-Type:application/json" -d '{
  "recipient": {
    "id": "INSTAGRAM-SCOPED-ID"
  },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "notification_messages",
        "elements": [
          {
            "image_url": "IMAGE-URL",
            "title": "TEXT-TO-DISPLAY",
            "payload": "INFORMATION-ABOUT-THIS-MESSAGE",
            "notification_messages_frequency": "DAILY",
            "notification_messages_cta_text": "GET_UPDATES"
          }
        ]
      }
    }
  }
}' "https://graph.intern.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

مرجع عناصر رسائل الإشعارات

الخاصيةالقيمة

image_url

string (سلسلة)

عنوان URL للصورة المطلوب عرضها في القالب

notification_messages_cta_text

enum (تعداد) { ALLOW, FREQUENCY, GET, GET_UPDATES, OPT_IN, SIGN_UP }

يتم تعيين النص الذي يظهر في زر الدعوة لاتخاذ إجراء عن طريق استخدام إحدى القيم التالية:

  • ALLOW – تعيين نص زر رسالة الاشتراك إلى السماح بالرسائل
  • FREQUENCY - تعيين نص زر رسالة الاشتراك إلى الحصول على الرسائل اليومية
  • GET – تعيين نص زر رسالة الاشتراك إلى الحصول على الرسائل
  • GET_UPDATES – تعيين نص زر رسالة الاشتراك إلى الحصول على التحديثات، هذا الإعداد افتراضي إذا لم يتم تعيين notification_messages_cta_text
  • OPT_IN – تعيين نص زر رسالة الاشتراك إلى الاشتراك في الرسائل
  • SIGN_UP – تعيين نص زر رسالة الاشتراك إلى التسجيل للرسائل

notification_messages_frequency

enum (تعداد) { DAILY, WEEKLY, MONTHLY }

معدل تكرار الرسالة في طلب الاشتراك لتلقي الإشعار المتكرر هذا.

  • DAILY – الاشتراك لتلقي إشعار واحد كل 24 ساعة لمدة 6 أشهر
  • WEEKLY – الاشتراك لتلقي إشعار واحد كل 7 أيام لمدة 9 أشهر
  • MONTHLY – الاشتراك لتلقي إشعار واحد كل شهر واحد لمدة 12 شهر

payload

string (سلسلة)

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

title

string (سلسلة)

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

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

الآن بعد اشتراك الأشخاص لتلقي الرسائل التسويقية المتكررة، تعرف على كيفية إرسال الرسائل التسويقية.

راجع أيضًا