फ़ेसबुक वेबहुक पुष्टि: hub.challenge और X-Hub-Signature-256
Facebook एक वेबहुक एंडपॉइंट की पुष्टि एक GET अनुरोध से करता है, जिसमें hub.mode का मान subscribe, hub.verify_token और hub.challenge होते हैं। एंडपॉइंट टोकन को ऐप डैशबोर्ड में दिए टोकन से मिलाता है और challenge को बॉडी में लौटाता है। इसके बाद हर इवेंट एक POST के रूप में आता है, जिस पर X-Hub-Signature-256 में sha256= के बाद पेलोड का HMAC-SHA256 होता है, जिसकी key ऐप सीक्रेट है।
easyCoexistence हर उस पेज के लिए Meta की ओर का काम संभालता है जिसे आप कनेक्ट करते हैं: उसका ऐप hub.challenge का जवाब देता है, X-Hub-Signature-256 जाँचता है, और पेज को फ़ीड, मैसेज और मेंशन के लिए सब्सक्राइब करता है।
Meta के पुष्टि अनुरोध में hub.mode का मान हमेशा subscribe रहता है; hub.challenge एक पूर्णांक है जिसे वापस भेजना होता है।
X-Hub-Signature-256 का प्रीफ़िक्स, जिसके बाद Meta द्वारा पेलोड और App Secret से बना SHA256 सिग्नेचर आता है।
Messenger वेबहुक एंडपॉइंट को हर नोटिफ़िकेशन का कितनी जल्दी 200 OK से जवाब देना चाहिए।
विफल डिलीवरी की कितनी संख्या के बाद Webhooks Disabled अलर्ट आता है और ऐप का पेज से सदस्यता रद्द होता है।
Meta किसी विफल पेज नोटिफ़िकेशन को घटती आवृत्ति से कितनी देर तक दोबारा भेजता है, फिर उसे छोड़ देता है।
Meta के पुष्टि अनुरोध में क्या होता है?
कॉलबैक यूआरएल पर एक GET, जो तब भेजा जाता है जब ऐप डैशबोर्ड में Webhooks प्रोडक्ट कॉन्फ़िगर होता है या /{app-id}/subscriptions के ज़रिए सब्सक्रिप्शन बनाया जाता है। इसके साथ तीन क्वेरी पैरामीटर आते हैं:
- hub.mode: हमेशा subscribe।
- hub.challenge: एक पूर्णांक जिसे एंडपॉइंट को वापस भेजना होता है।
- hub.
verify_token: वह स्ट्रिंग जो डैशबोर्ड के Verify Token फ़ील्ड में डाली जाती है। - PHP बिंदुओं (dots) को अंडरस्कोर में बदल देता है, इसलिए वह इन्हें
hub_mode,hub_challengeऔरhub_verify_tokenपढ़ता है।
एंडपॉइंट को इसका जवाब कैसे देना चाहिए?
200 के साथ, जिसकी पूरी बॉडी hub.challenge का मान हो, लेकिन केवल तब जब hub.mode subscribe हो और hub.verify_token मेल खाए। बाकी किसी भी स्थिति में Meta के सैंपल ऐप की तरह 403 दें। डैशबोर्ड बताता है कि एंडपॉइंट पास हुआ या नहीं, और /{app-id}/subscriptions सफलता या गड़बड़ी के साथ जवाब देता है। एंडपॉइंट को वैध TLS या SSL सर्टिफ़िकेट के साथ HTTPS चाहिए, क्योंकि सेल्फ़-साइन्ड सर्टिफ़िकेट समर्थित नहीं हैं।
X-Hub-Signature-256 कैसे बनता है?
यह अनुरोध के पेलोड का HMAC-SHA256 है, जिसकी key ऐप का App Secret है, और यह sha256= के बाद लोअरकेस hex में लिखा जाता है। Meta की Messenger गाइड जोड़ती है कि सिग्नेचर उस पेलोड पर बनता है जिसमें Unicode escape किया गया हो, इसलिए äöå जैसी स्ट्रिंग \u00e4\u00f6\u00e5 गिनी जाती है। इसलिए कच्ची बॉडी को ठीक वैसे ही हैश करें जैसी वह आई, कभी डिकोड या दोबारा serialize की गई कॉपी को नहीं। Meta कहता है कि validate करना वैकल्पिक है, पर इसकी दृढ़ सिफ़ारिश करता है।
कोड में इसकी जाँच कैसे करें?
कच्चे बाइट रखें, HMAC निकालें, constant time में तुलना करें, फिर parse करें। Flask का get_data बॉडी को बिना छुए लौटाता है, और सिग्नेचर इसी पर बना था; पहले parse करके फिर दोबारा serialize करने से बाइट बदल जाते हैं। यह एक छोटा एंडपॉइंट है जो पुष्टि का जवाब देता है और हर POST की जाँच करता है:
import hashlib, hmac, os
from flask import Flask, abort, request
app = Flask(__name__)
VERIFY_TOKEN = os.environ["VERIFY_TOKEN"]
APP_SECRET = os.environ["APP_SECRET"].encode()
@app.get("/webhooks/facebook")
def verify():
token = request.args.get("hub.verify_token", "")
if request.args.get("hub.mode") == "subscribe" and hmac.compare_digest(token.encode(), VERIFY_TOKEN.encode()):
return request.args.get("hub.challenge", ""), 200
abort(403)
@app.post("/webhooks/facebook")
def receive():
raw = request.get_data() # the bytes Meta signed
expected = "sha256=" + hmac.new(APP_SECRET, raw, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected.encode(), request.headers.get("X-Hub-Signature-256", "").encode()):
abort(401)
# answer at once; hand request.get_json() to a queue for the work
return "EVENT_RECEIVED", 200पुष्टि के बाद Meta क्या अपेक्षा करता है?
हर नोटिफ़िकेशन पर 200 OK, Messenger इवेंट के लिए 5 सेकंड के भीतर। Meta एक डिलीवरी में 1,000 अपडेट तक बैच कर सकता है, पर इसकी गारंटी नहीं देता, और विफलताओं को इस तरह संभालता है:
- पेज नोटिफ़िकेशन: तुरंत दोबारा भेजे जाते हैं, फिर 36 घंटों में घटती आवृत्ति से कुछ और बार, फिर छोड़ दिए जाते हैं।
- Messenger नोटिफ़िकेशन: तुरंत कुछ बार दोबारा भेजे जाते हैं; 15 मिनट की विफलता के बाद डेवलपर खाते पर अलर्ट पहुँचता है।
- एक घंटे की विफलता के बाद Webhooks Disabled अलर्ट आता है और ऐप तब तक पेज से सदस्यता रद्द रहता है जब तक वह फिर से सब्सक्राइब न करे।
- दोबारा भेजने से एक इवेंट दो बार और क्रम बदलकर आ सकता है, इसलिए डुप्लिकेट हटाएँ और मैसेज उनके timestamp से क्रम में लगाएँ।
- पुराने नोटिफ़िकेशन बाद में क्वेरी नहीं किए जा सकते, इसलिए जो चाहिए वह आते ही सहेज लें।
easyCoexistence Meta की जाँचें कैसे पास करता है?
उसके Meta ऐप का हर उस पेज के लिए एक कॉलबैक यूआरएल है जिसे वह कनेक्ट करता है, और वह एंडपॉइंट दोनों जाँचें खुद करता है। GET का जवाब केवल तब देता है जब hub.mode subscribe हो और verify token मेल खाए, constant time में तुलना करके, वरना 403 लौटाता है। हर POST को raw text के रूप में पढ़ता है, अपने ऐप सीक्रेट से X-Hub-Signature-256 दोबारा निकालता है, मेल न खाने पर 401 से इनकार करता है, और Meta को तुरंत जवाब देता है, इवेंट का काम जवाब के बाद करता है।
easyCoexistence जो फ़ॉरवर्ड करता है उस पर सिग्नेचर कैसे लगाता है?
उसके अपने सिग्नेचर से, क्योंकि Meta का हेडर केवल easyCoexistence के ऐप सीक्रेट से जाँचा जा सकता है और आगे नहीं भेजा जाता। कनेक्टेड पेज की हर entry, जिसका एंडपॉइंट सेट है, JSON के रूप में POST होती है: {platform, account_id, external_id, entry}, साथ में X-EC-Signature हेडर t=<unix>,v1=<hex> के रूप में, जहाँ v1 timestamp, एक dot और raw body का HMAC-SHA256 है, जिसकी key उस पेज का signing secret है:
- सीक्रेट whsec_ से शुरू होता है और इसे
set_social_webhook_destinationया Partner एपीआई पर PUT /channels/:id/webhook से एक बार दिखाया जाता है। - URL फिर से सेट करने पर नया सीक्रेट जारी होता है, और null URL फ़ॉरवर्डिंग बंद कर देता है।
- हर फ़ॉरवर्ड एक बार भेजा जाता है, 8 सेकंड तक इंतज़ार करते हुए, रीडायरेक्ट को फ़ॉलो किए बिना, केवल ऐसे HTTPS पते पर जो सार्वजनिक IP पर resolve होता हो।
- इवेंट की कोई कॉपी नहीं रखी जाती, इसलिए दोबारा कोशिश के लिए कुछ नहीं है।
X-EC-Signature की जाँच कैसे करें?
हेडर को t और v1 में बाँटें, 5 मिनट से पुराना timestamp अस्वीकार करें, उस पेज के signing secret से t, एक dot और raw body पर HMAC दोबारा निकालें, और constant time में तुलना करें। Node.js में, body को raw bytes के रूप में रखकर:
import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.EC_SIGNING_SECRET; // whsec_..., shown once
app.post("/events/facebook", express.raw({ type: "application/json" }), (req, res) => {
const sig = Object.fromEntries(
String(req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("="))
);
const fresh = Math.abs(Date.now() / 1000 - Number(sig.t)) <= 300;
const expected = crypto
.createHmac("sha256", SECRET)
.update(Buffer.concat([Buffer.from(`${sig.t}.`), req.body]))
.digest("hex");
const ok = fresh && typeof sig.v1 === "string" && sig.v1.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
if (!ok) return res.sendStatus(401);
res.sendStatus(200); // answer first: forwards are not retried
const { platform, account_id, external_id, entry } = JSON.parse(req.body.toString("utf8"));
// queue entry for the work
});आम गड़बड़ियाँ
- hub.challenge को JSON या quotes में लपेटना। 200 की बॉडी challenge का मान ही होनी चाहिए।
- JSON parser के बाद HMAC निकालना। Parse और दोबारा serialize करने से बाइट बदल जाते हैं, और Meta पेलोड पर Unicode escape के साथ साइन करता है, इसलिए raw body को हैश करें।
- जवाब देने से पहले काम करना। Messenger 5 सेकंड के भीतर 200 की उम्मीद करता है, और एक घंटे की विफलता ऐप को पेज से सदस्यता रद्द कर देती है।
- फ़ॉरवर्ड किए गए इवेंट पर Meta का सिग्नेचर जाँचना। Meta easyCoexistence के ऐप सीक्रेट से साइन करता है; फ़ॉरवर्ड किए गए इवेंट में X-EC-Signature होता है, जिसे पेज के signing secret से जाँचा जाता है।
फिर इवेंट्स को उस पेज के सीक्रेट से X-EC-Signature के साथ साइन करके आपके HTTPS एंडपॉइंट पर भेजता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन जुड़ते हैं दाम घटता है, और पहले 3 दिन का ट्रायल मुफ़्त है।
अक्सर पूछे जाने वाले सवाल
Verify Token कहाँ से आता है?
आप इसे खुद चुनते हैं। यह वह स्ट्रिंग है जो ऐप डैशबोर्ड में वेबहुक कॉन्फ़िगर करते समय Verify Token फ़ील्ड में डाली जाती है, या /{app-id}/subscriptions को भेजा गया verify_token।
क्या मैं curl से पुष्टि जाँच सकता हूँ?
हाँ। Meta की Messenger गाइड hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED और hub.mode=subscribe के साथ GET भेजती है, और काम करने वाला एंडपॉइंट CHALLENGE_ACCEPTED का जवाब देता है।
अगर मेरा एंडपॉइंट एक घंटे तक विफल रहे तो क्या होगा?
Meta Webhooks Disabled अलर्ट भेजता है और ऐप को पेज से सदस्यता रद्द कर देता है। एंडपॉइंट ठीक करने के बाद subscribed_apps के ज़रिए पेज को फिर से सब्सक्राइब करें।
क्या किसी पेज के वेबहुक पाने के लिए मेरा अपना Meta ऐप चाहिए?
easyCoexistence के साथ नहीं। Meta अपने ऐप पर डिलीवर करता है, जो हर पेज के इवेंट्स को आपके सेट किए एंडपॉइंट पर X-EC-Signature से साइन करके फ़ॉरवर्ड करता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित