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

וובהוק התגובות של Instagram (Webhook): ה-payload, שדה אחר שדה

השדה comments של Instagram מודיע לאפליקציה כשמישהו מגיב, או משיב לתגובה, על מדיה של חשבון מקצועי, כולל ה-Reels שלו. Meta שולחת שינוי שבו השדה field מקבל את הערך comments, והשדה value כולל את המזהה ואת הטקסט של התגובה, את המזהה המוגבל ל-Instagram ואת שם המשתמש של הכותב בתוך from, את המזהה וסוג המוצר של המדיה, וכן parent_id כשהתגובה היא תשובה.

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

parent_id

קיים כשהתגובה היא תשובה, ומחזיק את המזהה של התגובה שהיא משיבה לה.

self_ig_scoped_id

מתווסף לתוך from כשהחשבון מגיב על המדיה שלו, לצד המזהה שלו.

live_comments

שדה נפרד לתגובות בשידור חי (Live). ההתראות שלו נעצרות כשהשידור מסתיים.

Advanced Access

Advanced Access נדרש להתראות comments ו-live_comments; מדיה של חשבון פרטי לא מפעילה אף התראה.

7 days

חלון הזמן לשליחת תשובה פרטית אחת לכותב, לפי המזהה של התגובה.

מתי השדה 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, כפי שהיא נשלחת:

A comments notification, as Meta sends it
{
  "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 ציבורית. לא נשמר עותק ולא מתבצע ניסיון חוזר.
A forwarded comment, headers included
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, שדורש הרשמה משלו ושותק כשהשידור מסתיים.
עושים את זה עם EasyCoexistence

כללי הפיכת תגובה ל-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, כך שאין צורך בקריאה נוספת כדי להציג מי הגיב.

המשיכו לקרוא

וובהוק (Webhook) של ההודעות ב-Instagram: ה-payload של ה-DM, ההדים והשדותמה וובהוק ההודעות של Instagram שולח על הודעה ישירה, שדה אחר שדה: מזהה השולח, טקסט, קבצים, תגובות לסטורי, הדים וחלון ה-24 שעות.אימות וובהוק (Webhook) של Instagram: hub.challenge וגם X-Hub-Signature-256איך מגדירים וובהוקים של Instagram: עונים ל-hub.challenge, בודקים את X-Hub-Signature-256 עם סוד האפליקציה, רושמים כל חשבון ומטפלים בניסיונות חוזרים.אירועי וובהוק (Webhook) של Instagram: תגובות, תיוגים והודעות DMכך מגיעים תגובות, תיוגים והודעות DM של Instagram לנקודת הקצה שלכם כאירועי וובהוק: מה כל payload כולל, איך נחתמות המסירות ומה לבדוק.תגובות פרטיות ב-Instagram דרך ה-API: מענה לתגובה בהודעה ישירהשליחת תגובה פרטית ב-Instagram עם ה-API: POST /<IG_ID>/messages עם מזהה התגובה, אחת לכל תגובה תוך 7 ימים, וקוד שגיאה 2534025.ניהול תגובות ב-Instagram דרך ה-APIאיך ה-API של Instagram קורא תגובות, משיב, מסתיר ומוחק: תשובות ציבוריות, הודעה פרטית אחת לתגובה תוך 7 ימים וכללי השימוש.@mentions ב-Instagram דרך ה-API: איתור ומענה להםאיך מגיעים @mentions של Instagram דרך ה-API ובוובהוק (Webhook) התגובות עם Instagram Login, ואיך משיבים להם בתגובות ובכיתובים.

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

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

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

נבדק ב-