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

שדות וובהוק של Instagram: הרשימה המלאה

בחשבון מקצועי ב-Instagram Login, טבלת שדות הוובהוק של Meta כוללת את comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover וכן standby, כאשר אזכורים מגיעים בתוך comments; הדוגמאות שלה מוסיפות את message_edit. כל אחד דורש את instagram_business_basic ואת instagram_business_manage_comments, או את instagram_business_manage_messages לרוב שדות ההודעות. ב-Instagram Login, השדה story_insights אינו מוצע כלל.

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

8

מוצר Instagram חדש ב-App Dashboard נרשם מלכתחילה לשדות, ביניהם comments, messages וגם message_reactions, כברירת מחדל.

Per app

השדות נבחרים לאפליקציה ולא לכל חשבון: חשבון מקבל את השדות שהאפליקציה בחרה.

Advanced Access

מדריך ההקמה של Meta מציין את רמת הגישה לוובהוקים של Instagram Login; להתראות על comments וגם live_comments נדרשת גישה מתקדמת.

story_insights

בטבלת השדות של Meta הוא מסומן כלא זמין ב-Instagram Login, ומוצע עם Facebook Login ו-Unified Login בלבד.

10 Sep 2025

הזמן שבו Meta הוסיפה את הוובהוק message_edit עבור Business Login for Instagram וגם Facebook Login for Business, לחשבונות עסקיים.

אילו שדות וובהוק Instagram Login מציע?

אלה, מתוך טבלת השדות של Meta, לצד מה שמפעיל כל אחד מהם לפי הדוגמאות וההפניה לוובהוקים. לכל שדה נדרשת גם instagram_business_basic מעבר להרשאה המוצגת, ולהתראות על comments וגם על live_comments נדרשת גישה מתקדמת.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

בחיבור Instagram Login, אילו שדות אינם זמינים?

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

  • story_insights: המדדים של Story כשהיא פוקעת, עם Facebook Login או Unified Login וההרשאה instagram_manage_insights. ב-Instagram Login, לפי ההפניה של Meta למדדי מדיה, וובהוק התובנות אינו נתמך.
  • השדות messaging_policy_enforcement וכן response_feedback מופיעים רק בעמודה של Instagram Messaging API שבטבלה.
  • mentions כשדה נפרד: Facebook Login ו-Unified Login מציעים אותו, עם instagram_manage_comments, בעוד ש-Instagram Login מקפל את האזכורים לתוך שדה comments הקיים.

איך נרשמים לשדות?

בשני מקומות. ב-App Dashboard, תחת הגדרות הוובהוק של מוצר Instagram, שומרים את כתובת ה-URL של ה-callback ואת אסימון האימות, מה שמפעיל את בקשת האימות של Meta, ואז בוחרים את השדות. מוצר Instagram חדש מתחיל רשום לשמונה מהם. לאחר מכן רושמים כל חשבון דרך נקודת הקצה POST /<IG_ID>/subscribed_apps, שנמצאת תחת graph.instagram.com, והשדה subscribed_fields מוגדר לשדות שנבחרו בלוח הבקרה, מופרדים בפסיקים.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

האם לכל חשבון יכולים להיות שדות שונים?

לא. מדריך ההקמה של Meta קובע שאי אפשר לבחור שדות לכל חשבון של משתמש באפליקציה: חשבון מקבל את השדות שנבחרו לאפליקציה. subscribed_fields בהרשמה של החשבון אמור לפרט את שדות לוח הבקרה, ולכן מטפל צריך לצפות לכל שדה שהאפליקציה בחרה, ולהכריע לפי מה שכל אירוע מכיל, ולא לפי מה שביקש מחשבון אחד.

איך מבדילים בין השדות בהתראה?

לפי צורת הרשומה. שדות תגובה מגיעים במערך changes, וכל שינוי מציין את השדה שלו. שדות הודעות מגיעים במערך messaging בלי שם שדה, והמפתח שלצד sender, recipient וכן timestamp מבדיל ביניהם:

  • changes[].field: comments או live_comments, והתגובה נמצאת בתוך value שלו.
  • message: messages, כולל ההדים של הודעות החשבון עצמו, שבהם is_echo שווה true בדיוק.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit, לעריכות הודעה.
  • referral לצד sender: messaging_referral; referral שבתוך message שייך לשדה messages, והוא מגיע משרשור חדש או ממודעת Click-to-Direct שנלחצה.
  • pass_thread_control, take_thread_control או request_thread_control: messaging_handover, כפי שההפניה לוובהוקים של Meta מונה אותם.

לאילו שדות רושמת easyCoexistence כל חשבון מחובר?

comments, messages וגם mentions, הרשימה שכל חשבון Instagram נרשם אליה בעת החיבור. עם Instagram Login האזכורים מגיעים בתוך comments, כך שהמנוי מכסה תגובות והודעות ישירות, כולל הדים, תשובות לסטוריז, אזכורים בסטוריז וקבצים מצורפים בין ההודעות הישירות. שאר השדות בטבלה Meta מוסרת לאפליקציה שנרשמה אליהם, והם אינם חלק מהמנוי של החיבור. לאחר שנקבעה נקודת הקצה באמצעות set_social_webhook_destination או דרך ה-Partner API, easyCoexistence בודק את החתימה של Meta, עונה ל-Meta מיד ושולח POST של כל רשומה השייכת לחשבון אליה:

  • platform וכן external_id: instagram, ומזהה החשבון ב-Instagram, שערכו זהה לזה של entry.id באותה רשומה.
  • account_id: מזהה החיבור ב-easyCoexistence, זה שכלי ה-MCP מקבלים.
  • entry: הרשומה של Meta לחשבון, ללא שינוי. השדה object של Meta וכותרת X-Hub-Signature-256 אינם מועברים הלאה.
  • X-EC-Signature: t=<unix>,v1=<hex>, הוא HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי, עם המפתח הסודי של החשבון עצמו.
  • מסירה: ניסיון אחד של עד 8 שניות, בלי מעקב אחרי הפניות, בלי שמירת עותק ובלי ניסיונות חוזרים.

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

  • לחכות לשדה mentions עם Instagram Login. Meta מקפלת אזכורים לתוך התראת התגובות, כך שמטפל שמופעל לפי השדה mentions לעולם לא ירוץ.
  • להניח שחשבון מקבל רק את השדות שהמנוי שלו ציין. Meta מעבירה את השדות שנבחרו לאפליקציה, לכן יש לסווג לפי מה שכל אירוע מכיל.
  • להתייחס אל message.referral וגם אל referral ברמה העליונה כאל אירוע אחד. הראשון שייך לשדה messages; השני הוא messaging_referral, עבור קישור ig.me שנפתח בשיחה קיימת.
  • לחכות לשדה story_insights עם Instagram Login. Meta מסמנת אותו כלא זמין שם, ולכן יש לקרוא את המדדים של Story מנקודת הקצה של התובנות בזמן שהיא פעילה.
עושים את זה עם EasyCoexistence

אירועים אינם נשמרים כברירת מחדל; חשבון שאוטומציה פעילה בו שומר את ההודעות הישירות והתגובות שלו במשך 7 ימים. נקודת הקצה נקבעת עם set_social_webhook_destination מ-Claude או מ-ChatGPT, או דרך ה-Partner API. US$ 9 עד US$ 0.75 לחיבור לחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם ל-Instagram Login יש שדה mentions נפרד?

לא. Meta כוללת אזכורים בהתראת התגובות עבור Instagram Login; mentions הוא שדה משלו במסלולי Facebook Login ו-Unified Login בלבד.

בחיבור Instagram Login, האם השדה story_insights זמין?

לא. טבלת השדות של Meta מסמנת אותו כלא זמין ב-Instagram Login, וההפניה למדדי מדיה קובעת שוובהוק התובנות אינו נתמך שם.

וובהוק ההודעות של Instagram דורש אילו הרשאות?

instagram_business_basic וגם instagram_business_manage_messages, עם Advanced Access, כפי שמדריך ההקמה של Meta מציין לוובהוקים של Instagram Login.

מתי נוסף הוובהוק message_edit לחשבונות ב-Instagram?

ב-10 בספטמבר 2025, עבור Business Login for Instagram וגם Facebook Login for Business, לחשבונות עסקיים. עריכה מגיעה במערך messaging תחת המפתח message_edit, שמזהה אותה.

המשיכו לקרוא

וובהוק התגובות של Instagram (Webhook): ה-payload, שדה אחר שדהמה וובהוק התגובות של Instagram שולח כשמישהו מגיב לפוסטים וה-Reels של חשבון: ה-payload שדה אחר שדה, מה שהוא לא כולל, והמלכודות.וובהוק (Webhook) של ההודעות ב-Instagram: ה-payload של ה-DM, ההדים והשדותמה וובהוק ההודעות של Instagram שולח על הודעה ישירה, שדה אחר שדה: מזהה השולח, טקסט, קבצים, תגובות לסטורי, הדים וחלון ה-24 שעות.וובהוק (Webhook) של message_reactions ב-Instagram: ה-payload של react ו-unreactמה נשלח בוובהוק message_reactions של Instagram כשאדם מגיב להודעה או מסיר ריאקציה: mid, action, reaction ו-emoji, ומתי הוא לא שולח דבר.וובהוק messaging_postbacks של Instagram: ice breakers וכפתוריםמה שוובהוק (Webhook) messaging_postbacks של Instagram שולח כשאדם לוחץ על ice breaker, כפתור או פריט בתפריט, וכיצד מגדירים אותו.וובהוק messaging_referral של Instagram: קישורי ig.me ופניות ממודעותמה אירוע messaging_referral של Instagram שולח כשמישהו פותח קישור ig.me עם ref, ואיפה הפניות לשיחה חדשה ומודעות מגיעות במקום.וובהוק (Webhook) של live_comments ב-Instagram: תגובות בזמן שידור חימה שוובהוק live_comments של Instagram שולח בזמן שידור חי: ה-payload, ההבדל מתגובות רגילות, ואיך משיבים לתגובה בשידור.

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

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

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

נבדק ב-