שדות וובהוק של 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 שלכם ברגע שהם מגיעים, חתומים במפתח הסודי של אותו חשבון.
מוצר Instagram חדש ב-App Dashboard נרשם מלכתחילה לשדות, ביניהם comments, messages וגם message_reactions, כברירת מחדל.
השדות נבחרים לאפליקציה ולא לכל חשבון: חשבון מקבל את השדות שהאפליקציה בחרה.
מדריך ההקמה של Meta מציין את רמת הגישה לוובהוקים של Instagram Login; להתראות על comments וגם live_comments נדרשת גישה מתקדמת.
בטבלת השדות של Meta הוא מסומן כלא זמין ב-Instagram Login, ומוצע עם Facebook Login ו-Unified Login בלבד.
הזמן שבו Meta הוסיפה את הוובהוק message_edit עבור Business Login for Instagram וגם Facebook Login for Business, לחשבונות עסקיים.
אילו שדות וובהוק Instagram Login מציע?
אלה, מתוך טבלת השדות של Meta, לצד מה שמפעיל כל אחד מהם לפי הדוגמאות וההפניה לוובהוקים. לכל שדה נדרשת גם instagram_business_basic מעבר להרשאה המוצגת, ולהתראות על comments וגם על live_comments נדרשת גישה מתקדמת.
בחיבור 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 מוגדר לשדות שנבחרו בלוח הבקרה, מופרדים בפסיקים.
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 מנקודת הקצה של התובנות בזמן שהיא פעילה.
אירועים אינם נשמרים כברירת מחדל; חשבון שאוטומציה פעילה בו שומר את ההודעות הישירות והתגובות שלו במשך 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, שמזהה אותה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-