Instagram कमेंट्स वेबहुक: पेलोड, फ़ील्ड दर फ़ील्ड
Instagram का comments वेबहुक फ़ील्ड तब ऐप को सूचित करता है जब कोई प्रोफ़ेशनल खाते के मीडिया पर कमेंट करे, या किसी कमेंट का जवाब दे, रील्स सहित। Meta एक change भेजता है जिसके field में comments लिखा होता है, और जिसके value में कमेंट का id और text होता है, from में लेखक का Instagram-scoped ID और username, मीडिया का id और product type, और जब कमेंट जवाब हो तो parent_id।
easyCoexistence हर जुड़े Instagram खाते को comments की सदस्यता देता है और Meta द्वारा उसके लिए भेजे गए comments इवेंट जैसे ही आते हैं, आपके HTTPS एंडपॉइंट पर आगे भेजता है, उस खाते के अपने सीक्रेट से साइन किए हुए, और कोई कॉपी नहीं रखी जाती।
जब कमेंट जवाब हो, तब यह मौजूद रहता है और उस कमेंट का ID रखता है जिसका यह जवाब है।
जब खाता अपने ही मीडिया पर कमेंट करता है, तब from में खाते के अपने ID के साथ यह जुड़ता है।
Live प्रसारण के कमेंट के लिए अलग फ़ील्ड है। प्रसारण खत्म होने पर इसकी सूचनाएँ रुक जाती हैं।
comments और live_comments सूचनाओं के लिए ज़रूरी है। निजी खाते के मीडिया पर कोई सूचना नहीं भेजी जाती।
कमेंट के ID से पहचाने गए लेखक को एक निजी जवाब भेजने का बचा हुआ समय।
comments फ़ील्ड कब चलता है?
जब कोई व्यक्ति प्रोफ़ेशनल खाते के मीडिया पर कमेंट करे, या खाते का ज़िक्र (mention) करे, और ऐप व खाता दोनों इस फ़ील्ड की सदस्यता ले चुके हों। हर कमेंट सूचना में एक change होता है, और ये मामले उसी ढाँचे में आते हैं:
- पोस्ट, रील, स्टोरी या विज्ञापन पर नया कमेंट, जिसमें media.
media_product_typeबताता है कि मीडिया किस जगह पर है। - किसी मौजूदा कमेंट के नीचे जवाब, जिसमें
parent_idहोता है और उस कमेंट का ID होता है जिसका वह जवाब है। - खाता अपने ही मीडिया पर जो कमेंट करता है, उसके जवाब भी शामिल हैं: from.id खाते का अपना ID होता है, और from में
self_ig_scoped_idजुड़ता है। - खाते का mention: Instagram Login के साथ Meta, mentions को अपने अलग फ़ील्ड की बजाय comments सूचना में शामिल करता है।
- Live प्रसारण के दौरान आया कमेंट एक अलग फ़ील्ड,
live_commentsपर आता है, उसी मान के ढाँचे में, और प्रसारण खत्म होते ही रुक जाता है।
comments सूचना कैसी दिखती है?
एक POST, जिसके JSON में object का मान instagram होता है और एक entry ऐरे होता है। हर entry एक प्रोफ़ेशनल खाता है: उसका ID, वह समय जब Meta ने सूचना भेजी, और एक changes ऐरे जिसमें हर कमेंट के लिए एक change होता है। Reel पर जवाब कुछ ऐसा दिखता है:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}हर फ़ील्ड का क्या मतलब है?
Meta के वेबहुक संदर्भ में कमेंट के लिए सूचीबद्ध फ़ील्ड, बाहर से अंदर की ओर:
- entry[].id: प्रोफ़ेशनल खाते का ID, यानी वह
user_idजो /me उसके लिए लौटाता है। इससे पता चलता है कि कमेंट किस खाते का है। - entry[].time: वह समय जब Meta ने सूचना भेजी, Unix timestamp के रूप में। यह वह समय नहीं है जब कमेंट लिखा गया।
- changes[].field: comments, या Live प्रसारण के लिए
live_comments। value पढ़ने से पहले इसे जाँचें। - value.id: कमेंट का ID, जिससे सार्वजनिक या निजी रूप में जवाब दिया जा सकता है, छिपाया या हटाया जा सकता है।
- value.text: कमेंट का टेक्स्ट, जब कमेंट में टेक्स्ट हो तब शामिल।
- value.from.id और value.from.username: लेखक का Instagram-scoped ID और username। value.from.
self_ig_scoped_idतब आता है जब कमेंट खाते ने खुद लिखा हो। - value.media.id और value.media.
media_product_type: जिस मीडिया पर कमेंट है उसका ID और उसकी जगह; Meta का media संदर्भ AD, FEED, STORY और REELS नाम देता है। - value.
parent_id: जवाब पर, उस कमेंट का ID जिसका वह जवाब है। ऊपरी स्तर के कमेंट में यह नहीं होता। - value.media.
ad_id,ad_titleऔरoriginal_media_id: संदर्भ में विज्ञापन पर किए गए कमेंट के लिए सूचीबद्ध हैं।
comments फ़ील्ड क्या नहीं बताता?
कुछ चीज़ें जिनकी हैंडलर को उम्मीद हो सकती है, इवेंट से बाहर छोड़ दी जाती हैं या कभी भेजी ही नहीं जातीं, Meta के सेटअप गाइड और संदर्भों के अनुसार:
- निजी खाते के मीडिया पर कमेंट: Meta उनके लिए कोई कमेंट या mention सूचना नहीं भेजता।
- Album ID: इवेंट में ये शामिल नहीं होते, और Meta कहता है कि album को कमेंट ID से खोजें।
- Dynamic ads में इस्तेमाल मीडिया के लिए Ad ID।
- कमेंट का बनने का समय: GET /<
COMMENT_ID>?fields=timestamp इसे ISO 8601 में लौटाता है। - प्रसारण खत्म होने के बाद के Live कमेंट, जब Live मीडिया की सूचनाएँ रुक जाती हैं।
- Story mentions, जिन्हें Meta का mentions एपीआई सपोर्ट नहीं करता; ये इसके बजाय DM के रूप में खाते तक पहुँचते हैं।
- पिछली घटनाएँ: Meta के पास क्वेरी करने के लिए सूचना का इतिहास नहीं रहता, इसलिए हर सूचना आते ही वह जो चाहिए, सहेजें।
comments फ़ील्ड को क्या चाहिए?
Instagram Login के साथ अनुमतियाँ instagram_business_basic और instagram_business_manage_comments, और Advanced Access, जो Meta comments और live_comments सूचनाओं के लिए ज़रूरी बताता है। ऐप को ऐप डैशबोर्ड में Live होना चाहिए और comments की सदस्यता लेनी चाहिए, और हर खाते की सदस्यता POST /<IG_ID>/subscribed_apps से होनी चाहिए, जिसके subscribed_fields में comments हो। Meta कमेंट के लिए पोलिंग की बजाय इस वेबहुक की ज़ोरदार सिफ़ारिश करता है, क्योंकि इससे रेट लिमिट बचती है।
इवेंट से कमेंट का जवाब कैसे दें?
इवेंट में दिए गए ID से। POST /<COMMENT_ID>/replies के साथ मैसेज भेजने पर value.id का उपयोग करके कमेंट के नीचे सार्वजनिक जवाब जाता है। मैसेज के साथ POST /<IG_ID>/messages में recipient.comment_id को value.id पर सेट करने से लेखक को एक निजी जवाब जाता है, कमेंट के 7 दिनों के भीतर, या Live पर प्रसारण चलने के दौरान। from.id एक Instagram-scoped ID है, लेकिन उस व्यक्ति के खाते को पहले मैसेज किए बिना सीधे उस पर भेजा गया DM विफल होता है, इसलिए DM के ज़रिए पहुँचने का तरीका यही निजी जवाब है।
easyCoexistence कमेंट को कैसे आगे भेजता है?
जैसे ही वह आता है, एक बार खाते के लिए एंडपॉइंट सेट होने पर, Claude या ChatGPT से set_social_webhook_destination के ज़रिए, या Partner एपीआई पर PUT /channels/:id/webhook से। easyCoexistence हर जुड़े खाते को उन फ़ील्ड्स की सदस्यता देता है जिनमें उसके comments, mentions और DM आते हैं, हर डिलीवरी पर Meta का सिग्नेचर जाँचता है, Meta को तुरंत जवाब देता है, और उस खाते की हर entry को एक लिफ़ाफ़े में आपके HTTPS यूआरएल पर POST करता है:
- platform और
external_id: instagram, और खाते का Instagram ID, जो entry.id के बराबर है। account_id: easyCoexistence में कनेक्शन का ID, वही जोlist_social_accountsलौटाता है और MCP tools लेते हैं।- entry: खाते के लिए Meta की entry, बिना बदलाव के, ताकि एक बैच में आई डिलीवरी हर entry के लिए एक POST बन जाए। Meta का object फ़ील्ड और X-Hub-Signature-256 आगे नहीं भेजे जाते।
- डिलीवरी: एक प्रयास, 8 सेकंड तक इंतज़ार, कोई redirect फ़ॉलो नहीं, और ऐसे HTTPS पते पर जो एक सार्वजनिक IP पर हल होता हो। कोई कॉपी नहीं रखी जाती और दोबारा कोशिश नहीं होती।
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}comment-to-DM नियम उसी इवेंट के साथ क्या करते हैं?
वे उसे forward के साथ-साथ पढ़ते हैं। कोई नियम तब मिलता है जब कमेंट में उसका कोई कीवर्ड हो (बड़े-छोटे अक्षर का फ़र्क किए बिना), चाहे किसी एक चुनी हुई पोस्ट पर या सब पर, और लेखक को नियम का DM उनके निजी जवाब के रूप में भेजता है, और अगर नियम में सार्वजनिक जवाब भी है तो वह भी। खाते के अपने कमेंट छोड़ दिए जाते हैं, कमेंट से शुरू होने वाले ऑटोमेशन उन कमेंट को लेते हैं जिनका किसी नियम ने जवाब नहीं दिया, और जिस कमेंट का किसी नियम ने जवाब दिया वह भी आपके एंडपॉइंट तक पहुँचता है। नियम का सार्वजनिक जवाब खाते से ही एक नई comments इवेंट के रूप में वापस आ सकता है।
आम गड़बड़ियाँ
- comment_id खोजना। Instagram Login के तहत कमेंट का ID value.id में होता है; comment_id Meta के दूसरे लॉगिन सेटअप के पेलोड में आता है।
- खाते के अपने कमेंट का जवाब देना। उसके जवाब comments इवेंट के रूप में लौटते हैं जिनमें from.id, entry.id के बराबर होता है, और जो ऑटोमेशन उनका जवाब देता है वह खुद से ही बात करने लगता है।
- entry.time को कमेंट का समय मानना। यह वह समय दर्ज करता है जब Meta ने सूचना भेजी; कमेंट का अपना timestamp फ़ील्ड बताता है कि वह कब लिखा गया।
- comments फ़ील्ड पर Live कमेंट का इंतज़ार। वे live_comments पर आते हैं, जिसके लिए अपनी अलग सदस्यता चाहिए, और प्रसारण खत्म होते ही शांत हो जाते हैं।
कमेंट-से-DM नियम और ऑटोमेशन उन्हीं कमेंट का चौबीसों घंटे जवाब देते हैं। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75, कनेक्शन बढ़ाने पर घटती दर, पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
क्या Instagram कमेंट्स वेबहुक जवाबों को भी शामिल करता है?
हाँ। जवाब अपने अलग comments इवेंट के रूप में आता है, जिसमें parent_id पर उस कमेंट का ID होता है जिसका वह जवाब है।
क्या रील्स के कमेंट Instagram कमेंट्स वेबहुक को चालू करते हैं?
हाँ। रील पर किया गया कमेंट पोस्ट वाले कमेंट की तरह comments फ़ील्ड पर आता है, और media.media_product_type दोनों में फ़र्क बताता है।
मेरा Instagram कमेंट्स वेबहुक क्यों नहीं चल रहा?
ज़्यादातर इसलिए कि ऐप Live नहीं है या उसके पास Advanced Access नहीं है, खाते की सदस्यता /subscribed_apps से नहीं हुई, मीडिया किसी निजी खाते का है, या कमेंट Live पर था, जो live_comments इस्तेमाल करता है।
क्या comments वेबहुक में कमेंट करने वाले का username शामिल होता है?
हाँ। value.from में व्यक्ति का username उसके Instagram-scoped ID के साथ होता है, इसलिए यह दिखाने के लिए कि किसने कमेंट किया, कोई अतिरिक्त कॉल नहीं चाहिए।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित