קבצים מצורפים בהודעות 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 שולחת אותם.
סוג הקובץ לפוסט ששותף. ה-payload מוסיף, לצד url, את ig_post_media_id ואת title, הכיתוב של הפוסט.
סוג הקובץ הישן share הפסיק להיתמך בשיתופי פוסטים ב-Instagram.
סוג מדיה חד-פעמית שנעלמת, שמגיעה ללא כתובת URL.
נקבע לערך true באירוע הודעה כשההודעה מכילה מדיה שאינה נתמכת.
מה שמדווח כשמגיבים לתמונה אחת בפוסט קרוסלה או מעבירים אותה הלאה.
אילו סוגי קבצים מצורפים יכול לשאת אירוע DM?
הערכים שמונה רשימת הדוגמאות של Meta ל-Instagram Login בשדה message.attachments[].type, ולכל אחד מהם יש אובייקט payload. רוב ה-payload מכילים url למדיה ברשת ה-CDN של Meta. Meta מתעדת שדות payload נוספים רק ל-ig_post, ולכן קראו את הסוג לפני ה-payload.
איך נראה DM עם קבצים מצורפים?
אירוע messages שבו אובייקט message מכיל attachments במקום טקסט, או לצד טקסט. בדוגמה של Meta נשלחים שני פריטי מדיה בהודעה אחת, ולכל פריט יש type וגם payload.url משלו. לכן הקוד צריך לעבור על המערך, ולא לקרוא רק את האיבר הראשון:
{
"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:
"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.
האירוע חתום בסוד של אותו חשבון, ללא שמירת עותק, כך שהסוכן או הקוד שלכם שולפים את המדיה שהם צריכים. הפקודה 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
נבדק ב-