Instagram वेबहुक इवेंट: कमेंट, मेंशन और DM
Instagram वेबहुक इवेंट प्रोफ़ेशनल खाते पर होने वाली गतिविधि को उसी समय बताते हैं: नए कमेंट, @मेंशन और DM। Meta हर इवेंट को JSON के रूप में, जुड़े हुए ऐप के HTTPS एंडपॉइंट पर POST करता है, और विफल डिलीवरी को उसी एंडपॉइंट पर 36 घंटे तक दोबारा भेजता है। easyCoexistence हर इवेंट को आपके एंडपॉइंट पर एक बार भेजता है, हर खाते के लिए साइन किया हुआ, और दोबारा कोशिश नहीं करता। Instagram Login के साथ मेंशन कमेंट की सूचना के भीतर आते हैं।
वह समय जितनी देर तक Meta ऐप के एंडपॉइंट पर विफल डिलीवरी को दोबारा भेजता रहता है, उसके बाद उसे छोड़ देता है।
Meta अधिकतर अपडेट को एक वेबहुक डिलीवरी में बैच कर देता है, हालाँकि बैचिंग की गारंटी नहीं देता।
वह फ़्लैग जो Meta उन मैसेज इवेंट पर लगाता है जिन्हें खाते ने स्वयं भेजा हो।
केवल सार्वजनिक खातों के मीडिया पर कमेंट और मेंशन की सूचनाएँ ट्रिगर होती हैं।
कौन से इवेंट होते हैं?
Instagram Login से जुड़े प्रोफ़ेशनल खाते के लिए तीन तरह की गतिविधियाँ इवेंट के रूप में आती हैं:
- कमेंट: खाते के मीडिया पर नया कमेंट, जिसमें कमेंट ID, लेखक की Instagram-scoped ID और यूज़रनेम, टेक्स्ट, तथा मीडिया ID और टाइप शामिल होते हैं।
- मेंशन: Instagram Login के साथ ये कमेंट की सूचना के भीतर आते हैं, अपने अलग फ़ील्ड में नहीं।
- मैसेज: खाते को भेजा गया DM, जिसमें भेजने वाला, रिसीवर, टाइमस्टैम्प और मैसेज खुद होता है, जिसमें टेक्स्ट, अटैचमेंट और स्टोरी के जवाब शामिल हैं।
इवेंट आपके एंडपॉइंट तक कैसे पहुँचते हैं?
Meta Instagram वेबहुक उस ऐप को भेजता है जिससे खाता जुड़ा है। easyCoexistence उन्हें प्राप्त करता है और हर एक को, आते ही, उस खाते के लिए आपके सेट किए HTTPS एंडपॉइंट पर आगे भेजता है, उस खाते के सीक्रेट से साइन किया हुआ।
एंडपॉइंट set_social_webhook_destination से Claude या ChatGPT में सेट करें, या PUT /channels/:id/webhook पर Partner API से। साइनिंग सीक्रेट एक बार दिखाया जाता है, एंडपॉइंट दोबारा सेट करने पर नया जारी होता है, और URL की जगह null देने पर फ़ॉरवर्डिंग बंद हो जाती है।
डिलीवरी कैसी दिखती है?
JSON बॉडी के साथ एक POST, जिसमें platform, account_id (जो list_social_accounts कनेक्शन को देता है), Instagram खाते का external_id, और entry होता है: इवेंट के लिए Meta का वेबहुक entry, बिना बदलाव के। DM इसी तरह आता है, changes की जगह messaging ऐरे के साथ। नया कमेंट ऐसा दिखता है:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}डिलीवरी की पुष्टि कैसे करें?
हर डिलीवरी में X-EC-Signature हेडर होता है, जिसका फ़ॉर्मैट t=<unix>,v1=<hex> है। v1, टाइमस्टैम्प, एक डॉट और रॉ अनुरोध बॉडी का HMAC-SHA256 है, जो खाते के साइनिंग सीक्रेट से बनता है। इसकी गणना बॉडी पर उसी रूप में करें जैसे वह प्राप्त हुई थी, कॉन्स्टेंट टाइम में तुलना करें, और 5 मिनट से पुराना टाइमस्टैम्प अस्वीकार करें।
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}क्या डिलीवरी दोबारा भेजी जाती है?
easyCoexistence द्वारा नहीं: फ़ॉरवर्डिंग हर इवेंट को एक बार, मेमोरी में, आगे भेजती है और दोबारा भेजने के लिए कोई कॉपी नहीं रखती। जल्दी से 2xx से जवाब दें और काम बाद में करें, और जो भी चाहिए वह आते ही स्टोर करें, क्योंकि Meta भी पिछली सूचनाओं का ऐसा इतिहास नहीं रखता जिसे क्वेरी किया जा सके।
विफल डिलीवरी Meta स्वयं ऐप को 36 घंटे तक दोबारा भेजता है, इसलिए वही इवेंट कभी-कभी दो बार आ सकता है: कमेंट ID या मैसेज के mid पर डुप्लिकेट हटाने की जाँच करें।
हैंडलर को और क्या जाँचना चाहिए?
Meta के पेलोड में कुछ विवरण हैं जो पहली बार हैंडलर लिखने वालों को उलझा देते हैं:
is_echo: जिस मैसेज इवेंट मेंis_echotrue पर सेट है, वह खाते ने स्वयं भेजा था, इसलिए उसका जवाब देने की ज़रूरत नहीं।- स्टोरी के जवाब: स्टोरी का जवाब देने वाले DM में
reply_toहोता है, जिसमें स्टोरी का ID और URL होता है। - स्टोरी मेंशन: ये ऐसे मैसेज के रूप में आते हैं जिसका अटैचमेंट टाइप
story_mentionहोता है। - time: वह समय जब Meta ने सूचना भेजी, न कि जब कमेंट या मैसेज बना; मैसेज का अपना टाइमस्टैम्प उसकी messaging entry में होता है।
- एल्बम ID: कमेंट इवेंट इन्हें शामिल नहीं करते; एल्बम को कमेंट ID से खोजें।
आम गड़बड़ियाँ
- जवाब देने से पहले काम करना। फ़ॉरवर्डिंग दोबारा नहीं भेजती, इसलिए तुरंत 2xx लौटाएँ और इवेंट को बाद में प्रोसेस करें।
- पार्स किए गए JSON पर सिग्नेचर सत्यापित करना। HMAC की गणना रॉ बॉडी पर करें, जैसी वह प्राप्त हुई थी।
- इको पर जवाब देना। जिस मैसेज इवेंट में is_echo सेट है, वह खाते ने भेजा था, और उसका जवाब एक लूप शुरू कर देता है।
- डुप्लिकेट हटाने को छोड़ना। विफलता के बाद Meta वही इवेंट फिर भेज सकता है, इसलिए कमेंट ID या मैसेज mid पर कुंजी बनाएँ।
easyCoexistence Instagram खाते के कमेंट, मेंशन और DM आते ही आपके HTTPS एंडपॉइंट पर भेजता है, उस खाते के सीक्रेट से साइन किया हुआ, और रास्ते में कोई कॉपी नहीं रखता। इसे Claude या ChatGPT से set_social_webhook_destination के ज़रिए, या Partner API से चालू करें। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ाने के साथ कम होता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
Instagram वेबहुक में time फ़ील्ड का क्या अर्थ है?
Meta ने सूचना कब भेजी, न कि कमेंट या मैसेज कब बना। DM का अपना टाइमस्टैम्प उसकी messaging entry में होता है।
क्या Meta विफल Instagram वेबहुक डिलीवरी दोबारा भेजता है?
हाँ। Meta विफल डिलीवरी को ऐप को 36 घंटे तक दोबारा भेजता है, इसलिए वही इवेंट कभी-कभी दो बार आ सकता है: कमेंट ID या मैसेज के mid पर डुप्लिकेट हटाने की जाँच करें। easyCoexistence हर इवेंट को आपके एंडपॉइंट तक एक बार आगे भेजता है, इसलिए जल्दी से 2xx से जवाब दें।
एक Instagram वेबहुक डिलीवरी में कितने अपडेट हो सकते हैं?
Meta के बैच करने पर 1,000 तक, हालाँकि Meta बैचिंग की गारंटी नहीं देता। केवल पहले आइटम को पढ़ने के बजाय पूरे entry ऐरे पर लूप चलाएँ।
क्या मेंशन का अपना इवेंट होता है?
Instagram Login के साथ नहीं। Meta मेंशन को कमेंट की सूचना में शामिल करता है, इसलिए वे कमेंट के उसी रास्ते से आते हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित