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

וובהוק (Webhook) של message_reactions ב-Instagram: ה-payload של react ו-unreact

שדה message_reactions בוובהוק של Instagram מודיע לאפליקציה כשאדם מגיב להודעה בשיחה שלו עם חשבון מקצועי, או כשהוא מסיר את הריאקציה. האירוע נמצא במערך messaging, עם אובייקט reaction: mid, המזהה של ההודעה שאליה הגיבו; action, react או unreact; ורק ב-react, גם reaction, כמו love, וגם emoji, האימוג'י עצמו.

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

react / unreact

שני הערכים של reaction.action: הוספה של ריאקציה או הסרה של ריאקציה.

v12.0

החל מגרסת Graph API, Meta תומכת בריאקציות angry, sad, wow, love, like, laugh וגם other בוובהוק הזה.

No echo

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

Default

message_reactions הוא אחד השדות שמוצר Instagram חדש בלוח הבקרה של האפליקציה נרשם אליהם מראש.

100/sec

קריאות ה-Send API לשנייה לכל חשבון, עבור טקסט, קישורים, ריאקציות ומדבקות.

מתי message_reactions מופעל?

כשאדם מגיב להודעה בשיחה שלו עם החשבון המקצועי, וגם כשהוא מסיר את הריאקציה, ברגע שהאפליקציה והחשבון רשומים לשדה. מדריך Instagram Messaging של Meta מציין בבירור את הכיוון ההפוך: כשהחשבון עצמו מגיב או מסיר ריאקציה, לא נשלח עדכון, וגם לא נשלח הד דרך messages.

איך נראה עדכון על ריאקציה?

POST שבו השדה object מוגדר לערך instagram, ובשדה entry יש מערך messaging. בניגוד להודעה רגילה, האירוע לא כולל אובייקט message: הריאקציה נמצאת באובייקט reaction משלה, לצד sender, recipient וגם timestamp. הדוגמה של Meta עבור Instagram Login:

A message_reactions notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "reaction": {
            "mid": "<MESSAGE_ID>",
            "action": "react",
            "reaction": "love",
            "emoji": "\u{2764}\u{FE0F}"
          }
        }
      ]
    }
  ]
}

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

השדות ש-Meta מתעדת לאירוע ריאקציה, מהחיצוני אל הפנימי:

  • השדה entry[].id וכן recipient.id: החשבון המקצועי. sender.id: המזהה של האדם שהגיב, בתחום Instagram.
  • timestamp: מתי האירוע הופעל, במילישניות בדוגמאות של Meta; entry[].time הוא הזמן שבו Meta שלחה את העדכון.
  • reaction.mid: המזהה של ההודעה שאליה הגיבו, אותו mid שההודעה נשאה באירוע messages שלה.
  • reaction.action: react כשמוסיפים ריאקציה, unreact כשהיא מוסרת.
  • reaction.reaction: שם הריאקציה, כמו love; Meta מפרטת את angry, sad, wow, love, like, laugh וגם other.
  • reaction.emoji: האימוג'י כמחרוזת ב-Unicode, כמו \u{2764}\u{FE0F} עבור love.
  • ב-unreact השדות reaction וגם emoji לא נכללים.

איך נראה unreact?

אותו אירוע, כשהשדה action מוגדר ל-unreact ואין שדות reaction או emoji, כי אין מה לתת להם שם. התאימו אותו לריאקציה שהוא מסיר לפי reaction.mid וגם sender.id, והסירו את הריאקציה של אותו אדם מההודעה ברשומות שלכם.

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

לאיזו הודעה מצביע mid?

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

איך חשבון מגיב להודעה?

עם POST /<IG_ID>/messages: recipient.id מוגדר למזהה ה-Instagram של האדם, sender_action מוגדר ל-react, וה-payload מחזיק את message_id ואת reaction: אימוג'י, או הצורה שלו ב-UTF-8. חזרה על הקריאה עם אימוג'י אחר משנה את הריאקציה; כש-sender_action מוגדר ל-unreact ונשלח רק message_id, הריאקציה מוסרת. אף אחת משתי הקריאות לא יוצרת וובהוק.

Reacting to a person's message
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "id": "<IGSID>" },
  "sender_action": "react",
  "payload": {
    "message_id": "<MESSAGE_ID>",
    "reaction": "<EMOJI>"
  }
}

מה message_reactions דורש?

עם Instagram Login: הרשאות instagram_business_basic וגם instagram_business_manage_messages, ו-Advanced Access לחשבונות שהמפתח אינו בעליו או מנהלו. מוצר Instagram חדש בלוח הבקרה של האפליקציה נרשם אל השדה message_reactions מראש, וכל חשבון נרשם דרך POST /<IG_ID>/subscribed_apps. מדריך Send Messages של Meta מפרט אותו בשם messaging_reactions, אבל טבלת השדות שלו, ברירות המחדל בלוח הבקרה של האפליקציה ומדריך הוובהוק שלו כותבים message_reactions.

האם easyCoexistence מעביר ריאקציות?

לא. האפליקציה של easyCoexistence וכל חשבון מחובר רשומים לתגובות, להודעות ולאזכורים בלבד, ולכן אירועי message_reactions אינם מועברים לנקודת הקצה שלכם. ההודעות הישירות וההדים שאליהם הריאקציות מצביעות לפי השדה mid שלהם כן מגיעים אליה, חתומים בסוד של החשבון.

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

  • לחפש את הריאקציה בתוך message. לאירוע ריאקציה אין אובייקט message; קראו את אובייקט reaction שלצד sender וגם recipient.
  • קריאת reaction או emoji בלי לבדוק את action. שניהם לא נכללים ב-unreact, ולכן קוד שמניח שהם קיימים נשבר כשריאקציה מוסרת.
  • להמתין לוובהוק אחרי שהחשבון מגיב. Meta לא שולחת כלום לריאקציות של החשבון עצמו, אפילו לא הד, ולכן רשמו אותן כשהאפליקציה שלכם שולחת אותן.
  • להעתיק את השם messaging_reactions ממדריך Send Messages של Meta. השדה בטבלת השדות שלו, בברירות המחדל של לוח הבקרה ובמדריך הוובהוק הוא message_reactions.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

למה ריאקציה על פוסט קרוסלה מצביעה על התמונה הראשונה?

Meta מדווחת על התמונה הראשונה של הקרוסלה כשאדם מגיב לאחת מהתמונות שלה, ואולי זו לא התמונה שהאדם בחר.

האם Instagram שולח וובהוק כשהעסק מגיב להודעה?

לא. Meta לא שולחת עדכון message_reactions ולא הד כשהחשבון מגיב להודעה או מסיר ממנה ריאקציה.

אילו ריאקציות יכול הוובהוק של Instagram לדווח?

מדריך Instagram Messaging של Meta מפרט את angry, sad, wow, love, like, laugh וגם other החל מ-Graph API v12.0, והאימוג'י עצמו מופיע בשדה reaction.emoji.

האם שם השדה בוובהוק הוא message_reactions או messaging_reactions?

message_reactions. מדריך Send Messages של Meta כותב messaging_reactions, אבל טבלת השדות שלו, ברירות המחדל בלוח הבקרה של האפליקציה ומדריך הוובהוק כולם משתמשים בשם message_reactions.

המשיכו לקרוא

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

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

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

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

נבדק ב-