إرسال رسالة

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

يمكنك إرسال رسالة حرة تحتوي على ما يلي:

• صورة أو فيديو أو صورة GIF أو مقطع صوتي
• تفاعل أو ملصق
• نص، بما في ذلك رابط

قبل البدء

يفترض هذا الدليل أنك قرأت نظرة عامة على منصة Messenger وقمت بتنفيذ المكونات اللازمة مثل صفحة فيسبوك المرتبطة بحساب Instagram احترافي (أو صفحة اختبارية) وقمت بالتسجيل كمطوّر Meta وقمت بإنشاء معرف تطبيق الأعمال من خلال Messenger > منتج مراسلة Instagram في لوحة معلومات التطبيق.

يمكنك أيضًا التحقق من حالة منصة مطوّر Meta لضمان عدم وجود أي مشكلات.

المتطلبات

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

التقييدات

• لا يمكن للتطبيقات ذات الوصول القياسي إرسال رسائل سوى للأشخاص الذين لديهم دور في التطبيق
• يمكن أن تكون مرفقات الوسائط كما يلي:

لمزيد من المعلومات حول مرفقات الوسائط، راجع تحميل الوسائط للمراسلة في Instagram.

إرسال رسالة أساسية

لإرسال رسالة تحتوي على نص أو رابط، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تضمين المعلمة recipient التي تحتوي على المعرف على مستوى Instagram (IGSID) والمعلمة message التي تحتوي على النص أو الرابط.

يجب أن يكون نص الرسالة بتنسيق UTF-8 ويكون حجمه 1000 بايت أو أقل. يجب أن تكون الروابط عناوين URL منسقة بشكل صحيح.

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

عينة من استجابة API

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

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

إرسال منشور تم نشره

لإرسال رسالة تحتوي على منشور نشرته على Instagram، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تضمين المعلمة recipient التي تحتوي على المعرف على مستوى Instagram (IGSID) والمعلمة message التي تحتوي على كائن attachment مع تعيين type على MEDIA_SHARE وكذلك تضمين المعلمة payload التي تحتوي على معرف Meta للمنشور.

يجب أن يمتلك النشاط التجاري الوسائط التي سيتم استخدامها في الرسالة.

عينة من الطلب

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

عينة من استجابة API

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

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

إرسال ملصق

لإرسال ملصق قلب، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تضمين المعلمة recipient التي تحتوي على المعرف على مستوى Instagram (IGSID) والمعلمة message التي تحتوي على كائن attachment مع تعيين type على like_heart.

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

عينة من استجابة API

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

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

التفاعل على رسالة

لإرسال تفاعل، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تضمين المعلمة recipient التي تحتوي على المعرف على مستوى Instagram (IGSID) وتعيين المعلمة sender_action على react وكذلك تعيين المعلمة payload التي تحتوي على message_id على معرف الرسالة المطلوب تنفيذ التفاعل عليها وتعيين المعلمة reaction على love.

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

لإزالة تفاعل من رسالة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages مع تضمين المعلمة recipient التي تحتوي على المعرف على مستوى Instagram (IGSID) وتعيين المعلمة sender_action على unreact مع تعيين المعلمة payload التي تحتوي على message_id على معرف الرسالة الذي ستتم إزالة التفاعل منها.

عينة من الطلب

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

عينة من الاستجابة

عند نجاح العملية، سيتلقى التطبيق استجابة JSON التالية لطلبات التفاعل وإلغاء التفاعل:

{
  "recipient_id": "IGSID"
}

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

• تحميل وسائط مثل مقطع صوتي أو صورة إلى خوادم Meta لاستخدامها في رسائل متعددة.

• أرسل رسالة ذات بنية محددة مثل قالب عام أو قالب منتج أو قائمة ثابتة.

راجع أيضًا

• رموز الأخطاء
• تقييدات معدلات الاستدعاء في مراسلة Instagram
• الحصول على معرف الوسائط لأصول الوسائط