تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

مرفقات الرسائل المباشرة في Instagram ضمن خطاف الويب (webhook) للرسائل

يحمل webhook الرسائل في Instagram وسائط الرسائل المباشرة داخل message.attachments، وهي مصفوفة من الكائنات، لكل كائن type وحمولة payload تحتوي عادةً على عنوان URL لشبكة توزيع المحتوى (CDN). تسرد أمثلة Meta لتسجيل الدخول عبر Instagram القيم image وvideo وaudio وfile وig_post وig_reel وreel وstory_mention وmedia وstory وig_story والنوع القديم share، أما الوسائط التي تُعرض مرة واحدة فتصل كمرفق من نوع ephemeral بلا عنوان URL.

يشترك easyCoexistence في الرسائل لكل حساب Instagram متصل، ويمرّر الرسائل المباشرة مع مرفقاتها إلى نقطة النهاية HTTPS الخاصة بك كما أرسلتها Meta، موقّعةً بسر ذلك الحساب، دون الاحتفاظ بأي نسخة، فيجلب وكيلك أو كودك الوسائط التي يحتاجها.

ig_post

نوع المرفق لمشاركة منشور؛ تضيف حمولته الحقلين ig_post_media_id وtitle، وهو تعليق المنشور، إلى جانب url.

1 Feb 2026

الموعد الذي توقف فيه دعم نوع المرفق القديم share لمشاركة منشورات Instagram.

ephemeral

نوع المرفق الخاص بالوسائط المختفية التي تُعرض مرة واحدة، ويصل بلا عنوان URL.

is_unsupported

يُضبط الحقل is_unsupported على true في حدث الرسالة عندما تحتوي على وسائط غير مدعومة.

First image

ما يُبلغ عنه الإشعار عندما يتفاعل أحد مع صورة واحدة من منشور متعدد الصور أو يعيد توجيهها.

ما أنواع المرفقات التي يمكن أن يحملها حدث الرسالة المباشرة؟

تسرد أمثلة Meta لتسجيل الدخول عبر Instagram هذه القيم لـ message.attachments[].type، ولكل منها كائن حمولة payload. تشير معظم الحمولات إلى url للوسائط على CDN الخاصة بـ Meta، وتوثّق Meta حقولاً إضافية في الحمولة لنوع ig_post وحده، لذا اقرأ النوع قبل الحمولة.

imageA photo. Meta's Instagram Login list also puts GIFs and stickers under this type.
videoA video, at payload.url.
audioAudio, at payload.url.
fileA file, at payload.url.
ig_postA shared post: url, ig_post_media_id and title, its caption.
ig_reel and reelA shared Reel; Meta lists both names, each with a url.
story_mentionA Story that mentions the account, at its CDN URL.
shareThe legacy post share, supported until 1 February 2026.
media, story, ig_storyAlso in Meta's list, with no payload described.
ephemeralView-once media, sent with no URL.

كيف تبدو رسالة تحتوي على مرفقات؟

حدث رسالة يحتوي فيه كائن message على attachments بدلاً من النص أو إلى جانبه. يرسل مثال Meta وسيطين في رسالة واحدة، لكل منهما type وpayload.url الخاص به، لذلك يجب أن يمرّ المعالج على المصفوفة كاملةً بدلاً من قراءة عنصرها الأول:

A DM with two attachments, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "attachments": [
              { "type": "image", "payload": { "url": "<CDN_URL>" } },
              { "type": "video", "payload": { "url": "<CDN_URL>" } }
            ]
          }
        }
      ]
    }
  ]
}

كيف تبدو مشاركة المنشور؟

مرفق من نوع ig_post. ابتداءً من 3 نوفمبر 2025 أرسلت Meta مشاركات المنشورات مع مرفقين، من نوع share ومن نوع ig_post، وظل share مدعوماً للمنشورات حتى 1 فبراير 2026، وتقول Meta إن التكاملات الجديدة يجب أن تدعم ig_post. وتضيف حمولته معرّف الوسائط الخاص بالمنشور، وتعليقه في الحقل title:

The attachment of a shared post
"attachments": [
  {
    "type": "ig_post",
    "payload": {
      "ig_post_media_id": "<MEDIA_ID>",
      "title": "<POST_CAPTION>",
      "url": "<CDN_URL>"
    }
  }
]

ما معنى كل حقل؟

حقول المرفقات التي توثّقها Meta لحدث الرسالة المباشرة، من المصفوفة إلى الأسفل:

  • message.attachments[]: كائن واحد لكل عنصر وسائط؛ يحمل مثال Meta اثنين في رسالة واحدة.
  • type: نوع العنصر من القائمة أعلاه؛ استند إليه في تحديد المسار قبل قراءة الحمولة.
  • payload.url: عنوان URL للوسائط على CDN. تصف Meta في نظرة عامة هذه العناوين بأنها مراعية للخصوصية، فلا تُرجع أي محتوى بعد حذف المحتوى أو انتهاء صلاحيته.
  • payload.ig_post_media_id وpayload.title: في نوع ig_post وحده، معرّف وسائط المنشور المشارك وتعليقه.
  • message.text: يظهر فقط إذا احتوت الرسالة على نص أيضاً.
  • message.is_unsupported: تكون قيمته true عندما تحتوي الرسالة على وسائط لا يدعمها webhook.

كم تبقى روابط المرفقات صالحة؟

ترتبط بالمحتوى نفسه. تقول النظرة العامة من Meta إن عناوين CDN في Instagram مراعية للخصوصية، وتتوقف عن إرجاع الوسائط بعد حذف المحتوى أو انتهاء صلاحيته، ويذكر دليل الإشارة في القصص أن عنوان URL للقصة يتوقف عن العرض عند انتهائها أو حذفها. لذلك ينبغي أن يجلب التطبيق الملف الذي يحتاجه عند وصول الحدث، ضمن قواعد Meta: فوسائط القصص، على سبيل المثال، لا يجوز تخزينها أو حفظها مؤقتاً في الذاكرة.

ما الوسائط التي لا يشملها webhook؟

يسمّي دليل Meta للمراسلة عبر Instagram هذه الفجوات، ويجب أن يتوقعها المعالج لا أن يعاملها كأخطاء:

  • الوسائط المختفية التي تُعرض مرة واحدة أو تسمح بإعادة التشغيل: مرفق من نوع ephemeral بلا عنوان URL.
  • الوسائط غير المدعومة: تصل الرسالة مع ضبط is_unsupported على true.
  • صور GIF والملصقات: يقول ذلك الدليل إنها لا تُطلق أي webhook، في حين تدرجها أمثلة Meta لتسجيل الدخول عبر Instagram ضمن image.
  • الصورة المحددة من المنشور متعدد الصور: التفاعل مع صورة واحدة منه أو إعادة توجيهها يُبلغ عن الصورة الأولى.
  • المشاركات عموماً: ما زالت أدلة Meta للمراسلة تذكر أن عنوان URL للوسائط المشاركة وحده مُدرج، رغم أن ig_post أضاف الآن معرّف الوسائط والتعليق.

كيف يمرّر easyCoexistence المرفقات؟

دون تغيير داخل entry: تصل الرسالة المباشرة التي تحتوي على وسائط إلى نقطة النهاية لديك مع مصفوفة المرفقات الخاصة بـ Meta كما أرسلتها Meta، داخل غلاف يتكوّن من platform وaccount_id وexternal_id وentry، وموقّعة بالترويسة X-EC-Signature. لا تُنزَّل المرفقات، ولا تُخزَّن الأحداث افتراضيًا: الحساب الذي تكون فيه أتمتة مفعّلة يحتفظ بنص الرسالة المباشرة لا بوسائطها لمدة 7 أيام. اجلب الوسائط التي تحتاجها من payload.url عند وصول الحدث، ولا تخزّن وسائط القصص.

الأخطاء الشائعة

  • قراءة المرفق الأول فقط. message.attachments مصفوفة، وتحمل أمثلة Meta عنصرين في رسالة واحدة، لذا مرّ على المصفوفة كلها.
  • ما زال يطابق النوع share للمشاركات. دعمته Meta للمنشورات حتى 1 فبراير 2026؛ اقرأ ig_post، مع معرّف الوسائط والتعليق في حمولته.
  • حفظ payload.url للجلب لاحقاً. يتوقف عن إرجاع الوسائط بعد حذف المحتوى أو انتهائه، لذا نزّل ما تحتاجه عند الوصول، باستثناء وسائط القصص.
  • قراءة payload.url دون التحقق من النوع. تصل الوسائط المعروضة مرة واحدة بالنوع ephemeral بلا عنوان URL، أما الوسائط غير المدعومة فتضبط is_unsupported.
إنجاز ذلك باستخدام EasyCoexistence

ترسل send_social_dm الرد داخل نافذة الـ 24 ساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.

الأسئلة الشائعة

هل يمكنني تخزين وسائط من مرفق رسالة Instagram المباشرة؟

نزّل ما تحتاجه عند وصول الحدث، لأن payload.url يتوقف عن إرجاع الوسائط بعد حذف المحتوى أو انتهاء صلاحيته. وسائط القصص هي الاستثناء: تنص قواعد Meta على عدم جواز تخزينها أو حفظها مؤقتاً.

لماذا لا يحمل webhook رسائل Instagram المباشرة عنوان URL للوسائط؟

غالباً لأن الوسائط تُعرض مرة واحدة، فتصل كمرفق من نوع ephemeral بلا عنوان URL، أو لأنها غير مدعومة، فتضبط is_unsupported على true.

هل تُطلق صور GIF والملصقات في Instagram حدث webhook للرسائل؟

تتعارض وثائق Meta في هذه المسألة: أمثلتها لتسجيل الدخول عبر Instagram تدرج صور GIF والملصقات ضمن image، بينما يقول دليل المراسلة عبر Instagram إنها لا تُطلق أي webhook. اختبر بحساب حقيقي.

هل يمكن أن يحمل حدث واحد للرسائل المباشرة في Instagram عدة مرفقات؟

نعم. message.attachments مصفوفة، ويُظهر مثال Meta وسيطين في رسالة واحدة.

تابع القراءة

ذكر القصص والردود عليها في webhook إنستغرامكيف تصل إشارات القصص وردودها عبر حقل messages: المرفق story_mention و reply_to.story ورابط CDN ونافذة الرد.خطاف الويب (webhook) للرسائل على Instagram: حمولة الرسالة المباشرة (DM) والأصداء والحقولما يرسله webhook الرسائل على Instagram لكل رسالة مباشرة: معرّف المرسل المحدود والنص والمرفقات والردود على القصص والأصداء، حقلاً حقلاً، مع نافذة 24 ساعة.خطاف الويب (webhook) message_reactions على إنستغرام: حمولة react وunreactما يرسله webhook الخاص بـ message_reactions على إنستغرام عند تفاعل شخص مع رسالة خاصة أو يزيله: mid وaction وreaction وemoji، ومتى يبقى صامتاً.حقول خطاف الويب (webhook) في Instagram: القائمة الكاملةحقول webhook التي تُدرجها Meta لـ Instagram Login: ما يُطلق كل حقل، والإذن الذي يلزمه، والحقول المتروكة لـ Facebook Login.رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.

اربط قناتك الأولى في دقيقتين.

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

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في