Instagram वेबहुक पडताळणी: hub.challenge आणि X-Hub-Signature-256
Instagram वेबहुक सेट करण्यासाठी HTTPS एंडपॉइंट लागतो, जो Meta च्या पडताळणी GET विनंतीला उत्तर देतो. या विनंतीत hub.mode हे subscribe वर सेट केलेले असते, तसेच hub.verify_token आणि hub.challenge असतात. एंडपॉइंट टोकन तपासतो आणि challenge परत करतो. त्यानंतर, ॲपने फील्ड्स सबस्क्राइब केल्यावर आणि प्रत्येक खाते त्याच्या subscribed_apps एजद्वारे सबस्क्राइब झाल्यावर, Meta X-Hub-Signature-256 मध्ये सही केलेले JSON इव्हेंट्स POST करते, ज्यावर ॲपच्या सीक्रेटची सही असते.
easyCoexistence Meta च्या बाजूची जबाबदारी घेते: त्याचे ॲप पडताळणी पार करते, X-Hub-Signature-256 तपासते, प्रत्येक जोडलेले Instagram खाते comments, messages आणि mentions साठी सबस्क्राइब करते, आणि इव्हेंट्स तुमच्या HTTPS एंडपॉइंटला X-EC-Signature आणि प्रति खाते सीक्रेटने सही करून फॉरवर्ड करते, तसेच प्रत्येक कनेक्शनवर चोवीस तास लक्ष ठेवते.
Meta च्या पडताळणी विनंतीमध्ये hub.mode हे मूल्य नेहमी असते.
अयशस्वी सूचना Meta किती कालावधीपर्यंत पुन्हा पाठवते, वारंवारता कमी होत जाते, आणि त्यानंतर ती सोडून दिली जाते तो कालावधी.
Meta डेव्हलपर खात्याला अलर्ट पाठवण्यापूर्वी अयशस्वी मेसेजिंग डिलिव्हरींची संख्या.
Webhooks Disabled अलर्ट येण्यापूर्वी आणि ॲपचे खात्यातील सबस्क्रिप्शन रद्द होण्यापूर्वी अयशस्वी मेसेजिंग डिलिव्हरींची संख्या.
ॲपला त्याच्या वापरकर्त्यांच्या खात्यांसाठी सूचना मिळण्यापूर्वी Meta ला आवश्यक असलेला ॲप मोड.
Instagram वेबहुक सेट अप कसे चालते?
Meta च्या मार्गदर्शकात दिलेल्या क्रमाने चार चरणांत. कोणतेही फील्ड निवडण्यापूर्वी एंडपॉइंटने पडताळणी पार करणे आवश्यक आहे, ॲप वापरकर्त्यांच्या खात्यांसाठी सूचना मिळवण्यासाठी Live असणे आवश्यक आहे, आणि प्रोडक्शन ॲक्सेससाठी व्यवसाय पडताळणी आवश्यक आहे.
पडताळणी विनंतीत काय असते?
कॉलबॅक यूआरएलवर पाठवलेली GET विनंती, जी App Dashboard मध्ये Webhooks हे उत्पादन कॉन्फिगर केल्यावर पाठवली जाते. 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 अंतर्गत, 'Instagram login सह एपीआय सेटअप' मधील 'Configure webhooks' येथे: कॉलबॅक यूआरएल आणि verify token तिथे टाका, आणि ते सेव्ह केल्यावर पडताळणी विनंती सुरू होते. Instagram उत्पादन सुरुवातीला comments, live_comments, message_reactions, messages, messaging_optins, messaging_postbacks, messaging_referral आणि messaging_seen यांचे सबस्क्रिप्शन घेऊन सुरू होते, आणि 'Manage' मधून यापैकी कोणतेही सबस्क्रिप्शन रद्द करता येते. 'Test' बटण निवडलेल्या फील्डसाठी नमुना सूचना पाठवते.
X-Hub-Signature-256 कसे तपासले जाते?
Meta प्रत्येक इव्हेंट सूचनेवर पेलोडचा HMAC-SHA256 सही करते, ज्याची की ॲप सीक्रेट असते, आणि ती X-Hub-Signature-256 मध्ये sha256= नंतर hex digest अशा स्वरूपात पाठवते. प्राप्तकर्ता मूळ बॉडीवर तोच HMAC काढतो आणि constant time मध्ये हेडरशी तुलना करतो. 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 च्या मेसेजिंग डिलिव्हरी नियमांचे पालन करतात, जे अधिक वेगाने कार्य करतात:
- 5 सेकंदांत 200 OK अपेक्षित आहे, आणि अयशस्वी डिलिव्हरीला काही तात्काळ पुन्हा प्रयत्न मिळतात, त्यामुळे मेसेजच्या mid वर डुप्लिकेट्स काढा.
- 15 मिनिटे अपयश आल्यावर, डेव्हलपर खात्याला अलर्ट जातो.
- एक तास अपयश आल्यावर Webhooks Disabled अलर्ट येतो, आणि ॲप खात्याच्या वेबहुक्समधून अनसबस्क्राइब होते, जोपर्यंत ते पुन्हा सबस्क्राइब होत नाही.
- आउटेज दरम्यान पाठवलेले मेसेजेस क्रम बदलून येऊ शकतात, म्हणून timestamp नुसार लावा.
काहीच येत नसेल तर काय तपासावे?
Meta ची ट्रबलशूटिंग चेकलिस्ट, जी बहुतेक शांत एंडपॉइंट्स कव्हर करते, या क्रमाने:
- कॉलबॅक यूआरएलने आपली पडताळणी पार केली आहे आणि वैध प्रमाणपत्रासह HTTPS वर पोहोचता येतो; self-signed प्रमाणपत्रे समर्थित नाहीत.
- ॲपने फील्ड निवडले आहे आणि त्याला आवश्यक ॲक्सेस पातळी आहे, comments आणि
live_commentsसाठी Advanced Access. subscribed_appsद्वारे खात्यासाठी सूचना सुरू आहेत, आणि टोकन त्याच लॉगिन सेटअपमधील आहे.- खाते फील्डच्या नियमांचे पालन करते: कमेंट सूचनांसाठी सार्वजनिक खात्याच्या मालकीचे मीडिया आवश्यक आहे.
- सर्व्हर संथ काम सुरू करण्यापूर्वी success परत करतो.
easyCoexistence फॉरवर्ड केलेले इव्हेंट्स पुन्हा सही का करते?
कारण Meta ची सही पुढे जाऊ शकत नाही. easyCoexistence चे ॲप Meta ची डिलिव्हरी प्राप्त करते, आपल्या स्वतःच्या ॲप सीक्रेटने X-Hub-Signature-256 तपासते, Meta ला लगेच उत्तर देते, आणि जोडलेल्या खात्याच्या प्रत्येक एंट्रीला त्या खात्यासाठी सेट केलेल्या एंडपॉइंटवर 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 असतो, जो खात्याच्या साइनिंग सीक्रेटने की केलेला असतो. जसे प्राप्त झाले तसे बाइट्सवर पुन्हा काढा, constant time मध्ये तुलना करा, आणि 5 मिनिटांपेक्षा जुना timestamp नाकारा.
- सीक्रेट whsec_ ने सुरू होते आणि URL सेट केल्यावर
set_social_webhook_destinationकिंवा PUT /channels/:id/webhook द्वारे एकदाच दाखवले जाते. - URL पुन्हा सेट केल्यास नवीन सीक्रेट मिळते, आणि null URL फॉरवर्डिंग बंद करते.
- प्रत्येक इव्हेंट एकदाच पाठवला जातो, 8 सेकंदांपर्यंत वाट पाहत, रिडायरेक्ट न फॉलो करता, सार्वजनिक IP मध्ये resolve होणाऱ्या 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 प्रमाणपत्रांना समर्थन देत नाही: कॉलबॅक यूआरएल वैध प्रमाणपत्रासह HTTPS वर पोहोचता येणारा असला पाहिजे, जी Meta च्या ट्रबलशूटिंग चेकलिस्टवरील पहिली बाब आहे.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: