וובהוק התגובות של Instagram (Webhook): ה-payload, שדה אחר שדה
השדה comments של Instagram מודיע לאפליקציה כשמישהו מגיב, או משיב לתגובה, על מדיה של חשבון מקצועי, כולל ה-Reels שלו. Meta שולחת שינוי שבו השדה field מקבל את הערך comments, והשדה value כולל את המזהה ואת הטקסט של התגובה, את המזהה המוגבל ל-Instagram ואת שם המשתמש של הכותב בתוך from, את המזהה וסוג המוצר של המדיה, וכן parent_id כשהתגובה היא תשובה.
easyCoexistence רושמת כל חשבון Instagram מחובר לקבלת תגובות, ומעבירה את אירועי התגובות ש-Meta שולחת עבורו לנקודת הקצה ה-HTTPS שלכם כשהם מגיעים, חתומים במפתח הסודי של אותו חשבון, בלי לשמור עותק.
קיים כשהתגובה היא תשובה, ומחזיק את המזהה של התגובה שהיא משיבה לה.
מתווסף לתוך from כשהחשבון מגיב על המדיה שלו, לצד המזהה שלו.
שדה נפרד לתגובות בשידור חי (Live). ההתראות שלו נעצרות כשהשידור מסתיים.
Advanced Access נדרש להתראות comments ו-live_comments; מדיה של חשבון פרטי לא מפעילה אף התראה.
חלון הזמן לשליחת תשובה פרטית אחת לכותב, לפי המזהה של התגובה.
מתי השדה comments מופעל?
כשמישהו מגיב על מדיה שבבעלות החשבון המקצועי, או מזכיר את החשבון, לאחר שגם האפליקציה וגם החשבון נרשמו לשדה. כל תגובה היא שינוי אחד בהתראה, וכל המקרים הבאים חולקים את אותו מבנה:
- תגובה חדשה על פוסט, על Reels, על Story או על מודעה, והשדה media.
media_product_typeמציין על איזה משטח נמצאת המדיה. - תשובה לתגובה קיימת, שנושאת את השדה
parent_idעם המזהה של התגובה שהיא משיבה לה. - תגובה שהחשבון כותב על המדיה שלו עצמו, כולל התשובות לה. השדה from.id הוא המזהה של החשבון, ולשדה from נוסף השדה
self_ig_scoped_idכשהחשבון הוא הכותב. - אזכור של החשבון: עם Instagram Login, Meta כוללת את האזכורים בהתראת התגובות ולא בשדה נפרד משלהם.
- תגובה במהלך שידור חי מגיעה בשדה נפרד,
live_comments, עם אותו מבנה ערך, ומפסיקה כשהשידור מסתיים.
איך נראית התראת תגובות?
זו בקשת POST שבה ה-JSON מכיל את השדה object עם הערך instagram, ומערך entry. כל entry הוא חשבון מקצועי אחד: המזהה שלו, השעה שבה Meta שלחה את ההתראה, ומערך changes שמחזיק שינוי אחד לכל תגובה. להלן מבנה ההתראה לתשובה לתגובה על Reel, כפי שהיא נשלחת:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}מה כל שדה אומר?
השדות ש-Meta מפרטת במסמך העזר שלה להתראת תגובה, מבחוץ פנימה:
- entry[].id: המזהה של החשבון המקצועי, כלומר
user_idשמחזיר /me עבורו. הוא מראה לאיזה חשבון שייכת התגובה. - entry[].time: מתי Meta שלחה את ההתראה, כחותמת זמן של Unix. זה לא הזמן שבו נכתבה התגובה.
- changes[].field: comments, או
live_commentsלשידור חי. בדקו אותו לפני הקריאה של השדה value, שבו נמצא התוכן. - value.id: המזהה של התגובה. לפיו משיבים בפומבי או בפרטי, מסתירים או מוחקים.
- value.text: הטקסט של התגובה, שמופיע רק כשיש בה טקסט.
- value.from.id ו-value.from.username: המזהה המוגבל ל-Instagram ושם המשתמש של הכותב. value.from.
self_ig_scoped_idמופיע כשהחשבון עצמו כתב את התגובה. - value.media.id ו-value.media.
media_product_type: המדיה שעליה הגיבו ומשטחה. במסמך העזר מופיעים הערכים AD, FEED, STORY ו-REELS, וכך נקבע משטח המדיה. - value.
parent_id: בתשובה, המזהה של התגובה שהיא משיבה לה. לתגובה ברמה העליונה אין שדה כזה. - value.media.
ad_id,ad_titleו-original_media_id: מופיעים במסמך העזר לתגובות על מודעה.
מה השדה comments לא מדווח?
כמה דברים שמפתחים עשויים לצפות להם לא נכללים באירוע, או לא נשלחים בכלל, לפי מדריך ההגדרה ומסמכי העזר:
- תגובות על מדיה של חשבון פרטי: Meta לא שולחת עבורן התראות תגובה או אזכור.
- מזהי אלבומים: האירוע לא כולל אותם, ו-Meta ממליצה לחפש את האלבום לפי מזהה התגובה.
- מזהי מודעות למדיה שמשמשת במודעות דינמיות.
- זמן היצירה של התגובה. הבקשה GET /<
COMMENT_ID>?fields=timestamp מחזירה אותו בפורמט ISO 8601, שהוא תקן בינלאומי. - תגובות לשידור חי אחרי שהשידור מסתיים, כשההתראות על מדיה חיה נפסקות.
- אזכורים ב-Story: ממשק האזכורים של Meta אינו תומך בהם, והם מגיעים לחשבון כהודעות ישירות.
- אירועי עבר: Meta לא שומרת היסטוריית התראות לשאילתה, ולכן שמרו את מה שנחוץ לכם כשכל אירוע מגיע.
מה דרוש לשדה comments?
הרשאות instagram_business_basic ו-instagram_business_manage_comments ב-Instagram Login, וגישה מתקדמת (Advanced Access), ש-Meta דורשת להתראות comments ו-live_comments. האפליקציה חייבת להיות Live ולהירשם לשדה comments ב-App Dashboard, וכל חשבון צריך להירשם דרך POST /<IG_ID>/subscribed_apps עם comments בין השדות subscribed_fields. Meta ממליצה בתוקף על הוובהוק הזה על פני שאילתות חוזרות לתגובות, כי הוא חוסך את מגבלת הקצב.
איך משיבים לתגובה מהאירוע?
בעזרת המזהים שהוא נושא. POST /<COMMENT_ID>/replies עם message מפרסם תשובה פומבית מתחת לתגובה, באמצעות השדה value.id. POST /<IG_ID>/messages עם recipient.comment_id שמוגדר לערך של value.id שולח לכותב תשובה פרטית אחת, בתוך 7 ימים מהתגובה, או כל עוד השידור החי נמשך. from.id הוא מזהה מוגבל ל-Instagram, אבל הודעה ישירה שנשלחת אליו נכשלת עד שהאדם שלח הודעה לחשבון, ולכן התשובה הפרטית היא הדרך להגיע אליו בהודעה ישירה.
איך easyCoexistence מעבירה תגובה?
כשהיא מגיעה, אחרי שנקבעה נקודת קצה לחשבון עם set_social_webhook_destination מ-Claude או מ-ChatGPT, או עם PUT /channels/:id/webhook ב-Partner API. easyCoexistence רושמת כל חשבון Instagram מחובר לשדות שמעבירים את התגובות, האזכורים וההודעות הישירות שלו, בודקת את החתימה של Meta על כל משלוח, עונה ל-Meta מיד, ו-POST את כל entry של החשבון לכתובת ה-HTTPS שלכם, במעטפה:
- platform ו-
external_id: הערך instagram, והמזהה של החשבון ב-Instagram, זהה למה שמופיע ב-entry.id, כלומר למזהה של החשבון. account_id: המזהה של החיבור ב-easyCoexistence, זה ש-list_social_accountsמחזיר, וכלי ה-MCP מקבלים אותו.- entry: הערך entry של Meta לחשבון, ללא שינוי, כך ששליחה מקובצת הופכת ל-POST אחד לכל entry בנפרד. השדה object של Meta והכותרת X-Hub-Signature-256 לא מועברים הלאה.
- משלוח: ניסיון אחד, עם המתנה של עד 8 שניות, בלי לעקוב אחרי הפניות, לכתובת HTTPS שנפתרת לכתובת IP ציבורית. לא נשמר עותק ולא מתבצע ניסיון חוזר.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}מה כללי הפיכת תגובה ל-DM עושים עם אותו אירוע?
הם קוראים אותו לצד ההעברה. כלל תואם כשהתגובה מכילה אחת ממילות המפתח שלו, בלי הבחנה בין אותיות גדולות לקטנות, על פוסט אחד שנבחר או על כל הפוסטים, ושולח לכותב את ה-DM של הכלל כתשובה הפרטית שלו, ובנוסף תשובה פומבית, אם יש לכלל כזו. תגובות שהחשבון עצמו כתב מדולגות, אוטומציות שמתחילות בתגובה לוקחות את אלה שאף כלל לא ענה להן, ותגובה שכלל ענה לה עדיין מגיעה לנקודת הקצה שלכם. התשובה הפומבית של הכלל יכולה לחזור כאירוע comments חדש מהחשבון עצמו.
טעויות נפוצות
- לחפש את comment_id. תחת Instagram Login המזהה של התגובה נמצא בשדה value.id, ואילו comment_id שייך ל-payload של שיטות ההתחברות האחרות, שמנוהלות אחרת.
- להשיב לתגובות של החשבון עצמו. התשובות שלו מגיעות כאירועים comments שבהם from.id זהה לזה של entry.id, ואוטומציה שמשיבה להן מתחילה לדבר עם עצמה.
- לקרוא את entry.time כזמן התגובה. השדה הזה מתעד מתי Meta שלחה את ההתראה, ואילו השדה timestamp של התגובה עצמה מראה מתי נכתבה.
- לחכות לתגובות Live בשדה comments. הן מגיעות לשדה live_comments, שדורש הרשמה משלו ושותק כשהשידור מסתיים.
כללי הפיכת תגובה ל-DM ואוטומציות משיבים לאותן תגובות לאורך כל שעות היממה. מ-US$ 9 לחיבור בחודש, שיורד ל-US$ 0.75 ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם וובהוק התגובות של Instagram כולל תשובות לתגובות?
כן. תשובה מגיעה כאירוע comments משלה, כשהשדה parent_id מחזיק את המזהה של התגובה שהיא משיבה לה.
האם תגובות על Reels מפעילות את הוובהוק של Instagram?
כן. תגובה על Reel מגיעה בשדה comments כמו תגובה על פוסט, והשדה media.media_product_type מבדיל ביניהם.
למה הוובהוק של Instagram שלי לא מופעל?
לרוב הסיבה היא ש: האפליקציה אינה Live או חסרה לה Advanced Access, החשבון מעולם לא נרשם דרך /subscribed_apps, המדיה שייכת לחשבון פרטי, או שהתגובה הייתה בשידור חי ושם נשלחת דרך live_comments במקום.
האם וובהוק התגובות כולל את שם המשתמש של המגיב?
כן. השדה value.from נושא את שם המשתמש של האדם לצד המזהה שלו המוגבל ל-Instagram, כך שאין צורך בקריאה נוספת כדי להציג מי הגיב.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-