Instagram वेबहुक प्रमाणीकरण: hub.challenge र X-Hub-Signature-256
Instagram वेबहुक सेटअप गर्न HTTPS एन्डपोइन्ट चाहिन्छ, जसले Meta को प्रमाणीकरण GET अनुरोधको प्रतिक्रिया दिन्छ। त्यो अनुरोधमा hub.mode को मान subscribe, hub.verify_token र hub.challenge हुन्छन्। एन्डपोइन्टले टोकन जाँच गरेर challenge मान फिर्ता पठाउँछ। त्यसपछि, एपले फिल्डहरूको सदस्यता लिएर हरेक खाता subscribed_apps edge मार्फत सदस्य भएपछि, Meta ले X-Hub-Signature-256 मा हस्ताक्षर गरिएका JSON घटनाहरू POST गर्छ।
easyCoexistence ले Meta पक्ष सम्हाल्छ: यसको एपले प्रमाणीकरण पास गर्छ, X-Hub-Signature-256 जाँच्छ, जडान भएका हरेक Instagram खातालाई comments, messages र mentions मा सदस्य गराउँछ, र घटनाहरू X-EC-Signature र खाताअनुसार सिक्रेटसहित तपाईंको HTTPS एन्डपोइन्टमा फर्वार्ड गर्छ, र हरेक जडानलाई चौबीसै घण्टा अनुगमन गर्छ।
Meta को प्रमाणीकरण अनुरोधमा hub.mode को मान सधैं समावेश हुन्छ।
Meta ले असफल सूचना घट्दो आवृत्तिमा पुनः प्रयास गर्ने अवधि, हटाउनुअघि।
विकासकर्ताको खातामा अलर्ट जानुअघि असफल म्यासेज डेलिभरीको सङ्ख्या।
Webhooks Disabled अलर्ट र एपको खाताबाट सदस्यता हटाइनुअघिका असफल म्यासेज डेलिभरीहरू।
एपले प्रयोगकर्ताका खाताका सूचना पाउनुअघि Meta ले माग गर्ने एप मोड।
Instagram वेबहुक सेटअप कसरी काम गर्छ?
Meta को गाइडले दिएको क्रममा चार चरणमा। कुनै फिल्ड चयन गर्नुअघि एन्डपोइन्टले प्रमाणीकरण पास गर्नुपर्छ, एपका प्रयोगकर्ताका खाताका सूचना पाउन एप Live हुनुपर्छ, र प्रोडक्शन पहुँचका लागि व्यवसाय प्रमाणीकरण आवश्यक छ।
प्रमाणीकरण अनुरोधमा के समावेश हुन्छ?
कल-ब्याक URL मा GET, जुन App Dashboard मा Webhooks product कन्फिगर गर्दा सधैं पठाइन्छ। hub.verify_token एन्डपोइनको आफ्नै टोकनसँग मेल खाएमा उत्तर 200 हुन्छ, र शरीर भनेको hub.challenge मान मात्र हो; नत्र 403 हुन्छ। ड्यासबोर्डले एन्डपोइन्ट पास भयो कि भनेर जनाउँछ।
- hub.mode: सधैं subscribe हुन्छ।
- hub.challenge: Meta ले उत्पन्न गर्ने एउटा पूर्णांक, जुन एन्डपोइन्टले फिर्ता पठाउनुपर्छ।
- hub.
verify_token: ड्यासबोर्डको Verify Token फिल्डमा राखिएको स्ट्रिङ, जो केवल Meta र एन्डपोइन्टले मात्र जान्नुपर्छ। - PHP मा, यी नामका डटहरू अन्डरस्कोरमा बदलिन्छन्, त्यसैले मानहरू
hub_mode,hub_challengeरhub_verify_tokenका रूपमा आउँछन्।
GET https://<YOUR_HOST>/webhooks/instagram
?hub.mode=subscribe
&hub.challenge=1158201444
&hub.verify_token=<YOUR_VERIFY_TOKEN>
HTTP/1.1 200 OK
Content-Type: text/plain
1158201444कल-ब्याक र फिल्डहरू कहाँ सेट गरिन्छ?
App Dashboard मा, Instagram, API setup with Instagram login अन्तर्गत, Configure webhooks: कल-ब्याक URL र verify token त्यहाँ राखिन्छन्, र बचत गर्दा प्रमाणीकरण अनुरोध ट्रिगर हुन्छ। Instagram product comments, live_comments, message_reactions, messages, messaging_optins, messaging_postbacks, messaging_referral र messaging_seen मा सदस्य सुरु हुन्छ, र Manage ले तिनमध्ये कुनै पनि सदस्यता हटाउँछ। Test बटनले चयन गरिएको फिल्डको नमुना सूचना पठाउँछ।
X-Hub-Signature-256 कसरी जाँचिन्छ?
Meta ले हरेक घटना सूचनालाई पेलोडको HMAC-SHA256 सँग हस्ताक्षर गर्छ, जसको कुञ्जी एपको सिक्रेट हो, र sha256= पछि हेक्स डाइजेस्ट राखेर X-Hub-Signature-256 मा पठाउँछ। रिसिभरले कच्चा अनुरोध बडीमा त्यही HMAC गणना गर्छ र हेडरसँग स्थिर समयमा तुलना गर्छ। Meta को म्यासेजिङ गाइडले भन्छ, हस्ताक्षरले Unicode escape गरिएको पेलोडलाई समेट्छ, त्यसैले डिकोड गरिएको वा पुनः क्रमबद्ध गरिएको JSON ह्यास गर्दा फरक नतिजा आउँछ।
import crypto from "node:crypto";
import express from "express";
const app = express();
const { VERIFY_TOKEN, APP_SECRET } = process.env;
// Verification request: send hub.challenge back when the token matches
app.get("/webhooks/instagram", (req, res) => {
const ok = req.query["hub.mode"] === "subscribe" &&
req.query["hub.verify_token"] === VERIFY_TOKEN;
if (!ok) return res.sendStatus(403);
res.status(200).type("text/plain").send(req.query["hub.challenge"]);
});
// Event notification: check the signature over the raw bytes
app.post("/webhooks/instagram", express.raw({ type: "application/json" }), (req, res) => {
const expected = Buffer.from(
"sha256=" + crypto.createHmac("sha256", APP_SECRET).update(req.body).digest("hex")
);
const given = Buffer.from(req.get("X-Hub-Signature-256") ?? "");
if (given.length !== expected.length || !crypto.timingSafeEqual(given, expected)) {
return res.sendStatus(401);
}
res.sendStatus(200); // answer first, work after
const body = JSON.parse(req.body.toString("utf8"));
// hand body.entry to a queue or background job
});
app.listen(3000);किन एपको सिक्रेटले मात्र यो जाँच गर्न सक्छ?
किनभने हस्ताक्षर त्यही सिक्रेटबाट बनेको HMAC हो। त्यो बिना कसैले अपेक्षित मान गणना गर्न सक्दैन, र पेलोडको प्रतिलिपि भए पनि कसैले नक्कली बनाउन सक्दैन, त्यसैले जाँच एपका लागि Meta को अनुरोध पाउने सर्भरमा हुनुपर्छ। Meta ले एप सिक्रेटहरू, एक्सेस टोकनहरू र क्लाइन्ट क्रेडेन्सियलहरू लग र सपोर्ट अनुरोधहरूमा समावेश नगर्न भन्छ। अर्को एपबाट पठाइएका घटना प्राप्त गर्ने प्रणालीले Meta को हस्ताक्षर जाँच गर्न सक्दैन, र त्यसको सट्टा त्यस एपकै आफ्नो हस्ताक्षरमा भर पर्छ।
हरेक खातालाई किन आफ्नै सदस्यता चाहिन्छ?
किनभने App Dashboard ले एपले के प्राप्त गर्न सक्छ भन्ने कुरा तोक्छ, तर खाताका सूचना त्यो खाता पनि सदस्य भएपछि मात्र सुरु हुन्छन्। Instagram Login सँग, Instagram User एक्सेस टोकन सहित graph.instagram.com मा POST /<IG_ID>/subscribed_apps पठाउनुहोस्, र subscribed_fields मा एपका लागि चयन गरिएका फिल्डहरू अल्पविरामले छुट्याएर राख्नुहोस्। सफल अनुरोधले success को मान true फिर्ता दिन्छ।
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }डेलिभरी असफल हुँदा Meta ले के गर्छ?
यसले पुनः प्रयास गर्छ, त्यसपछि छाड्छ। Meta को गाइडले हरेक सूचनामा 200 OK अपेक्षा गर्छ, र 1,000 अपडेटसम्मको ब्याचिङ सुनिश्चित नहुने चेतावनी दिन्छ। असफल अपडेट तुरुन्त पुनः प्रयास गरिन्छ, त्यसपछि 36 घण्टासम्म घट्दो आवृत्तिमा केही पटक थप, र त्यसपछि हटाइन्छ, त्यसैले उही घटना दुई पटक आउन सक्छ। म्यासेजिङ घटनाहरू Meta को म्यासेजिङ डेलिभरी नियम पछ्याउँछन्, जुन अझ छिटो काम गर्छ:
- 200 OK 5 सेकेन्डभित्र अपेक्षा गरिन्छ, र असफल डेलिभरीमा केही तत्काल पुनः प्रयास हुन्छ, त्यसैले म्यासेज mid मा डुप्लिकेट हटाउनुहोस्।
- 15 मिनेट असफलताको पछि, विकासकर्ताको खातामा अलर्ट जान्छ।
- एक घण्टा असफलताको पछि, Webhooks Disabled अलर्ट आउँछ, र एप खाताका वेबहुकहरूबाट फेरि सदस्यता नलिउन्जेल सदस्यता हटाइन्छ।
- आउटेजको समयमा पठाइएका म्यासेजहरू क्रम बिग्रेर आउन सक्छन्, त्यसैले तिनलाई timestamp अनुसार क्रमबद्ध गर्नुहोस्।
केही पनि नआउँदा के जाँच गर्ने?
धेरैजसो मौन एन्डपोइन्ट समेट्ने Meta को समस्या निवारण चेकलिस्ट, यो क्रममा:
- कल-ब्याक URL ले आफ्नो जाँच पास गरेको छ र valid प्रमाणपत्र सहित HTTPS मार्फत पहुँचयोग्य छ; self-signed प्रमाणपत्र समर्थित छैन।
- एपले फिल्ड चयन गरेको छ र आवश्यक पहुँच स्तर छ, comments र
live_commentsका लागि Advanced Access। - खाताका लागि सूचनाहरू
subscribed_appsमार्फत सक्षम गरिएका छन्, उही लग इन सेटअपको टोकनसहित। - खातले फिल्डका नियम पूरा गर्छ: comment सूचनाका लागि सार्वजनिक खाताको स्वामित्वमा रहेको मिडिया चाहिन्छ।
- सर्भरले सुस्त काम सुरु गर्नुअघि success फिर्ता दिन्छ।
easyCoexistence किन फर्वार्ड गरिएका घटनाहरूमा फेरि हस्ताक्षर गर्छ?
किनभने Meta को हस्ताक्षर यात्रा गर्न सक्दैन। easyCoexistence को एपले Meta को डेलिभरी प्राप्त गर्छ, आफ्नै एप सिक्रेटले X-Hub-Signature-256 जाँच्छ, Meta लाई तुरुन्त उत्तर दिन्छ, र जडान भएको खाताको हरेक entry लाई त्यस खाताका लागि तोकिएको एन्डपोइन्टमा POST गर्छ, नयाँ बडीभित्र platform, account_id, external_id र entry सहित। Meta को हेडर पठाइँदैन र त्यो सिक्रेट बिना जाँच्न सकिँदैन, त्यसैले हरेक फर्वार्डमा Content-Type: application/json र X-EC-Signature हुन्छ, जुन एउटै खातासँग सम्बन्धित सिक्रेटले कुञ्जीकृत गरिएको हुन्छ।
X-EC-Signature कसरी प्रमाणित गर्ने?
हेडरमा t=<unix>,v1=<hex> हुन्छ, जहाँ v1 भनेको timestamp, डट र कच्चा बडीको hex HMAC-SHA256 हो, खाताको हस्ताक्षर गर्ने सिक्रेटले कुञ्जीकृत। प्राप्त गरेका बाइटहरूमा ठ्याक्कै पुनः गणना गर्नुहोस्, स्थिर समयमा तुलना गर्नुहोस्, र 5 मिनेटभन्दा पुरानो timestamp अस्वीकार गर्नुहोस्।
- सिक्रेट whsec_ बाट सुरु हुन्छ र URL सेट गर्दा
set_social_webhook_destinationवा PUT /channels/:id/webhook ले एक पटक देखाउँछ। - URL फेरि सेट गर्दा नयाँ सिक्रेट जारी हुन्छ, र null URL ले फर्वार्डिङ बन्द गर्छ।
- हरेक घटना एक पटक पठाइन्छ, 8 सेकेन्डसम्म पर्खेर, रिडाइरेक्ट नपछ्याइकन, सार्वजनिक IP मा समाधान हुने HTTPS ठेगानामा।
- जडान हटाउँदा खाताको Meta वेबहुकबाट सदस्यता हटिन्छ र यसको एन्डपोइन्ट र सिक्रेट मेटिन्छन्।
import hashlib, hmac, time
def verify_ec_signature(raw_body: bytes, header: str, secret: str) -> bool:
"""Check X-EC-Signature on an event forwarded by easyCoexistence."""
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, malformed or older than 5 minutes
expected = hmac.new(secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected.encode(), v1.encode())सामान्य गल्तीहरू
- प्रमाणीकरणको challenge JSON वा उद्धरण चिह्नमा फर्काउनु। Meta ले hub.challenge मान नै बडीको रूपमा, 200 स्ट्याटससहित, अपेक्षा गर्छ।
- पार्स गरिएको बडीलाई ह्यास गर्नु। JSON बडी पार्सरले Meta ले हस्ताक्षर गरेका ठ्याक्कै बाइटहरू हटाउँछ, त्यसैले HMAC का लागि कच्चा बडी राख्नुहोस् र त्यसपछि पार्स गर्नुहोस्।
- एप सदस्य गराउने तर खाता बिर्सनु। POST /<IG_ID>/subscribed_apps एउटा खाताका लागि सफल नभएसम्म, त्यसका लागि कुनै सूचना आउँदैन।
- एन्डपोइन्टलाई एक घण्टासम्म असफल हुन दिनु। Meta ले म्यासेजिङ वेबहुक असक्षम गर्छ र एपलाई खाताबाट सदस्यता हटाउँछ, जुन फेरि सदस्य गराउनुपर्छ।
set_social_webhook_destination वा Partner API बाट सक्रिय गर्नुहोस्। प्रति जडान प्रति महिना US$ 9 देखि US$ 0.75 सम्म, जडान थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
Instagram वेबहुकमा hub.challenge के हो?
Meta ले आफ्नो प्रमाणीकरण GET मा पठाउने एउटा पूर्णांक हो। hub.verify_token जाँचेपछि, एन्डपोइन्टले यसलाई प्रतिक्रियाको बडीका रूपमा फिर्ता पठाउँछ, जसले URL मा नियन्त्रण भएको प्रमाणित गर्छ।
PHP मा hub.mode र hub.challenge किन देखिँदैनन्?
PHP ले प्यारामिटर नामका डटहरूलाई अन्डरस्कोरमा बदल्छ, त्यसैले Meta का प्रमाणीकरण मानहरू hub_mode, hub_challenge र hub_verify_token का रूपमा आउँछन्।
Meta ले अक्षम गरेपछि Instagram वेबहुक फेरि कसरी सक्रिय गर्ने?
एन्डपोइन्ट सुधार्नुहोस्, त्यसपछि उही फिल्डसहित POST /<IG_ID>/subscribed_apps मार्फत खाताको सदस्यता फेरि लिनुहोस्।
Instagram वेबहुक एन्डपोइन्टका लागि self-signed प्रमाणपत्र काम गर्छ?
छैन, Meta ले self-signed प्रमाणपत्र समर्थन गर्दैन: कल-ब्याक URL HTTPS मार्फत valid प्रमाणपत्र सहित पहुँचयोग्य हुनुपर्छ, जुन Meta को समस्या निवारण चेकलिस्टको पहिलो बुँदा हो।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको