लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

Instagram वेबहुक इवेंट: कमेंट, मेंशन और DM

Instagram वेबहुक इवेंट प्रोफ़ेशनल खाते पर होने वाली गतिविधि को उसी समय बताते हैं: नए कमेंट, @मेंशन और DM। Meta हर इवेंट को JSON के रूप में, जुड़े हुए ऐप के HTTPS एंडपॉइंट पर POST करता है, और विफल डिलीवरी को उसी एंडपॉइंट पर 36 घंटे तक दोबारा भेजता है। easyCoexistence हर इवेंट को आपके एंडपॉइंट पर एक बार भेजता है, हर खाते के लिए साइन किया हुआ, और दोबारा कोशिश नहीं करता। Instagram Login के साथ मेंशन कमेंट की सूचना के भीतर आते हैं।

36 hours

वह समय जितनी देर तक Meta ऐप के एंडपॉइंट पर विफल डिलीवरी को दोबारा भेजता रहता है, उसके बाद उसे छोड़ देता है।

1,000

Meta अधिकतर अपडेट को एक वेबहुक डिलीवरी में बैच कर देता है, हालाँकि बैचिंग की गारंटी नहीं देता।

is_echo

वह फ़्लैग जो Meta उन मैसेज इवेंट पर लगाता है जिन्हें खाते ने स्वयं भेजा हो।

Public

केवल सार्वजनिक खातों के मीडिया पर कमेंट और मेंशन की सूचनाएँ ट्रिगर होती हैं।

कौन से इवेंट होते हैं?

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 ऐरे के साथ। नया कमेंट ऐसा दिखता है:

A forwarded comment event
{
  "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 मिनट से पुराना टाइमस्टैम्प अस्वीकार करें।

Node.js: verifying X-EC-Signature
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_echo true पर सेट है, वह खाते ने स्वयं भेजा था, इसलिए उसका जवाब देने की ज़रूरत नहीं।
  • स्टोरी के जवाब: स्टोरी का जवाब देने वाले DM में reply_to होता है, जिसमें स्टोरी का ID और URL होता है।
  • स्टोरी मेंशन: ये ऐसे मैसेज के रूप में आते हैं जिसका अटैचमेंट टाइप story_mention होता है।
  • time: वह समय जब Meta ने सूचना भेजी, न कि जब कमेंट या मैसेज बना; मैसेज का अपना टाइमस्टैम्प उसकी messaging entry में होता है।
  • एल्बम ID: कमेंट इवेंट इन्हें शामिल नहीं करते; एल्बम को कमेंट ID से खोजें।

आम गड़बड़ियाँ

  • जवाब देने से पहले काम करना। फ़ॉरवर्डिंग दोबारा नहीं भेजती, इसलिए तुरंत 2xx लौटाएँ और इवेंट को बाद में प्रोसेस करें।
  • पार्स किए गए JSON पर सिग्नेचर सत्यापित करना। HMAC की गणना रॉ बॉडी पर करें, जैसी वह प्राप्त हुई थी।
  • इको पर जवाब देना। जिस मैसेज इवेंट में is_echo सेट है, वह खाते ने भेजा था, और उसका जवाब एक लूप शुरू कर देता है।
  • डुप्लिकेट हटाने को छोड़ना। विफलता के बाद Meta वही इवेंट फिर भेज सकता है, इसलिए कमेंट ID या मैसेज mid पर कुंजी बनाएँ।
EasyCoexistence के साथ ऐसा करना

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 मेंशन को कमेंट की सूचना में शामिल करता है, इसलिए वे कमेंट के उसी रास्ते से आते हैं।

पढ़ना जारी रखें

एपीआई के ज़रिए Instagram कमेंट मॉडरेशनInstagram एपीआई से कमेंट पढ़ना, उनका जवाब देना, छिपाना और हटाना: सार्वजनिक जवाब, हर कमेंट पर 7 दिनों में एक निजी जवाब, और लागू नियम।API के ज़रिए Instagram DMs और 24 घंटे की विंडोAPI के ज़रिए Instagram DMs कैसे काम करते हैं: कौन खाते को मैसेज कर सकता है, 24 घंटे की विंडो, निजी जवाब और Allow access to messages सेटिंग।Instagram API गड़बड़ियाँ: आम कोड क्या बताते हैंInstagram API की आम गड़बड़ियाँ और उनका मतलब: समाप्त टोकन, रेट लिमिट, Meta द्वारा न लाया जा सकने वाला मीडिया, पब्लिशिंग सीमा और बंद DM विंडो।कौन से Instagram खाते एपीआई के साथ काम करते हैं: कारोबारी, क्रिएटर या पर्सनलInstagram का एपीआई प्रोफ़ेशनल खातों के साथ काम करता है: कारोबारी या क्रिएटर। कौन सा चुनें, स्विच करने पर क्या बदलता है और ऐप में कैसे स्विच करें।Instagram कमेंट्स वेबहुक: पेलोड, फ़ील्ड दर फ़ील्डपोस्ट और रील्स पर कमेंट होने पर Instagram का comments वेबहुक क्या भेजता है: पेलोड फ़ील्ड दर फ़ील्ड, उसमें क्या नहीं होता और आम गड़बड़ियाँ।Instagram मैसेज वेबहुक: DM पेलोड, इको और फ़ील्डDM के लिए Instagram मैसेज वेबहुक में क्या आता है: भेजने वाले का ID, टेक्स्ट, अटैचमेंट, स्टोरी रिप्लाई, इको और 24 घंटे की विंडो।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित