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

תיוגים ותגובות לסטורי בוובהוק (Webhook)

Instagram שולח תיוגים ותגובות בסטורי כהודעות ישירות בשדה messages של הוובהוק. תיוג מגיע כהודעה שהשדה attachments שלה מכיל פריט מסוג story_mention, וכתובת ה-CDN של הסטורי נמצאת בשדה payload.url. תגובה כוללת את הטקסט של האדם ואת השדה reply_to.story, עם השדה url והשדה id של הסטורי, וכן את השדה link_sticker_url בסטורי עם מדבקת קישור.

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

story_mention

סוג הקובץ המצורף לאירוע messages ש-Meta שולחת כשאדם מתייג את החשבון בסטורי שלו.

link_sticker_url

השדה שנוסף ב-12 בדצמבר 2025 לתוך reply_to.story, ובו כתובת מדבקת הקישור של הסטורי שנענה.

24 hours

משך החיים של הסטורי; אחרי שפג תוקפו או נמחק, כתובת התיוג שלו מפסיקה להיטען.

Public

החשבונות שמהם מגיעים תיוגים בסטורי; תיוג מחשבון פרטי מגיע רק אם הוא עוקב אחרי החשבון העסקי.

GIF, sticker

תגובות לסטורי שהוובהוק אינו תומך בהן, לפי מדריך ההודעות של Instagram מבית Meta.

איך מגיע תיוג בסטורי?

כהודעה ישירה. כשאדם מתייג את החשבון העסקי בסטורי שלו, Instagram מציב בתיבת הדואר של החשבון הודעה שמתייחסת לסטורי הזה, ו-Meta שולחת עבורה אירוע messages. השדה sender.id הוא ה-Instagram-scoped ID של האדם. השדה message.attachments מכיל פריט אחד מסוג story_mention, ובשדה payload.url שלו נמצאת כתובת ה-CDN של הסטורי. בדוגמאות של Meta אין טקסט, לכן יש לקרוא את הקובץ המצורף:

A Story mention, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "attachments": [
              {
                "type": "story_mention",
                "payload": { "url": "<CDN_URL>" }
              }
            ]
          }
        }
      ]
    }
  ]
}

איך מגיעה תגובה לסטורי?

גם היא כהודעה ישירה, עם הטקסט של האדם ואובייקט reply_to שמצביע על הסטורי של החשבון. השדה reply_to.story נושא את כתובת ה-CDN של הסטורי ואת המזהה שלו. בעמוד הוובהוק של Meta מופיע גם השדה link_sticker_url, שנוסף בדצמבר 2025 לתגובות לסטורי עם מדבקת קישור, ומומלץ להשתמש בו כדי לנתב אוטומציות לפי קישור. תגובה מצוטטת להודעה קודמת משתמשת בשדה reply_to.mid במקום זה.

The message object of a Story reply
"message": {
  "mid": "<MESSAGE_ID>",
  "text": "<MESSAGE_TEXT>",
  "reply_to": {
    "story": {
      "url": "<CDN_URL>",
      "id": "<STORY_ID>"
    }
  }
}

מה כל שדה אומר?

השדות ש-Meta מתעדת לשני האירועים האלה, מבחוץ פנימה:

  • השדה entry[].id וכן השדה recipient.id: החשבון העסקי. השדה sender.id: מזהה ה-Instagram של האדם, שאליו נשלחת התגובה.
  • השדה timestamp: מתי נשלחה ההודעה, במילישניות בדוגמאות של Meta. השדה entry[].time הוא מתי נשלחה ההתראה מ-Meta.
  • השדה message.mid: מזהה ההודעה, לזיהוי ניסיונות חוזרים ולשליחת תגובה מצוטטת באמצעות reply_to.mid.
  • סוג הקובץ attachments[].type עם הערך story_mention, והשדה payload.url: תיוג וכתובת ה-CDN של הסטורי שיצר אותו.
  • השדות reply_to.story.url וכן reply_to.story.id: הסטורי של החשבון שאליו האדם הגיב.
  • השדה reply_to.story.link_sticker_url: הכתובת שבמדבקת הקישור של אותו סטורי.
  • השדה message.text: הטקסט של התגובה, כשההודעה מכילה טקסט.

כמה זמן כתובת הסטורי עובדת?

כל עוד הסטורי קיים. סטורי נעלם אחרי 24 שעות או כשמחברו מוחק אותו, ולפי מדריך התיוגים בסטורי של Meta, כתובת ה-URL מפסיקה להיטען. בסקירה שלו Meta מציינת שכתובות ה-CDN של Instagram מודעות לפרטיות, ומחזירות ריק עבור תוכן שנמחק או פג תוקפו. המדריך מתיר לשמור את כתובת ה-CDN אך לא את המדיה: אפליקציה אינה רשאית לאחסן או לשמור במטמון את תוכן הסטורי בשרתים שלה, וצריכה להציג תמונת מציין מקום אחרי שהסטורי נעלם.

מתי אף אחד מהאירועים לא מופעל?

מדריכי Meta מציינים את המקרים האלה, שבהם מטפל שמחכה לאירוע סטורי לא מקבל כלום:

  • תיוג בסטורי של חשבון פרטי שאינו עוקב אחרי החשבון העסקי.
  • תיוג בפוסט רגיל: לפי Meta, רק תיוגים בסטורי מפעילים את הוובהוק של messages, ולא תיוג בפוסטים.
  • תגובה לסטורי עם GIF או עם מדבקה, שהוובהוק אינו תומך בה.
  • תיוגים בסטורי דרך ה-API של התיוגים: נקודת הקצה GET /<IG_ID>/tags וגם POST /<IG_ID>/mentions אינן תומכות בהם, ולכן ההודעה הישירה היא הדרך שבה הם מגיעים.

האם תיוגים ותגובות לסטורי פותחים את חלון ההודעות?

תגובה היא הודעה מהאדם, ו-Meta מונה את התיוגים בסטורי בין הדרכים שבהן אדם פותח שיחה. החלון שהפעולה שלו פותחת נמשך 24 שעות ברוב הפעולות, ולכן החשבון יכול לענות באמצעות POST /<IG_ID>/messages כשהשדה recipient.id מקבל את הערך של השדה sender.id באירוע, בזמן שהחלון פתוח. התשובה של החשבון חוזרת כאירוע messages מסוג echo, כשהערך של השדה is_echo הוא true.

איך easyCoexistence מעביר אותם?

בשדה messages, שאליו רשום כל חשבון מחובר, כך שתיוגים בסטורי ותגובות לסטורי מגיעים לנקודת הקצה שלכם יחד עם שאר ההודעות הישירות של החשבון. כל אירוע נשלח בתוך מעטפה עם השדות platform, account_id, external_id וגם entry, חתום בכותרת X-EC-Signature עם הסוד של החשבון, נשלח פעם אחת וללא עותק שנשמר. הכלי send_social_dm עונה לאדם, ומעביר את הערך של השדה sender.id כשדה recipient_id, בתוך חלון ה-24 שעות.

A forwarded Story mention, 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": 1793448000512,
    "messaging": [
      {
        "sender": { "id": "<IGSID>" },
        "recipient": { "id": "<IG_ID>" },
        "timestamp": 1793447999874,
        "message": {
          "mid": "<MESSAGE_ID>",
          "attachments": [
            { "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
          ]
        }
      }
    ]
  }
}

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

  • שמירת המדיה של הסטורי. המדריך של Meta לתיוגים בסטורי מתיר לשמור את כתובת ה-CDN, לא את התוכן, והתוכן אסור לאחסן או לשמור במטמון בשרתים שלכם.
  • קריאה רק של message.text. תיוג בסטורי נושא קובץ מסוג story_mention, ובדוגמאות של Meta אין בו טקסט, ולכן מטפל שקורא טקסט בלבד רואה הודעה ריקה.
  • הצגת כתובת הסטורי ימים אחר כך. היא מפסיקה לעבוד כשהסטורי פג אחרי 24 שעות או נמחק, לכן מכאן והלאה יש להציג תמונת מציין מקום.
  • חיפוש תיוגים בסטורי בשדה comments או ב-API של התיוגים. הם נשלחים כהודעות ישירות בשדה messages.
עושים את זה עם EasyCoexistence

הכלי send_social_dm עונה לאדם בתוך חלון ה-24 שעות, מ-Claude, מ-ChatGPT או מהקוד שלכם. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם לאירוע תיוג בסטורי ב-Instagram יש טקסט?

לא בדוגמאות של Meta. תיוג בסטורי נושא קובץ מסוג story_mention עם כתובת ה-CDN של הסטורי, ולכן מטפל שקורא את message.text בלבד רואה הודעה ריקה.

מה זה link_sticker_url בתגובה לסטורי של Instagram?

זו הכתובת שבמדבקת הקישור של הסטורי שהאדם ענה לו, בשדה reply_to.story.link_sticker_url. השדה נוסף ב-12 בדצמבר 2025, וממליצים להשתמש בו לניתוב אוטומציות לפי קישור.

האם תגובות לסטורי עם GIF או מדבקה מפעילות את הוובהוק?

לא. לפי מדריך ההודעות של Instagram מבית Meta, הוובהוק אינו תומך בתגובות לסטורי שנשלחו עם GIF או מדבקה.

האם תיוג בסטורי מחשבון פרטי מפעיל את הוובהוק?

רק כשהחשבון הפרטי עוקב אחרי החשבון העסקי. תיוגים מחשבונות ציבוריים מגיעים ברגע שהם קורים.

המשיכו לקרוא

קבצים מצורפים בהודעות Instagram בוובהוק (Webhook) ההודעותסוגי הקבצים המצורפים שאירוע הודעה ב-Instagram יכול לשאת, מתמונה ווידאו ועד ig_post, ig_reel או story_mention, עם payload וכתובות URL.וובהוק (Webhook) של ההודעות ב-Instagram: ה-payload של ה-DM, ההדים והשדותמה וובהוק ההודעות של Instagram שולח על הודעה ישירה, שדה אחר שדה: מזהה השולח, טקסט, קבצים, תגובות לסטורי, הדים וחלון ה-24 שעות.תובנות סטורי של Instagram דרך ה-APIמדדי הסטורי ב-API של Instagram, מהגעה ועד ניווט, כמה זמן הם זמינים ולמה חלקם מחזירים קוד שגיאה 10.@mentions ב-Instagram דרך ה-API: איתור ומענה להםאיך מגיעים @mentions של Instagram דרך ה-API ובוובהוק (Webhook) התגובות עם Instagram Login, ואיך משיבים להם בתגובות ובכיתובים.הודעות DM ב-Instagram דרך ה-API וחלון ההודעות של 24 שעותאיך פועלות הודעות DM ב-Instagram דרך ה-API: למי אפשר לכתוב, חלון 24 השעות, תגובות פרטיות והגדרת הגישה להודעות.שדות וובהוק של Instagram: הרשימה המלאהשדות וובהוק (Webhook) ש-Meta מפרסמת ל-Instagram API עם Instagram Login: מה מפעיל כל שדה, ההרשאה הנדרשת לו, ואלה שנשארו ל-Facebook Login.

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

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

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

נבדק ב-