Instagram messaging_postbacks वेबहुक: आइस ब्रेकर और बटन
Instagram का messaging_postbacks वेबहुक फ़ील्ड किसी ऐप को सूचित करता है, जब कोई व्यक्ति प्रोफ़ेशनल खाते की बातचीत में आइस ब्रेकर प्रश्न, टेम्पलेट के पोस्टबैक बटन या स्थायी मेनू आइटम पर टैप करता है। इवेंट के पोस्टबैक ऑब्जेक्ट में title होता है, यानी वह टेक्स्ट जिस पर व्यक्ति ने टैप किया; पेलोड, वह स्ट्रिंग जो ऐप ने उस विकल्प के लिए सेट की थी; और mid, मैसेज आईडी, Graph API v11.0 से।
easyCoexistence हर कनेक्टेड Instagram खाते को टिप्पणियों, मैसेज और उल्लेख के लिए सब्सक्राइब करता है, और उन इवेंट्स को, क्विक रिप्लाई के टैप सहित, आते ही आपके HTTPS एंडपॉइंट पर भेजता है, उस खाते के सीक्रेट से हस्ताक्षरित और बिना कोई कॉपी रखे।
Meta के Ice Breaker API से एक खाते के लिए सेट किए जा सकने वाले सबसे ज़्यादा आइस ब्रेकर प्रश्न।
Graph API का वह संस्करण जिससे पोस्टबैक इवेंट में mid शामिल होता है; फ़ील्ड खुद v8.0 या उसके बाद का संस्करण माँगता है।
बटन टेम्पलेट मैसेज में सबसे ज़्यादा बटन, जिनमें से हर एक postback या web_url बटन होता है।
स्थायी मेनू आइटम टैप के बाद जवाब देने का समय, जो स्टैंडर्ड मैसेजिंग विंडो खोलता है।
एक मैसेज जितने सबसे ज़्यादा क्विक रिप्लाई दे सकता है; टैप किया गया क्विक रिप्लाई messages पर आता है, messaging_postbacks पर नहीं।
messaging_postbacks कब फ़ायर होता है?
जब कोई व्यक्ति बातचीत में खाते के किसी स्ट्रक्चर्ड विकल्प पर टैप करता है, और ऐप व खाता इस फ़ील्ड के लिए सब्सक्राइब हों। Meta की गाइड ये स्रोत बताती हैं:
- आइस ब्रेकर प्रश्न, जो बातचीत शुरू होने पर खाता देता है (अधिकतम 4 में से एक)। डेस्कटॉप पर उपलब्ध नहीं।
- बटन टेम्पलेट में पोस्टबैक बटन, प्रति मैसेज अधिकतम 3, या जेनेरिक टेम्पलेट में, प्रति एलिमेंट अधिकतम 3।
- खाते के स्थायी मेनू में एक पोस्टबैक आइटम।
- ig.me लिंक से ref पैरामीटर के साथ खोले गए नए थ्रेड में टैप किया गया आइस ब्रेकर: तब पोस्टबैक में referral भी आता है।
- सेल्फ़-मैसेजिंग टेस्ट, जहाँ खाता अपना ही बटन टैप करता है: इवेंट में
is_self, true सेट होकर जुड़ जाता है।
पोस्टबैक नोटिफ़िकेशन कैसा दिखता है?
एक messaging इवेंट, जिसमें वह पोस्टबैक ऑब्जेक्ट होता है जहाँ DM में मैसेज होता। Instagram Login के लिए Meta के उदाहरण में mid, title और पेलोड शामिल हैं, और उसकी आइस ब्रेकर गाइड में वही ऑब्जेक्ट बिना mid के है। नोटिफ़िकेशन ऐसा दिखता है:
{
"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 द्वारा पोस्टबैक के लिए दस्तावेज़ किए गए फ़ील्ड, बाहरी स्तर से भीतर की ओर:
- sender.id: वह Instagram-scoped ID जिसने टैप किया, यानी जिसे जवाब देना है। recipient.id और entry[].id: प्रोफ़ेशनल खाता।
- timestamp: जब व्यक्ति ने टैप किया, Meta की आइस ब्रेकर गाइड के अनुसार।
- postback.title: आइस ब्रेकर प्रश्न या बटन का टाइटल जो व्यक्ति ने देखा।
- postback.payload: वह स्ट्रिंग जो उस विकल्प के बनाए जाने पर सेट हुई, जिसे ऐप ने चुना।
- postback.mid: उस मैसेज की ID जो टैप ने खाते को भेजा, Graph API v11.0 से।
- postback.referral: ref, source और type, जब थ्रेड ref पैरामीटर वाले ig.me लिंक से खुला हो।
is_self: पोस्टबैक के बगल में, true सेट, जब खाता सेल्फ़-मैसेजिंग टेस्ट में अपना बटन टैप करता है।
आइस ब्रेकर कैसे सेट होते हैं?
graph.instagram.com पर POST /<IG_ID>/messenger_profile से, जिसमें platform को instagram सेट किया गया हो और एक ice_breakers ऐरे, जिसके call_to_actions में प्रश्न और पेलोड की अधिकतम 4 जोड़ियाँ होती हैं, हर अनुवादित सेट के लिए locale के साथ। GET /me/messenger_profile?fields=ice_breakers उन्हें सूची में दिखाता है, और fields को ice_breakers सेट करके DELETE उन्हें हटा देता है। यहाँ चुना गया पेलोड वही है जो प्रश्न टैप होने पर messaging_postbacks लौटाता है।
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>" }
]
}
]
}पोस्टबैक बटन कैसे भेजे जाते हैं?
खाते द्वारा POST /<IG_ID>/messages से भेजे गए मैसेज के भीतर। बटन टेम्पलेट में अधिकतम 640 अक्षरों का text और 1 से 3 बटन होते हैं; जेनेरिक टेम्पलेट में अधिकतम 10 एलिमेंट होते हैं, हर एक में अधिकतम 3 बटन। postback टाइप का बटन टैप होने पर उसका पेलोड messaging_postbacks पर लौटता है, जबकि web_url बटन उसकी जगह ऐप के भीतर के ब्राउज़र में पेज खोलता है। स्थायी मेनू, जो messenger_profile पर सेट होता है, वही दो टाइप लेता है।
क्या क्विक रिप्लाई messaging_postbacks का उपयोग करते हैं?
नहीं: वे messages पर आते हैं। टैप किया गया क्विक रिप्लाई अपना टाइटल एक मैसेज के रूप में बातचीत में डालता है, और messages इवेंट में text उस टाइटल पर सेट होता है और quick_reply.payload उस विकल्प के पेलोड पर। एक मैसेज अधिकतम 13 क्विक रिप्लाई दे सकता है, हर एक अधिकतम 20 अक्षरों का, सिर्फ़ सादा टेक्स्ट। Meta की Instagram Messaging गाइड आइस ब्रेकर और जेनेरिक टेम्पलेट के चयन को भी उन चीज़ों में गिनती है जो messages रिपोर्ट करता है, लेकिन उसका कोई सैंपल पेलोड नहीं दिया गया।
क्या टैप से मैसेजिंग विंडो खुलती है?
स्थायी मेनू के लिए Meta यही कहता है: मेनू आइटम पर टैप स्टैंडर्ड मैसेजिंग विंडो खोलता है, और खाते के पास जवाब देने के लिए 24 घंटे होते हैं। POST /<IG_ID>/messages से जवाब दें, जिसमें recipient.id को पोस्टबैक के sender.id पर सेट किया गया हो। खाते का जवाब messages पर ईको के रूप में लौटता है, जिसमें is_echo true सेट होता है।
क्या easyCoexistence पोस्टबैक आगे भेजता है?
केवल क्विक रिप्लाई टैप। वे messages पर आते हैं, जिनकी सदस्यता easyCoexistence का ऐप और हर जुड़ा हुआ खाता लेता है, इसलिए वे अपने quick_reply.payload के साथ आपके एंडपॉइंट तक पहुँचते हैं। आइस ब्रेकर, बटन और मेनू टैप messaging_postbacks पर आते हैं, जिसकी सदस्यता easyCoexistence नहीं लेता, इसलिए वे फ़ॉरवर्ड नहीं होते।
आम गड़बड़ियाँ
- messaging_postbacks पर क्विक रिप्लाई का इंतज़ार करना। क्विक रिप्लाई messages पर आता है, और उसके साथ टैप किए गए विकल्प के टेक्स्ट के बगल में quick_reply.payload होता है।
- postback.title पर रूटिंग करना। title वह है जो व्यक्ति ने देखा, और यह लोकेल के हिसाब से अलग हो सकता है; रूटिंग पेलोड पर करें, जिसे ऐप सेट करता है।
- पुराने Graph API संस्करण पर mid की उम्मीद करना। Meta postback.mid सिर्फ़ Graph API v11.0 से शामिल करता है।
- 4 से ज़्यादा आइस ब्रेकर सेट करना, या उन्हें डेस्कटॉप पर टेस्ट करना। Meta की Ice Breaker API अधिकतम 4 प्रश्न लेती है, और यह फ़ीचर डेस्कटॉप पर उपलब्ध नहीं है।
send_social_dm व्यक्ति को 24 घंटे की विंडो के भीतर जवाब देता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन जोड़ने के साथ घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
कौन-सा वेबहुक फ़ील्ड Instagram आइस ब्रेकर टैप रिपोर्ट करता है?
messaging_postbacks। पोस्टबैक ऑब्जेक्ट में प्रश्न title के रूप में होता है और उसके लिए सेट किया गया पेलोड, साथ में Graph API v11.0 से mid।
एक Instagram खाते के कितने आइस ब्रेकर हो सकते हैं?
अधिकतम 4 प्रश्न, POST /<IG_ID>/messenger_profile से सेट होते हैं, जिसमें platform को instagram सेट किया गया हो, वैकल्पिक रूप से हर लोकेल के लिए अलग।
Instagram पोस्टबैक का जवाब कैसे दूँ?
POST /<IG_ID>/messages से, जिसमें recipient.id को पोस्टबैक के sender.id पर सेट किया गया हो, यानी टैप करने वाले व्यक्ति की Instagram-scoped ID। स्थायी मेनू टैप के बाद Meta खाते को जवाब देने के लिए 24 घंटे देता है।
Instagram पोस्टबैक को title पर रूट करूँ या पेलोड पर?
पेलोड पर, वह स्ट्रिंग जो ऐप ने विकल्प के लिए सेट की थी। title वह टेक्स्ट है जो व्यक्ति ने देखा, जो लोकेल के हिसाब से अलग हो सकता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित