וובהוק 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 שהועבר, חתומים במפתח הסודי של אותו חשבון.
המספר המרבי של תווים שפרמטר ref של קישור ig.me יכול להכיל, באותיות, ספרות, מקפים, קווים תחתיים וסימני שוויון בלבד.
סוג ההפניה לקישורי ig.me; גם הפניה ממודעת Click-to-Direct משתמשת בו, עם source ADS.
הזמן שיש לאפליקציה כדי להשיב לאחר הפניה בשיחה קיימת, וזה מאפס את חלון ההודעות הסטנדרטי.
כמה זמן יכול החלון להימשך אחרי הודעה ראשונה שנשלחת לאחר לחיצה על מודעת Click-to-Direct.
היכן קישורי ig.me אינם נתמכים, לפי מדריך Meta
מתי messaging_referral מופעל?
כשאדם שכבר מנהל שיחה עם החשבון העסקי פותח קישור ig.me שנושא פרמטר ref. Instagram פותח את השיחה הקיימת, ו-Meta שולחת את ההפניה בעצמה, בלי הודעה. היכן ההפניה מגיעה תלוי בשיחה ובמה שהאדם עושה:
איך נראה אירוע הפניה?
אירוע הודעה שבו אובייקט referral יושב לצד sender, recipient ו-timestamp, בלי message או postback סביבו. מדריך ig.me של Meta נותן את ערכי ההפניה, בתוך אותה מעטפת כמו שאר אירועי ההודעות של Instagram:
{
"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 בלבד.
"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 שם, ולכן פותחים אותם באפליקציה שבטלפון.
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
נבדק ב-