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

וובהוק messaging_referral של Instagram: קישורי ig.me ופניות ממודעות

שדה messaging_referral של Instagram בוובהוק (Webhook) מודיע לאפליקציה כשאדם שכבר מנהל שיחה עם חשבון עסקי פותח קישור ig.me שנושא פרמטר ref. האירוע כולל אובייקט referral ברמה העליונה: ref, שהוא ערך הפרמטר; source, שערכו SHORTLINKS; והשדה type, שערכו OPEN_THREAD. הפניה שנושאת ref על שיחה חדשה מגיעה במקום זאת בתוך האירוע messages או messaging_postbacks, לפי מה שהאדם עשה.

easyCoexistence רושם כל חשבון Instagram מחובר לתגובות, להודעות ולאזכורים, ולכן ref בהודעה הראשונה של שיחה חדשה והפניה ממודעת Click-to-Direct מגיעים לנקודת הקצה שלכם ב-HTTPS בתוך ה-DM שהועבר, חתומים במפתח הסודי של אותו חשבון.

2,083

המספר המרבי של תווים שפרמטר ref של קישור ig.me יכול להכיל, באותיות, ספרות, מקפים, קווים תחתיים וסימני שוויון בלבד.

OPEN_THREAD

סוג ההפניה לקישורי ig.me; גם הפניה ממודעת Click-to-Direct משתמשת בו, עם source ADS.

24 hours

הזמן שיש לאפליקציה כדי להשיב לאחר הפניה בשיחה קיימת, וזה מאפס את חלון ההודעות הסטנדרטי.

7 days

כמה זמן יכול החלון להימשך אחרי הודעה ראשונה שנשלחת לאחר לחיצה על מודעת Click-to-Direct.

Instagram Web

היכן קישורי ig.me אינם נתמכים, לפי מדריך Meta

מתי messaging_referral מופעל?

כשאדם שכבר מנהל שיחה עם החשבון העסקי פותח קישור ig.me שנושא פרמטר ref. Instagram פותח את השיחה הקיימת, ו-Meta שולחת את ההפניה בעצמה, בלי הודעה. היכן ההפניה מגיעה תלוי בשיחה ובמה שהאדם עושה:

Existing threadmessaging_referral: a referral object beside sender, with no message.
New thread, ice breaker tappedmessaging_postbacks: postback.referral beside title and payload.
New thread, message typedmessages: message.referral beside mid.
Click-to-Direct admessages: message.referral with source ADS, ad_id and ads_context_data.

איך נראה אירוע הפניה?

אירוע הודעה שבו אובייקט referral יושב לצד sender, recipient ו-timestamp, בלי message או postback סביבו. מדריך ig.me של Meta נותן את ערכי ההפניה, בתוך אותה מעטפת כמו שאר אירועי ההודעות של Instagram:

A messaging_referral notification
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "referral": {
            "ref": "<REF_PARAMETER_VALUE>",
            "source": "SHORTLINKS",
            "type": "OPEN_THREAD"
          }
        }
      ]
    }
  ]
}

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

השדות ש-Meta מתעדת להפניה של ig.me, מבחוץ פנימה:

  • sender.id: המזהה בהיקף Instagram של האדם שפתח את הקישור. recipient.id ו-entry[].id: החשבון העסקי.
  • referral.ref: ערך הפרמטר ref של הקישור, כפי שהקישור נשא אותו.
  • referral.source: SHORTLINKS בדוגמאות של Meta לקישורי ig.me. טבלה אחת במדריך Instagram Messaging שלה כותבת SHORTLINK, ודף הדוגמאות שלה מציג מציין מקום.
  • referral.type: OPEN_THREAD, הערך שבו Meta משתמשת בהפניות של קישורים.
  • timestamp: הרגע שבו האירוע הופעל, במילישניות, כפי שרואים בדוגמאות של Meta

איך בונים קישור ig.me עם ref?

לפי מדריך Instagram Login של Meta, בונים את הקישור כך: https://ig.me/<USERNAME>?ref=<VALUE>, כאשר USERNAME הוא שם המשתמש של החשבון העסקי. במדריך Instagram Messaging מופיע נתיב m/ לפני שם המשתמש. הפרמטר ref יכול להגיע ל-2,083 תווים של אותיות, ספרות, מקפים, קווים תחתיים וסימני שוויון. Meta ממליצה להשתמש בפרמטר ref כדי לעקוב אחרי ערוצים, לקשור אדם לסשן באפליקציה אחרת או להפנות אותו לתוכן מסוים, ומציעה ice breakers לשיחות חדשות, כל אחד עם ref משלו.

לאן מגיעות הפניות ממודעות?

להודעות. אדם שלוחץ על מודעה שפותחת את Instagram Direct ושולח הודעה יוצר אירוע messages שבו message.referral מכיל את הערך של הפרמטר ref של המודעה אם הוגדר, ad_id, source ADS, type OPEN_THREAD ו-ads_context_data עם כותרת המודעה ועם photo_url או video_url שנלחץ. תיעוד ה-Instagram של Meta מתעד את messaging_referral לקישורי ig.me בלבד.

A Click-to-Direct ad referral, inside messages
"message": {
  "mid": "<MESSAGE_ID>",
  "referral": {
    "ref": "<AD_REF_IF_SET>",
    "ad_id": "<AD_ID>",
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": "<AD_TITLE>",
      "photo_url": "<IMAGE_URL_CLICKED>",
      "video_url": "<THUMBNAIL_URL_FOR_THE_AD_VIDEO>"
    }
  }
}

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

כן, בשיחה קיימת: Meta כותבת במדריך ig.me שההפניה מאפסת את חלון ההודעות הסטנדרטי של 24 שעות, כך שהאפליקציה יכולה להשיב תוך 24 שעות מהאירוע. הודעה ראשונה שנשלחת אחרי לחיצה על מודעת Click-to-Direct יכולה לפתוח חלון של עד 7 ימים מההודעה הזאת. משיבים בקריאת POST /<IG_ID>/messages כשהשדה recipient.id מוגדר לערך של sender.id באירוע.

האם easyCoexistence מעביר הפניות?

את אלה שנישאים בהודעות. easyCoexistence רושם כל חשבון Instagram מחובר לתגובות, להודעות ולאזכורים, ולכן ref בהודעה הראשונה של שיחה חדשה והפניה ממודעת Click-to-Direct מגיעים לנקודת הקצה שלכם ב-HTTPS בתוך ה-DM שהועבר, באובייקט message.referral שבתוכו. messaging_referral, לשיחות קיימות, וגם messaging_postbacks, ללחיצות על ice breakers, הם שדות נפרדים ש-Meta מעבירה לאפליקציה שנרשמה אליהם.

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

  • לחכות לאירוע messaging_referral בשיחה חדשה. הפרמטר ref מגיע באירוע messages או messaging_postbacks, לפי אם האדם הקליד או לחץ על ice breaker בפתיחת השיחה.
  • הכנסת תווים אחרים לפרמטר ref. Meta מקבלת אותיות, ספרות, מקפים, קווים תחתיים וסימני שוויון, עד 2,083 תווים.
  • התאמת source למחרוזת מדויקת אחת. הדוגמאות של Meta מציגות SHORTLINKS לקישורי ig.me ו-ADS למודעות, אבל אחת הטבלאות שלה כותבת SHORTLINK, ולכן כדאי לבדוק לפי מיקום ההפניה ולפי ערך הפרמטר שנשלח.
  • בדיקת קישורים ב-Instagram Web. Meta לא תומכת בקישורי ig.me שם, ולכן פותחים אותם באפליקציה שבטלפון.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

מה מכיל השדה referral.source בהפניה?

SHORTLINKS בדוגמאות ig.me של Meta ו-ADS להפניה ממודעת Click-to-Direct, אם כי טבלה אחת במדריך Instagram Messaging של Meta כותבת SHORTLINK. בדקו לפי מיקום ההפניה ולפי הפרמטר ref ולא לפי מחרוזת מדויקת אחת.

כמה ארוך יכול פרמטר ref של ig.me להיות?

עד 2,083 תווים, ובאותיות, ספרות, מקפים, קווים תחתיים וסימני שוויון בלבד.

איפה מגיע הפרמטר ref של קישור ig.me בשיחה חדשה?

באירוע messages כשהאדם מקליד הודעה ראשונה, או באירוע messaging_postbacks כשהוא לוחץ על ice breaker. messaging_referral מכסה שיחות קיימות בלבד.

האם אפשר לפתוח קישורי ig.me בגרסת הדפדפן?

לא. לפי מדריך ig.me של Meta הם אינם נתמכים שם.

המשיכו לקרוא

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

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

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

נבדק ב-