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

וובהוק messaging_postbacks של Instagram: ice breakers וכפתורים

שדה messaging_postbacks של וובהוק (Webhook) ב-Instagram מודיע לאפליקציה כשאדם לוחץ על שאלת ice breaker, על כפתור postback בתבנית, או על פריט בתפריט הקבוע בשיחה עם חשבון מקצועי. האובייקט ה-postback של האירוע כולל את השדה title, שהוא הטקסט שאותו לחץ האדם; את השדה payload, המחרוזת שהאפליקציה הגדירה לאפשרות הזו; והשדה mid, מזהה ההודעה, מ-Graph API v11.0 ומעלה.

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

4

מספר שאלות ice breaker מרבי שחשבון יכול להגדיר דרך Ice Breaker API של Meta.

v11.0

גרסת Graph API שממנה אירועי ה-postback כוללים mid. השדה עצמו דורש v8.0 ומעלה.

3

מספר הכפתורים המרבי בהודעת תבנית כפתורים, כל אחד מסוג postback או web_url.

24 hours

משך הזמן להגיב אחרי שאדם לוחץ על פריט בתפריט הקבוע, שפותח את חלון ההודעות הרגיל.

13

מספר התשובות המהירות המרבי שהודעה אחת מציעה; תשובה מהירה שנלחצה מגיעה בשדה messages, לא בשדה messaging_postbacks.

מתי השדה messaging_postbacks מופעל?

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

  • שאלת ice breaker, אחת מעד 4 שהחשבון מציע כשהשיחה מתחילה. לא זמין במחשב.
  • כפתור postback בתבנית כפתורים, עד 3 בהודעה, או בתבנית כללית, עד 3 בכל רכיב.
  • פריט postback בתפריט הקבוע של החשבון.
  • ice breaker שנלחץ בשיחה חדשה שנפתחה מקישור ig.me עם פרמטר ref: אז ה-postback כולל גם referral.
  • בדיקת הודעה עצמית, שבה החשבון לוחץ על הכפתור שלו: האירוע מוסיף is_self עם הערך true.

איך נראית הודעת postback?

אובייקט postback מופיע במקום שבו הייתה הודעת DM. הדוגמה של Meta ל-Instagram Login כוללת את mid, את title ואת payload, ומדריך ה-ice breaker שלה מציג את אותו אובייקט בלי mid. כך נראית ההודעה:

A messaging_postbacks notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "postback": {
            "mid": "<MESSAGE_ID>",
            "title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
            "payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
          }
        }
      ]
    }
  ]
}

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

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

  • sender.id: המזהה ב-Instagram של האדם שלחץ, המזהה שאליו משיבים. השדה recipient.id והשדה entry[].id: החשבון המקצועי.
  • timestamp: מתי האדם לחץ, לפי מדריך ה-ice breaker של Meta.
  • postback.title: שאלת ה-ice breaker או כותרת הכפתור שהאדם ראה.
  • postback.payload: המחרוזת שנקבעה לאפשרות הזו כשנוצרה, והאפליקציה בחרה אותה.
  • postback.mid: מזהה ההודעה שהלחיצה שלחה לחשבון, מ-Graph API v11.0.
  • postback.referral: מכיל את ref, source, type, כשהשיחה נפתחה מקישור ig.me עם פרמטר ref.
  • is_self: נשלח עם הערך true, לצד postback, כשהחשבון לוחץ על הכפתור שלו בבדיקת הודעה עצמית.

איך מגדירים ice breakers?

עם POST /<IG_ID>/messenger_profile אל graph.instagram.com: הבקשה כוללת platform עם הערך instagram ומערך ice_breakers, שבו call_to_actions מכיל עד 4 זוגות שאלה והערך payload, עם locale לכל קבוצה מתורגמת. GET /me/messenger_profile?fields=ice_breakers מציג אותן, ו-DELETE עם fields שמוגדר ל-ice_breakers מסיר אותן. הערך payload שנבחר כאן הוא מה שהשדה messaging_postbacks מחזיר כשלוחצים על השאלה.

Setting two ice breakers
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
        { "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
      ]
    }
  ]
}

איך שולחים כפתורי postback?

בתוך הודעה שהחשבון שולח עם POST /<IG_ID>/messages. תבנית כפתורים מכילה text של עד 640 תווים ובין 1 ל-3 כפתורים; תבנית כללית מכילה עד 10 רכיבים, לכל אחד עד 3 כפתורים. כפתור מסוג postback מחזיר את ה-payload שלו בשדה messaging_postbacks כשנלחץ, ואילו כפתור web_url פותח דף בדפדפן הפנימי של האפליקציה. התפריט הקבוע, שמוגדר דרך messenger_profile, מקבל את אותם שני סוגים.

האם תשובות מהירות עוברות דרך messaging_postbacks?

לא: הן מגיעות בשדה messages. תשובה מהירה שנלחצה מוצבת בשיחה כהודעה, ובאירוע messages מופיע השדה text עם הכותרת, והשדה quick_reply.payload עם ה-payload של האפשרות. הודעה יכולה להציע עד 13 תשובות מהירות של עד 20 תווים כל אחת, טקסט רגיל בלבד. ההנחיות של Meta לשליחת הודעות ב-Instagram מציינות גם ice breaker ובחירות של תבנית כללית בין מה ש-messages מדווח, ללא דוגמת payload.

האם לחיצה פותחת את חלון ההודעות?

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

האם easyCoexistence מעביר postbacks?

רק לחיצות על תשובות מהירות. הן מגיעות בשדה messages, שאליו רשומים האפליקציה של easyCoexistence וכל חשבון מחובר, ולכן הן מגיעות לנקודת הקצה שלכם עם quick_reply.payload. לחיצות על ice breaker, כפתורים ופריטי תפריט מגיעות בשדה messaging_postbacks, שאליו easyCoexistence אינו רשום, ולכן אינן מועברות.

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

  • המתנה לתשובות מהירות בשדה messaging_postbacks. תשובה מהירה מגיעה בשדה messages, עם quick_reply.payload לצד הטקסט של האפשרות שנלחצה.
  • ניתוב לפי postback.title. הכותרת היא מה שהאדם ראה, והיא יכולה להשתנות לפי השפה; נתבו לפי payload, שהאפליקציה קובעת.
  • לצפות לשדה mid בגרסת API ישנה. Meta כוללת את postback.mid רק מ-Graph API v11.0 ומעלה.
  • הגדרת יותר מ-4 ice breakers, או בדיקתם במחשב. ה-Ice Breaker API של Meta מקבל עד 4 שאלות, והתכונה אינה זמינה במחשב.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

איזה שדה וובהוק מדווח על לחיצות ice breaker ב-Instagram?

השדה messaging_postbacks מדווח על כך. אובייקט ה-postback מכיל את השאלה כ-title, את ה-payload שהוגדר לה, וכן את mid, שנוסף לאירוע החל מ-Graph API v11.0 ומעלה.

כמה ice breakers יכול לקבל חשבון Instagram?

עד 4 שאלות, שנקבעות ב-POST /<IG_ID>/messenger_profile עם platform בערך instagram, ואפשר לקבוע אותן לכל locale בנפרד.

איך משיבים ל-postback ב-Instagram?

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

האם לנתב postbacks של Instagram לפי title או payload?

לפי payload, המחרוזת שהאפליקציה הגדירה לאפשרות. title הוא הטקסט שהאדם ראה, ויכול להשתנות לפי השפה.

המשיכו לקרוא

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

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

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

נבדק ב-