Facebook वेबहुक पडताळणी: 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, जो ॲप सीक्रेट वापरून काढलेला असतो.
easyCoexistence तुम्ही जोडलेल्या प्रत्येक Page साठी Meta ची बाजू हाताळते: त्याचे ॲप hub.challenge ला उत्तर देते, X-Hub-Signature-256 तपासते आणि Page ला feed, messages आणि मेन्शन साठी सबस्क्राइब करते, मग इव्हेंट X-EC-Signature आणि त्या Page साठीच्या सीक्रेटने स्वाक्षरी केलेल्या तुमच्या HTTPS एंडपॉइंटकडे पुढे पाठवते.
hub.mode हे मूल्य Meta च्या पडताळणी विनंतीत नेहमी येते; hub.challenge हा परत पाठवायचा पूर्णांक आहे.
X-Hub-Signature-256 चा उपसर्ग, त्यामागे Meta ने पेलोड आणि ॲप सीक्रेटवरून तयार केलेली SHA256 स्वाक्षरी.
Messenger वेबहुक एंडपॉइंटने प्रत्येक सूचनेला किती लवकर 200 OK ने उत्तर द्यावे.
अयशस्वी डिलिव्हरींची संख्या, ज्यानंतर Webhooks Disabled अलर्ट येतो आणि ॲपची Page वरील सदस्यता रद्द होते.
Meta अयशस्वी Page सूचना कमी होत जाणाऱ्या वारंवारतेने किती वेळ पुन्हा पाठवते, आणि नंतर ती टाकून देते.
Meta च्या पडताळणी विनंतीत काय असते?
Webhooks उत्पादन App Dashboard मध्ये कॉन्फिगर केल्यावर किंवा /{app-id}/subscriptions द्वारे सबस्क्रिप्शन तयार केल्यावर नेहमी कॉलबॅक यूआरएलवर GET पाठवले जाते. त्यासोबत तीन क्वेरी पॅरामीटर येतात:
- hub.mode: नेहमी subscribe.
- hub.challenge: एंडपॉइंटने परत पाठवायचा पूर्णांक.
- hub.
verify_token: डॅशबोर्डच्या Verify Token फील्डमध्ये टाकलेली स्ट्रिंग. - PHP टिंबांना अंडरस्कोअरमध्ये बदलते, म्हणून ते
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, sha256= नंतर लोअरकेस हेक्समध्ये लिहिलेला. Meta च्या Messenger मार्गदर्शकात भर दिली आहे की स्वाक्षरी युनिकोड एस्केप केलेल्या पेलोडवर मोजली जाते, म्हणून äöå सारखी स्ट्रिंग \u00e4\u00f6\u00e5 म्हणून मोजली जाते: कच्चा बॉडी जसा आला तसाच हॅश करा, कधीही डीकोड केलेली किंवा पुन्हा सिरीयलाइज केलेली प्रत नाही. Meta म्हणते की पडताळणी ऐच्छिक आहे, पण ती करण्याची जोरदार शिफारस करते.
कोडमध्ये ते कसे तपासायचे?
कच्चे बाइट्स ठेवा, HMAC मोजा, स्थिर वेळेत तुलना करा, आणि मगच पार्स करा. Flask चा get_data बॉडी अबदलित परत देतो, आणि स्वाक्षरी त्यावरच मोजली गेली होती; आधी पार्स करून पुन्हा सिरीयलाइज केल्यास बाइट्स बदलतील. पडताळणीला उत्तर देणारा आणि प्रत्येक 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 अपडेटपर्यंत बॅच करते, पण त्याची हमी देत नाही, आणि अपयश अशा प्रकारे हाताळते:
- Page सूचना: लगेच पुन्हा प्रयत्न, नंतर 36 तासांत कमी होत जाणाऱ्या वारंवारतेने आणखी काही वेळा, नंतर टाकून दिल्या जातात.
- Messenger सूचना: लगेच काही वेळा पुन्हा प्रयत्न; 15 मिनिटे अपयश आल्यावर डेव्हलपर खात्यावर अलर्ट पोहोचतो.
- एक तास अपयश आल्यावर Webhooks Disabled अलर्ट येतो आणि पुन्हा सबस्क्राइब होईपर्यंत ॲपची Page वरील सदस्यता रद्द होते.
- पुन्हा प्रयत्नांमुळे एखादी इव्हेंट दोनदा आणि क्रमाबाहेर येऊ शकते, म्हणून डुप्लिकेट काढा आणि मेसेज त्यांच्या टाइमस्टॅम्पनुसार क्रमवारी लावा.
- मागील सूचना नंतर विचारता येत नाहीत, म्हणून आवश्यक ते येताक्षणी साठवा.
easyCoexistence Meta च्या तपासण्या कशा पार करते?
त्याच्या Meta ॲपमध्ये जोडलेल्या Pages साठी एकच कॉलबॅक यूआरएल आहे, आणि तो एंडपॉइंट दोन्ही तपासण्या स्वतः करतो. तो GET ला फक्त तेव्हाच उत्तर देतो जेव्हा hub.mode subscribe असतो आणि verify token जुळतो, स्थिर वेळेत तुलना करून, अन्यथा 403 परत करतो; प्रत्येक POST कच्चा मजकूर म्हणून वाचतो, त्याच्या ॲप सीक्रेटने X-Hub-Signature-256 पुन्हा मोजतो, जुळत नसल्यास 401 ने नाकारतो, आणि लगेच Meta ला उत्तर देतो, इव्हेंट उत्तरानंतर हाताळतो.
easyCoexistence पुढे पाठवलेल्या गोष्टींवर स्वाक्षरी कशी करते?
स्वतःच्या स्वाक्षरीने, कारण Meta चे हेडर फक्त easyCoexistence च्या ॲप सीक्रेटने तपासता येते आणि ते पुढे दिले जात नाही. जोडलेल्या Page साठी एंडपॉइंट सेट असलेली प्रत्येक नोंद त्या एंडपॉइंटला JSON म्हणून POST केली जाते: {platform, account_id, external_id, entry}, आणि X-EC-Signature हेडर असते, फॉर्म t=<unix>,v1=<hex>, जिथे v1 हा टाइमस्टॅम्प, एक बिंदू आणि कच्चा बॉडी यांचा HMAC-SHA256 असतो, त्या Page च्या स्वाक्षरी सीक्रेटने की केलेला:
- सीक्रेट whsec_ ने सुरू होते आणि एकदाच दाखवले जाते,
set_social_webhook_destinationकिंवा Partner API वरील PUT /channels/:id/webhook द्वारे. - URL पुन्हा सेट केल्यावर नवीन सीक्रेट मिळते, आणि null URL असल्यास फॉरवर्डिंग बंद होते.
- प्रत्येक फॉरवर्ड एकदाच पाठवला जातो, 8 सेकंदांपर्यंत वाट पाहून, रीडायरेक्ट न पाळता, सार्वजनिक IP वर रिझॉल्व्ह होणाऱ्या HTTPS पत्त्यावर.
- इव्हेंटची कोणतीही प्रत ठेवली जात नाही, त्यामुळे पुन्हा प्रयत्न करण्यासारखे काही नसते.
X-EC-Signature कसे तपासायचे?
हेडरचे t आणि v1 वेगळे करा, 5 मिनिटांपेक्षा जुना टाइमस्टॅम्प नाकारा, t, एक बिंदू आणि कच्चा बॉडी यांवर Page च्या स्वाक्षरी सीक्रेटने HMAC पुन्हा मोजा, आणि स्थिर वेळेत तुलना करा. Node.js मध्ये, बॉडी कच्च्या बाइट्स म्हणून ठेवून:
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 किंवा कोटेशनमध्ये गुंडाळणे. 200 ची बॉडी challenge ची किंमतच असायला हवी.
- JSON पार्सरनंतर HMAC मोजणे. पार्स करून पुन्हा सिरीयलाइज केल्याने बाइट्स बदलतात, आणि Meta पेलोड युनिकोड एस्केप केलेला असतानाच स्वाक्षरी करते, म्हणून कच्चा बॉडी हॅश करा.
- उत्तर देण्याआधी काम करणे. Messenger ला 5 सेकंदांत 200 हवे असते, आणि एक तास अपयश आल्यास ॲपची Page वरील सदस्यता रद्द होते.
- Meta च्या स्वाक्षरीची पुढे पाठवलेल्या इव्हेंटवर तपासणी करणे. Meta easyCoexistence च्या ॲप सीक्रेटने स्वाक्षरी करते; पुढे पाठवलेल्या इव्हेंटमध्ये X-EC-Signature असते, जी Page च्या स्वाक्षरी सीक्रेटने तपासली जाते.
प्रति कनेक्शन, दर महिना US$ 9 ते US$ 0.75, कनेक्शन वाढतील तसा दर कमी होत जातो, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
verify token कुठून येतो?
तो तुम्ही निवडता. App Dashboard मध्ये वेबहुक कॉन्फिगर करताना Verify Token फील्डमध्ये टाकलेली स्ट्रिंग, किंवा /{app-id}/subscriptions ला पाठवलेला verify_token, हाच तो.
curl ने पडताळणीची चाचणी करता येईल का?
हो. Meta च्या Messenger मार्गदर्शकात GET पाठवले जाते, ज्यात hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED आणि hub.mode=subscribe असतात, आणि कार्यरत एंडपॉइंट CHALLENGE_ACCEPTED ने उत्तर देतो.
माझा एंडपॉइंट एक तास अपयशी ठरला तर काय होईल?
Meta Webhooks Disabled अलर्ट पाठवते आणि ॲपची Page वरील सदस्यता रद्द करते. एंडपॉइंट दुरुस्त केल्यानंतर subscribed_apps द्वारे Page पुन्हा सबस्क्राइब करा.
Page चे वेबहुक मिळवण्यासाठी मला स्वतःचे Meta ॲप लागेल का?
easyCoexistence सह नाही. Meta त्याच्या ॲपवर डिलिव्हर करते, जे प्रत्येक Page चे इव्हेंट तुम्ही सेट केलेल्या एंडपॉइंटकडे पुढे पाठवते, X-EC-Signature ने स्वाक्षरी केलेले.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: