إرسال رسالة

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

مكونات الرسائل

يجب أن تتضمن كل طلبات Send API المطلوبة لإرسال رسالة في تطبيقك ما يلي:

• معرف الصفحة لصفحة فيسبوك أو صفحة فيسبوك المرتبطة بالحساب الاحترافي على Instagram الذي يرسل الرسالة
• معرف الشخص الذي يستلم الرسالة
• رمز وصول الصفحة المطلوب من الصفحة التي ترسل الرسالة
• الإذن المطلوب من الشخص الذي يستلم الرسالة
• نوع الرسالة
• محتوى الرسالة

لمزيد من المعلومات حول مكونات الرسالة، تفضل بزيارة مرجع Send API.

نافذة المراسلة القياسية

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

قد تحتوي الرسائل المرسلة خلال النافذة الممتدة حتى 24 ساعة على محتوى ترويجي.

إجراءات المستخدم التي تفتح نافذة المراسلة القياسية

تفتح إجراءات المستخدم التالية نافذة المراسلة التي تستغرق 24 ساعة:

• يرسل الشخص رسالة إلى الصفحة أو الحساب الاحترافي على Instagram
• ينقر الشخص على زر دعوة لاتخاذ إجراء مثل "البدء المحادثة"
• ينقر الشخص على إعلان النقر لفتح محادثة في Messenger ثم يرسل رسالة إلى الصفحة أو الحساب الاحترافي على Instagram
• يرسل الشخص رسالة إلى الصفحة عبر المكون الإضافي، مثل المكون الإضافي "إرسال إلى Messenger" أو "مربع الاختيار"
• ينقر الشخص على رابط m.me الذي ينقله إلى محادثة موجودة بين الشخص والصفحة
• ينقر الشخص على رابط ig.me ينقله إلى محادثة موجودة بين الشخص والحساب الاحترافي على Instagram
• يتفاعل الشخص على رسالة، مثل رسالة تسويقية
• يعلق الشخص على منشور في الصفحة أو الحساب الاحترافي على Instagram
• ينشر الشخص منشور زائر على الصفحة

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

معرفات المستلم

يتم تعيين معرف الشخص متلقي الرسالة في معلمة الكائن recipient ويمكن أن يكون أحد أنواع المعرفات التالية:

• المعرف على مستوى الصفحة (PSID) – المعرف الذي يتم تخصيصه للشخص في أول مرة يرسل رسالة إلى الصفحة. يمثل هذا المعرف الفريد التفاعلات بين الصفحة والشخص.

• مرجع المستخدم – المعرف الذي يتم تخصيصه للشخص الذي استخدم المكون الإضافي أو زر الرد الجاهز لإرسال رسالة إلى الصفحة.

• معرف المنشور أو التعليق: المعرف الذي يتم تخصيصه إلى الشخص الذي نشر منشورًا على الصفحة أو علق على منشور ما. ويُستخدم لإرسال رد خاص إلى الشخص.

يُرجى ملاحظة أن عمليات دمج معرف المستخدم من تسجيل دخول فيسبوك تكون على مستوى التطبيق ولن تعمل مع منصة Messenger.

أنواع المراسلة

يتم تعيين نوع الرسالة الذي ترسله في المعلمة messaging_type. تُعد هذه المعلمة طريقة أكثر وضوحًا لضمان امتثال الرسائل إلى سياسات المراسلة وتفضيلات المستلم.

يتم دعم أنواع الرسائل التالية:

• الاستجابة – تُعد الرسالة التي ترسلها استجابةً لرسالة تم استلامها. يمكن أن تتضمن الرسالة محتوى ترويجيًا وغير ترويجي ويجب إرسالها أثناء التواجد في نافذة المراسلة القياسية.

• التحديثات – يتم إرسال الرسالة التي ترسلها بشكل استباقي وليس ردًا على رسالة مستلمة. يمكن أن تتضمن الرسالة محتوى ترويجيًا وغير ترويجي ويجب إرسالها أثناء التواجد في نافذة المراسلة القياسية.

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

إشارات الرسائل

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

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

يتعين على الأنشطة التجارية التي تستخدم منصة Messenger وتريد إرسال رسائل ترويجية خارج إطار المراسلة القياسية الذي يبلغ 24 ساعة، استخدام الرسائل المُموَّلة أو الإشعارات لمرة واحدة.

أنواع المحتوى

قد تتضمن الرسالة التي ترسلها أنواع المحتوى التالية:

إرسال نص أساسي

لإرسال رسالة نصية أساسية إلى الشخص الذي أرسل رسالة إلى الصفحة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages، مع تعيين recipient لمفتاح الكائن id الحرفي على معرف الشخص على مستوى الصفحة (PSID)، وتعيين المعلمة message_type على RESPONSE وتعيين text كائن المعلمة message على نص الرسالة.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

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

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

إرسال مرفق وسائط

لإرسال رسالة تتضمن وسائط، مثل صورة GIF أو صورة أو قالب، يمكنك إضافة المحتوى إلى طلب API في كائن مرفق رسالة JSON.

لإرسال رسالة تتضمن صورة إلى الشخص الذي أرسل رسالة إلى الصفحة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages، مع تعيين recipient لمفتاح الكائن id الحرفي على معرف الشخص على مستوى الصفحة (PSID)، وتعيين المعلمة message_type على RESPONSE وتعيين مفتاح type للكائن attachment في المعلمة message على image وتعيين مفتاح url للكائن payload على عنوان URL للصورة.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"
  

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

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

سيتم استخدام التنسيق ذاته عند إرسال مقطع صوتي أو فيديو أو ملف من عنوان URL.

كما يمكنك إرسال الوسائط من الخادم أو من المحتوى الذي قمت بتحميله مسبقًا إلى خادم Meta. تعرف على المزيد حول تحميل الملفات باستخدام API تحميل المرفقات.

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

الرسائل النصية

المرفقات

المزيد من أنواع الرسائل

الرسائل الإخبارية (قيد التطوير)

لا تتوفر الرسائل الإخبارية إلا لناشري الأخبار المسجلين الذين يتم تسجيلهم في فهرس صفحة أخبار الفيسبوك (NPI). تسمح الرسائل الإخبارية لناشري الأخبار بإرسال رسائل إخبارية غير ترويجية إلى الأشخاص الذين اشتركوا لتلقي هذه الرسائل.

لا تتوفر ميزة المراسلة الإخبارية في API المراسلة في Instagram.

الإشعارات لمرة واحدة

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

لا تتوفر الإشعارات لمرة واحدة في API المراسلة في Instagram.

الردود الخاصة

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

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

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

الرسائل المُموَّلة

تسمح لك الرسائل المُموَّلة بإرسال محتوى ترويجي أو غير ترويجي، بعد انتهاء صلاحية نافذة المراسلة القياسية، إلى الشخص الذي أرسل رسالة مسبقًا إلى الصفحة أو الحساب الاحترافي على Instagram. تظهر الرسائل المُموَّلة مثل الرسائل العادية في المحادثة لكن تتم إضافة تعليق توضيحي في المحادثة يتضمن الكلمة "مُموَّل" أعلى الرسالة. يجب أن يمتثل محتوى الرسائل المُموَّلة إلى سياسات الإعلانات

لا تتوفر الرسائل المُموَّلة في API المراسلة في Instagram.

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

تعرف على المكونات التي يمكنك إضافتها إلى الرسائل في المحادثات.

معرفة المزيد

تعرف على المزيد حول إرسال الرسائل باستخدام منصة Messenger.

• مرجع API تحميل المرفقات – تعرف على المزيد حول تحميل الوسائط وإرسالها.
• مرجع Send API – تعرف على المزيد حول كل الإشارات والمحتوى والمرفقات التي يمكنك إرسالها.
• تقييدات معدلات الاستدعاء – تعرف على تقييدات معدلات الاستدعاء لإرسال الرسائل باستخدام منصة Messenger.