Instagram वेबहुक इभेन्ट: कमेन्ट, मेन्सन र DM
Instagram वेबहुक इभेन्टहरूले व्यावसायिक खातामा भइरहेका गतिविधि जस्तै नयाँ कमेन्ट, @मेन्सन र DM तुरुन्तै रिपोर्ट गर्छन्। Meta ले प्रत्येकलाई जोडिएको एपको HTTPS एन्डपोइन्टमा JSON का रूपमा POST गर्छ, र 36 घण्टासम्म असफल डेलिभरीलाई त्यसमा पुनः प्रयास गर्छ। easyCoexistence ले प्रत्येक इभेन्ट तपाईंको एन्डपोइन्टमा एक पटक मात्र पठाउँछ, खाताअनुसार हस्ताक्षरसहित, कुनै पुनः प्रयास बिना। Instagram Login प्रयोग गर्दा मेन्सनहरू कमेन्ट सूचनाभित्रै आउँछन्।
Meta ले असफल डेलिभरीलाई एपको एन्डपोइन्टमा पुनः प्रयास गर्दै, त्यसलाई हटाउनुअघि कति समयसम्म राख्छ।
धेरैजसो अपडेटहरू Meta ले एउटै वेबहुक डेलिभरीमा समूहबद्ध गर्छ, यद्यपि समूहबद्ध गर्ने कुरा ग्यारेन्टी गर्दैन।
खाता आफैले पठाएका म्यासेज इभेन्टमा Meta ले सेट गर्ने झण्डा।
केवल सार्वजनिक खाताका मिडियाले मात्र कमेन्ट र मेन्सन सूचना ट्रिगर गर्छ।
कुन-कुन इभेन्ट छन्?
Instagram Login सँग जोडिएको व्यावसायिक खाताका लागि तीन प्रकारका गतिविधि इभेन्टका रूपमा आउँछन्:
- कमेन्ट: खाताको मिडियामा आएको नयाँ कमेन्ट, कमेन्ट ID, लेखकको Instagram-scoped ID र युजरनेम, पाठ, र मिडिया ID र प्रकार सहित।
- मेन्सन: Instagram Login सँग यिनीहरू आफ्नै फिल्डका रूपमा होइन, कमेन्ट सूचनाभित्र आउँछन्।
- म्यासेज: खातामा पठाइएको DM, पठाउने र पाउने व्यक्ति, टाइमस्ट्याम्प र म्यासेज आफैं सहित, जसमा पाठ, संलग्नक र Story reply पर्छन्।
इभेन्टहरू तपाईंको एन्डपोइन्टमा कसरी पुग्छन्?
Meta ले Instagram वेबहुक खाता जोडिएको एपमा डेलिभर गर्छ। easyCoexistence ले तिनलाई प्राप्त गर्छ र प्रत्येक खाताका लागि तपाईंले सेट गरेको HTTPS एन्डपोइन्टमा, आइपुग्दै तुरुन्तै, त्यस खातको लागि गोप्य कुञ्जीसँग हस्ताक्षर गरेर पठाउँछ।
एन्डपोइन्ट Claude वा ChatGPT बाट set_social_webhook_destination ले, वा Partner एपीआई मार्फत PUT /channels/:id/webhook ले सेट गर्नुहोस्। हस्ताक्षर गर्ने कुञ्जी एकपटक मात्र देखाइन्छ, एन्डपोइन्ट फेरि सेट गर्दा नयाँ जारी हुन्छ, र यूआरएलका रूपमा null पठाएर फर्वार्डिङ बन्द गर्न सकिन्छ।
डेलिभरी कस्तो देखिन्छ?
JSON बडीसहितको POST, जसमा प्लेटफर्म, list_social_accounts ले जडानलाई दिने account_id, Instagram खाताको external_id, र entry: यस इभेन्टका लागि Meta को वेबहुक entry जस्ताको तस्तै हुन्छ। DM पनि उस्तै तरिकाले आउँछ, changes को सट्टा messaging array सहित। नयाँ कमेन्ट यसरी देखिन्छ:
{
"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 हो, जुन खाताको हस्ताक्षर कुञ्जीले बनाइएको हुन्छ। यसलाई प्राप्त भएझैं ठ्याक्कै कच्चा बडीमाथि गणना गर्नुहोस्, स्थिर समय (constant time) मा तुलना गर्नुहोस्, र 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 सेट भएको म्यासेज इभेन्ट खाताले आफैले पठाएको हो, त्यसैले त्यसको उत्तर चाहिँदैन।- Story reply: Story को उत्तर दिने DM मा Story को ID र यूआरएल सहित
reply_toहुन्छ। - Story मेन्सन: attachment type
story_mentionभएको म्यासेजका रूपमा आउँछन्। - time: Meta ले सूचना कहिले पठायो भन्ने समय हो, कमेन्ट वा म्यासेज कहिले बनाइएको होइन; म्यासेजको आफ्नै टाइमस्ट्याम्प यसको messaging entry मा हुन्छ।
- Album ID: कमेन्ट इभेन्टमा यिनीहरू समावेश हुँदैनन्; कमेन्ट ID सँग एल्बम खोज्नुहोस्।
सामान्य गल्तीहरू
- काम गर्नुअघि उत्तर नदिनु। फर्वार्डिङले पुनः प्रयास गर्दैन, त्यसैले तुरुन्तै 2xx प्रतिक्रिया फिर्ता गर्नुहोस् र इभेन्ट पछि प्रशोधन गर्नुहोस्।
- पार्स गरिएको JSON मा हस्ताक्षर जाँच्नु। HMAC लाई प्राप्त भएझैं कच्चा बडीमाथि गणना गर्नुहोस्।
- इकोमा जवाफ दिनु। is_echo सेट भएको म्यासेज इभेन्ट खाताले पठाएको हो, र त्यसको जवाफ दिँदा लुप सुरु हुन्छ।
- डुप्लिकेट नहटाउनु। असफलतापछि Meta ले उही इभेन्ट फेरि डेलिभर गर्न सक्छ, त्यसैले कमेन्ट ID वा म्यासेजको mid मा कुञ्जी बनाउनुहोस्।
easyCoexistence ले Instagram खाताका कमेन्ट, मेन्सन र DM तपाईंको HTTPS एन्डपोइन्टमा आइपुग्दै पठाउँछ, खाताका लागि छुट्टै गोप्य कुञ्जीले हस्ताक्षर गरेर, र बीचमा कुनै प्रतिलिपि नराखी। Claude वा ChatGPT बाट set_social_webhook_destination ले, वा Partner एपीआई ले खोल्नुहोस्। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
Instagram webhook मा time फिल्डको अर्थ के हो?
Meta ले सूचना कहिले पठायो भन्ने समय हो, कमेन्ट वा म्यासेज कहिले बनाइएको होइन। DM को आफ्नै टाइमस्ट्याम्प यसको messaging entry मा हुन्छ।
के Meta ले असफल Instagram वेबहुक डेलिभरी पुनः प्रयास गर्छ?
हो। Meta ले एपमा असफल डेलिभरीलाई 36 घण्टासम्म पुनः प्रयास गर्छ, त्यसैले उही इभेन्ट कहिलेकाहीँ दुईपटक आउन सक्छ: कमेन्ट ID वा म्यासेजको mid मा डुप्लिकेट हटाउनुहोस्। easyCoexistence ले प्रत्येक इभेन्ट तपाईंको एन्डपोइन्टमा एकपटक मात्र पठाउँछ, त्यसैले छिटो 2xx प्रतिक्रिया दिनुहोस्।
एउटा Instagram वेबहुक डेलिभरीमा कति अपडेट हुन सक्छन्?
Meta ले समूहबद्ध गर्दा 1,000 सम्म, यद्यपि Meta ले समूहबद्ध गर्ने कुरा ग्यारेन्टी गर्दैन। पहिलो वस्तु मात्र नपढी पूरै entry array मा लुप गर्नुहोस्।
के मेन्सनको आफ्नै इभेन्ट हुन्छ?
Instagram Login सँग छैन। Meta ले मेन्सनलाई कमेन्ट सूचनामा समावेश गर्छ, त्यसैले तिनीहरू कमेन्टकै बाटोमा आउँछन्।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको