Instagram messaging_referral वेबहुक: ig.me लिंक और विज्ञापन रेफ़रल
Instagram का messaging_referral वेबहुक फ़ील्ड किसी ऐप को तब सूचित करता है जब कोई व्यक्ति, जिसकी प्रोफ़ेशनल खाते के साथ पहले से बातचीत है, ref पैरामीटर वाला ig.me लिंक खोलता है। इस इवेंट में सबसे ऊपर एक रेफ़रल ऑब्जेक्ट होता है: ref, यानी पैरामीटर की वैल्यू; source, SHORTLINKS; और type, OPEN_THREAD। नई बातचीत पर आने वाला ref इसकी जगह messages या messaging_postbacks इवेंट के भीतर आता है।
easyCoexistence हर जुड़े Instagram खाते को comments, messages और mentions पर सब्सक्राइब करता है, इसलिए नई थ्रेड के पहले मैसेज का ref और Click-to-Direct विज्ञापन का रेफ़रल फ़ॉरवर्ड किए गए DM के भीतर आपके HTTPS एंडपॉइंट तक पहुँचते हैं, जो उस खाते के सीक्रेट से साइन किए होते हैं।
ig.me ref पैरामीटर में अधिकतम कितने अक्षर हो सकते हैं, जिसमें केवल अक्षर, अंक, हाइफ़न, अंडरस्कोर और बराबर चिह्न हों।
ig.me लिंक के लिए रेफ़रल टाइप; Click-to-Direct विज्ञापन का रेफ़रल भी इसी का उपयोग करता है, जिसका source ADS होता है।
मौजूदा बातचीत में रेफ़रल के बाद ऐप के पास जवाब देने का समय, जो स्टैंडर्ड विंडो को फिर से शुरू कर देता है।
Click-to-Direct विज्ञापन पर क्लिक के बाद भेजे गए पहले मैसेज से विंडो कितनी देर तक चल सकती है।
Meta की ig.me गाइड के अनुसार वे स्थितियाँ जहाँ ig.me लिंक समर्थित नहीं हैं।
messaging_referral कब भेजा जाता है?
जब कोई व्यक्ति, जिसकी प्रोफ़ेशनल खाते के साथ पहले से बातचीत है, ref पैरामीटर वाला ig.me लिंक खोलता है। Instagram मौजूदा थ्रेड खोल देता है और Meta बिना किसी मैसेज के अपने आप रेफ़रल भेज देता है। रेफ़रल कहाँ आएगा, यह थ्रेड पर और व्यक्ति के कदम पर निर्भर करता है:
रेफ़रल नोटिफ़िकेशन कैसा दिखता है?
एक मैसेजिंग इवेंट जिसमें referral ऑब्जेक्ट sender, recipient और timestamp के साथ रहता है, और उसके आसपास कोई message या postback नहीं होता। Meta की ig.me गाइड रेफ़रल की वैल्यू देती है, उसी ढाँचे में जिसमें 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-स्कोप्ड ID। recipient.id और entry[].id: प्रोफ़ेशनल खाता।
- referral.ref: लिंक के ref पैरामीटर की वैल्यू, ठीक वैसी जैसी लिंक में थी।
- referral.source: Meta के ig.me नमूनों में SHORTLINKS। Meta की Instagram Messaging गाइड की एक तालिका इसे SHORTLINK लिखती है, और उसके उदाहरण वाले पेज पर यह एक प्लेसहोल्डर दिखता है।
- referral.type:
OPEN_THREAD, जिसे Meta ig.me रेफ़रल के लिए उपयोग करता है। - timestamp: जब इवेंट ट्रिगर हुआ, Meta के नमूनों में मिलीसेकंड में।
ref वाला ig.me लिंक कैसे बनाएँ?
इस रूप में: https://ig.me/<USERNAME>?ref=<VALUE>, जहाँ USERNAME प्रोफ़ेशनल खाते का हैंडल है। यह Meta की Instagram Login गाइड में है; उसकी Instagram Messaging गाइड इसे https://ig.me/m/<USERNAME> लिखती है। ref में अक्षर, अंक, हाइफ़न, अंडरस्कोर और बराबर चिह्न हो सकते हैं, और यह 2,083 अक्षरों तक जा सकता है। Meta चैनल ट्रैक करने, किसी व्यक्ति को दूसरे ऐप के सेशन से जोड़ने या किसी खास कंटेंट पर भेजने के लिए ref सुझाता है, और नई बातचीत के लिए हर आइस ब्रेकर का अपना ref रखने की सलाह देता है।
विज्ञापन के रेफ़रल कहाँ आते हैं?
मैसेज पर। जो व्यक्ति ऐसा विज्ञापन क्लिक करता है जो Instagram Direct खोलता है और मैसेज भेजता है, उसके लिए messages इवेंट बनता है, जिसके message.referral में विज्ञापन का ref होता है (अगर सेट किया गया हो), ad_id, source ADS, type OPEN_THREAD, और ads_context_data जिसमें विज्ञापन का शीर्षक और क्लिक किए गए photo_url या video_url होते हैं। Meta के Instagram पेज केवल ig.me लिंक के लिए messaging_referral का दस्तावेज़ीकरण करते हैं।
"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 रेफ़रल फ़ॉरवर्ड करता है?
वे जो मैसेज के साथ आते हैं। हर जुड़ा हुआ Instagram खाता comments, messages और mentions पर सब्सक्राइब होता है, इसलिए नई थ्रेड के पहले मैसेज पर ref और Click-to-Direct विज्ञापन का रेफ़रल फ़ॉरवर्ड किए गए DM के भीतर message.referral के रूप में आपके एंडपॉइंट तक पहुँचते हैं। messaging_referral (मौजूदा थ्रेड के लिए) और messaging_postbacks (आइस ब्रेकर टैप के लिए) अलग फ़ील्ड हैं, जिन्हें Meta उन्हीं ऐप्स को भेजता है जो इनके लिए सब्सक्राइब हैं।
आम गड़बड़ियाँ
- नई बातचीत पर messaging_referral का इंतज़ार करना। वहाँ ref messages या messaging_postbacks में आता है, यह इस पर निर्भर करता है कि व्यक्ति ने टाइप किया या आइस ब्रेकर टैप किया।
- ref में दूसरे अक्षर डालना। Meta केवल अक्षर, अंक, हाइफ़न, अंडरस्कोर और बराबर चिह्न स्वीकार करता है, 2,083 अक्षरों तक।
- source की तुलना किसी एक सटीक स्ट्रिंग से करना। Meta के नमूनों में ig.me के लिए SHORTLINKS और विज्ञापनों के लिए ADS दिखता है, पर उसकी एक तालिका SHORTLINK लिखती है, इसलिए ब्रांच इस पर बनाएँ कि रेफ़रल कहाँ है और ref क्या है।
- Instagram Web पर लिंक टेस्ट करना। Meta वहाँ ig.me लिंक समर्थित नहीं करता, इसलिए उन्हें Instagram ऐप में खोलें।
send_social_dm 24 घंटे की विंडो के भीतर जवाब देता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने के साथ कम होता जाता है, और पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
referral.source में Instagram रेफ़रल के भीतर क्या होता है?
Meta के ig.me नमूनों में SHORTLINKS और Click-to-Direct विज्ञापन के लिए ADS, हालाँकि Meta की Instagram Messaging गाइड की एक तालिका इसे SHORTLINK लिखती है। एक सटीक स्ट्रिंग पर नहीं, बल्कि इस पर ब्रांच बनाएँ कि रेफ़रल कहाँ है और ref क्या है।
ig.me ref पैरामीटर कितना लंबा हो सकता है?
2,083 अक्षरों तक, जिसमें केवल अक्षर, अंक, हाइफ़न, अंडरस्कोर और बराबर चिह्न हों।
नई Instagram बातचीत में ig.me ref कहाँ आता है?
messages पर, जब व्यक्ति पहला मैसेज टाइप करता है, या messaging_postbacks पर, जब वह आइस ब्रेकर टैप करता है। messaging_referral केवल मौजूदा थ्रेड के लिए है।
क्या ig.me लिंक Instagram Web पर काम करते हैं?
नहीं। Meta की ig.me गाइड कहती है कि वे Instagram Web पर समर्थित नहीं हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित