התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

קבצים מצורפים בהודעות Instagram בוובהוק (Webhook) ההודעות

וובהוק ההודעות של Instagram (Webhook) נושא מדיה של הודעות ישירות בשדה message.attachments: מערך של אובייקטים, ולכל אחד מהם יש שדה type ושדה payload, שבדרך כלל מכיל כתובת URL של מדיה ברשת ה-CDN של Meta. רשימת Meta לכניסה דרך Instagram Login כוללת את הערכים image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story ואת share המיושן, ומדיה חד-פעמית שנעלמת מגיעה כקובץ מצורף ephemeral ללא כתובת URL.

easyCoexistence עושה מנוי לאירועי messages לכל חשבון Instagram מחובר, ומעביר DM עם הקבצים המצורפים שלו לנקודת הקצה HTTPS שלכם כפי ש-Meta שולחת אותם.

ig_post

סוג הקובץ לפוסט ששותף. ה-payload מוסיף, לצד url, את ig_post_media_id ואת title, הכיתוב של הפוסט.

1 Feb 2026

סוג הקובץ הישן share הפסיק להיתמך בשיתופי פוסטים ב-Instagram.

ephemeral

סוג מדיה חד-פעמית שנעלמת, שמגיעה ללא כתובת URL.

is_unsupported

נקבע לערך true באירוע הודעה כשההודעה מכילה מדיה שאינה נתמכת.

First image

מה שמדווח כשמגיבים לתמונה אחת בפוסט קרוסלה או מעבירים אותה הלאה.

אילו סוגי קבצים מצורפים יכול לשאת אירוע DM?

הערכים שמונה רשימת הדוגמאות של Meta ל-Instagram Login בשדה message.attachments[].type, ולכל אחד מהם יש אובייקט payload. רוב ה-payload מכילים url למדיה ברשת ה-CDN של Meta. Meta מתעדת שדות payload נוספים רק ל-ig_post, ולכן קראו את הסוג לפני ה-payload.

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.

איך נראה DM עם קבצים מצורפים?

אירוע messages שבו אובייקט 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. ה-payload מוסיף את מזהה המדיה של הפוסט ואת הכיתוב שלו בשדה 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 מתעדת לאירוע DM, מהמערך כלפי מטה:

  • message.attachments[]: אובייקט אחד לכל פריט מדיה. בדוגמה של Meta יש שניים בהודעה אחת.
  • type: מה הפריט, מהרשימה שלמעלה. מפצלים לפיו לפני קריאת ה-payload.
  • payload.url: כתובת CDN למדיה. התיעוד של Meta מכנה את הכתובות האלה מודעות לפרטיות, והן מפסיקות להחזיר מדיה לאחר שהתוכן נמחק או פג תוקפו.
  • payload.ig_post_media_id וגם payload.title: רק ב-ig_post, מזהה המדיה של הפוסט ששותף והכיתוב שלו.
  • message.text: מופיע רק כשההודעה מכילה גם טקסט.
  • message.is_unsupported: true כשההודעה מכילה מדיה שהוובהוק אינו תומך בה.

כמה זמן כתובות הקבצים פועלות?

Meta קושרת אותן לתוכן. התיעוד הכללי שלה אומר שכתובות ה-CDN של Instagram מודעות לפרטיות, ומפסיקות להחזיר מדיה אחרי שהתוכן נמחק או פג תוקפו. מדריך תיוגי הסטוריז שלה אומר שכתובת סטורי מפסיקה להיטען כשהסטורי פג או נמחק. אפליקציה שצריכה קובץ תשלוף אותו כשהאירוע מגיע, במסגרת הכללים של Meta: מדיה של סטורי, למשל, אסור לאחסן או לשמור במטמון.

איזו מדיה לא מגיעה דרך הוובהוק?

המדריך להודעות Instagram של Meta מונה את הפערים הבאים, שהקוד צריך לצפות להם ולא להתייחס אליהם כשגיאות:

  • מדיה שנעלמת, לצפייה חד-פעמית או לאפשרות הפעלה חוזרת: קובץ מסוג ephemeral, ללא כתובת URL.
  • מדיה לא נתמכת: ההודעה מגיעה עם is_unsupported בערך true.
  • GIF וסטיקרים: המדריך אומר שהם לא מפעילים וובהוק, בעוד שהדוגמאות של Meta ל-Instagram Login מונות אותם תחת image.
  • התמונה שנבחרה בקרוסלה: תגובה להעברה של תמונה אחת בפוסט קרוסלה מדווחת על התמונה הראשונה.
  • שיתופים בכלל: מדריכי ההודעות של Meta עדיין אומרים שרק ה-URL של המדיה המשותפת נכלל, אף שעכשיו ig_post מוסיף את מזהה המדיה והכיתוב.

איך easyCoexistence מעביר קבצים מצורפים?

ללא שינוי, בתוך entry: הודעה ישירה עם מדיה מגיעה לנקודת הקצה שלכם עם מערך attachments של Meta כפי ש-Meta שלחה אותו, במעטפת של platform, account_id, external_id ו-entry, החתומה עם X-EC-Signature. קבצים מצורפים אינם מורדים, ואירועים אינם נשמרים כברירת מחדל: חשבון שאוטומציה פעילה בו שומר את הטקסט של ההודעה הישירה, ולא את המדיה שלה, במשך 7 ימים. שליפו את המדיה שאתם צריכים מהשדה payload.url כשהאירוע מגיע, ואל תשמרו מדיה של סטורי.

טעויות נפוצות

  • קריאת רק הקובץ הראשון. message.attachments הוא מערך, ובדוגמה של Meta יש שניים בהודעה אחת, לכן עברו על המערך בלולאה.
  • עדיין מזהים שיתוף פוסט לפי הסוג share. Meta תמכה בו לפוסטים עד 1 בפברואר 2026. קראו ig_post, עם מזהה המדיה והכיתוב ב-payload.
  • שמירת payload.url לשליפה מאוחרת. הכתובת מפסיקה להחזיר מדיה אחרי שהתוכן נמחק או פג תוקפו, לכן הורידו את מה שצריך ברגע ההגעה, למעט מדיה של סטורי.
  • קריאת payload.url בלי לבדוק את הסוג. מדיה לצפייה חד-פעמית מגיעה מסוג ephemeral, ללא כתובת URL, ומדיה לא נתמכת מסמנת את is_unsupported.
עושים את זה עם EasyCoexistence

האירוע חתום בסוד של אותו חשבון, ללא שמירת עותק, כך שהסוכן או הקוד שלכם שולפים את המדיה שהם צריכים. הפקודה send_social_dm עונה בתוך חלון ה-24 שעות. US$ 9 עד US$ 0.75 לכל חיבור בחודש, וירד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

אפשר לשמור מדיה מקובץ מצורף בהודעת Instagram?

שלפו את מה שצריך כשהאירוע מגיע, כי payload.url מפסיק להחזיר מדיה אחרי שהתוכן נמחק או פג תוקפו. מדיה של סטורי היא החריג: לפי הכללים של Meta אסור לאחסן אותה או לשמור אותה במטמון.

למה לאירוע הודעת Instagram אין כתובת מדיה?

בדרך כלל כי המדיה לצפייה חד-פעמית, שמגיעה כקובץ מצורף ephemeral ללא כתובת URL, או שהמדיה לא נתמכת, ואז השדה is_unsupported מקבל את הערך true.

האם GIF וסטיקרים מפעילים את וובהוק ההודעות של Instagram?

התיעוד של Meta לא עקבי: הדוגמאות שלה ל-Instagram Login מונות GIF וסטיקרים תחת image, ואילו מדריך ההודעות של Instagram אומר שהם לא מפעילים וובהוק. בדקו עם חשבון אמיתי.

האם אירוע הודעה אחד ב-Instagram יכול לשאת כמה קבצים מצורפים?

כן. message.attachments הוא מערך, והדוגמה של Meta מציגה שני פריטי מדיה בהודעה אחת.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-