Facebook வெப்ஹூக் சரிபார்ப்பு: hub.challenge மற்றும் X-Hub-Signature-256
Facebook, hub.mode subscribe ஆக அமைக்கப்பட்ட GET மூலம், hub.verify_token மற்றும் hub.challenge உடன் வெப்ஹூக் எண்ட்பாயிண்டைச் சரிபார்க்கிறது. எண்ட்பாயிண்ட் டோக்கனை App Dashboard-இல் உள்ளதுடன் ஒப்பிட்டு, hub.challenge மதிப்பை உடலாகத் திருப்பி அனுப்புகிறது. ஒவ்வொரு நிகழ்வும் X-Hub-Signature-256 மூலம் கையொப்பமிடப்பட்ட POST ஆக வருகிறது: sha256= என்பதைத் தொடர்ந்து, App Secret-ஐ விசையாகக் கொண்டு பேலோடின் HMAC-SHA256.
easyCoexistence நீங்கள் இணைக்கும் ஒவ்வொரு Page-க்கும் Meta-வின் பகுதியைக் கையாளுகிறது: அதன் செயலி hub.challenge-க்குப் பதிலளிக்கிறது, X-Hub-Signature-256 ஐ சரிபார்க்கிறது, Page-ஐ feed, மெசேஜ்கள் மற்றும் mention-க்கு சந்தா செய்கிறது, பின் நிகழ்வுகளை உங்கள் HTTPS எண்ட்பாயிண்டுக்கு X-EC-Signature மற்றும் அந்த Page-க்கான ரகசியத்துடன் கையொப்பமிட்டு அனுப்புகிறது.
hub.mode மதிப்பு Meta-வின் சரிபார்ப்பு கோரிக்கையில் எப்போதும் subscribe ஆக இருக்கும்; hub.challenge ஒரு முழு எண், அதைத் திருப்பி அனுப்ப வேண்டும்.
X-Hub-Signature-256 இன் முன்னொட்டு, அதைத் தொடர்ந்து பேலோடிலிருந்தும் App Secret-இலிருந்தும் Meta உருவாக்கும் SHA256 கையொப்பம்.
Messenger வெப்ஹூக் எண்ட்பாயிண்ட் ஒவ்வொரு அறிவிப்புக்கும் 200 OK உடன் எவ்வளவு விரைவாகப் பதிலளிக்க வேண்டும் என்பது.
Webhooks Disabled எச்சரிக்கைக்கும், செயலி Page-இலிருந்து சந்தா நீக்கப்படுவதற்கும் முன், தோல்வியடையும் டெலிவரிகளின் எண்ணிக்கை.
தோல்வியடைந்த Page அறிவிப்பை Meta எவ்வளவு நேரம், குறையும் அதிர்வெண்ணுடன் மீண்டும் முயற்சிக்கிறது, அதன் பின் அதை நீக்குவதற்கு முன்.
Meta-வின் சரிபார்ப்பு கோரிக்கையில் என்ன இருக்கும்?
callback URL-க்கு ஒரு GET, வெப்ஹூக்ஸ் தயாரிப்பு App Dashboard-இல் அமைக்கப்படும்போதோ அல்லது /{app-id}/subscriptions வழியாக சந்தா உருவாக்கப்படும்போதோ அனுப்பப்படும். அதனுடன் மூன்று வினவல் அளவுருக்கள் வரும்:
- hub.mode: எப்போதும் subscribe.
- hub.challenge: எண்ட்பாயிண்ட் திருப்பி அனுப்ப வேண்டிய ஒரு முழு எண்.
- hub.
verify_token: App Dashboard-இன் Verify Token புலத்தில் உள்ளிடப்பட்ட சரம். - PHP புள்ளிகளை அடிக்கோடுகளாக மாற்றுவதால், அவை
hub_mode,hub_challengeமற்றும்hub_verify_tokenஎன வாசிக்கப்படும்.
எண்ட்பாயிண்ட் அதற்கு எப்படிப் பதிலளிக்க வேண்டும்?
200 பதிலுடன், அதன் முழு உடலும் hub.challenge மதிப்பாக இருக்க வேண்டும்; ஆனால் hub.mode subscribe ஆகவும் hub.verify_token பொருந்தினால் மட்டுமே. வேறு எதுவானாலும் Meta-வின் மாதிரி செயலியில் உள்ளது போல 403 கிடைக்கும். டாஷ்போர்டு எண்ட்பாயிண்ட் தேறியதா என்று காட்டும், /{app-id}/subscriptions வெற்றி அல்லது பிழையுடன் பதிலளிக்கும். எண்ட்பாயிண்டுக்கு HTTPS தேவை, சரியான TLS அல்லது SSL சான்றிதழுடன்; செல்ஃப்-சைன்ட் சான்றிதழ்கள் ஆதரிக்கப்படாது.
X-Hub-Signature-256 எவ்வாறு கணக்கிடப்படுகிறது?
App Secret-ஐ விசையாகக் கொண்டு கோரிக்கை பேலோடின் HMAC-SHA256, sha256= என்பதன் பின் சிறிய எழுத்து hex ஆக எழுதப்படுகிறது. Meta-வின் Messenger வழிகாட்டி சேர்ப்பது: கையொப்பம் Unicode escape செய்யப்பட்ட பேலோடை உள்ளடக்கும், எனவே äöå போன்ற சரம் \u00e4\u00f6\u00e5 ஆகக் கருதப்படும். பெறப்பட்ட அப்படியே உள்ள மூல உடலை hash செய்யுங்கள், டிகோட் செய்த அல்லது மீண்டும் சீரியலைஸ் செய்த நகலை ஒருபோதும் வேண்டாம். சரிபார்ப்பு கட்டாயமில்லை என்று 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 வினாடிகளுக்குள். ஒரு டெலிவரிக்கு 1,000 புதுப்பிப்புகள் வரை தொகுக்கிறது, ஆனால் அதற்கு உத்தரவாதம் தராது, தோல்விகளை இவ்வாறு கையாளுகிறது:
- Page அறிவிப்புகள்: உடனடியாக மீண்டும் முயற்சி, பின் 36 மணி நேரத்தில் குறையும் அதிர்வெண்ணுடன் சில முறை மேலும், பின்னர் நீக்கப்படும்.
- Messenger அறிவிப்புகள்: உடனடியாகச் சில முறை மீண்டும் முயற்சி; 15 நிமிடத் தோல்விகளுக்குப் பிறகு, டெவலப்பர் கணக்குக்கு ஓர் எச்சரிக்கை செல்லும்.
- ஒரு மணி நேரத் தோல்விகளுக்குப் பிறகு Webhooks Disabled எச்சரிக்கை வரும், செயலி மீண்டும் சந்தா செய்யும் வரை Page-இலிருந்து சந்தா நீக்கப்படும்.
- மீண்டும் முயற்சிகள் ஒரு நிகழ்வை இரண்டு முறை, வரிசை மாறி வழங்கக்கூடும், எனவே நகல்களை நீக்குங்கள், மெசேஜ்களை அவற்றின் டைம்ஸ்டாம்ப் வரிசையில் வரிசைப்படுத்துங்கள்.
- பிந்தைய அறிவிப்புகளை பின்னர் வினவ முடியாது, எனவே வரும்போதே தேவையானதைச் சேமியுங்கள்.
easyCoexistence Meta-வின் சோதனைகளை எவ்வாறு கடக்கிறது?
அதன் Meta செயலிக்கு இணைக்கும் Page-களுக்கு ஒரே callback URL உண்டு, அந்த எண்ட்பாயிண்ட் இரண்டு சோதனைகளையும் தானே செய்கிறது. hub.mode subscribe ஆகவும் சரிபார்ப்பு டோக்கன் பொருந்தினால் மட்டுமே GET-க்குப் பதிலளிக்கிறது, நிலையான நேரத்தில் ஒப்பிடுகிறது, இல்லையெனில் 403 திருப்புகிறது. ஒவ்வொரு POST-ஐயும் மூல உரையாகப் படிக்கிறது, App Secret மூலம் X-Hub-Signature-256 ஐ மீண்டும் கணக்கிடுகிறது, பொருந்தாததை 401 உடன் நிராகரிக்கிறது, உடனே Meta-விற்குப் பதிலளித்து, பதிலுக்குப் பின் நிகழ்வைக் கையாளுகிறது.
easyCoexistence அது அனுப்புவதில் எவ்வாறு கையொப்பமிடுகிறது?
அதற்கென ஒரு கையொப்பத்துடன், ஏனெனில் Meta-வின் ஹெடரை easyCoexistence-இன் App Secret மூலம் மட்டுமே சரிபார்க்க முடியும், அது அனுப்பப்படுவதில்லை. எண்ட்பாயிண்ட் அமைக்கப்பட்ட இணைக்கப்பட்ட Page ஒவ்வொரு உள்ளீடும் JSON ஆக {platform, account_id, external_id, entry} என POST செய்யப்படும், 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 நிமிடத்துக்கு மேல் பழைய டைம்ஸ்டாம்ப்பை நிராகரியுங்கள், Page-இன் கையொப்ப ரகசியத்தால் t, ஒரு புள்ளி, மூல உடல் ஆகியவற்றின் மீது 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 parser-க்குப் பின் HMAC ஐக் கணக்கிடுவது. பாகுபடுத்தி மீண்டும் சீரியலைஸ் செய்தால் பைட்டுகள் மாறும்; Meta பேலோடை Unicode escape உடன் கையொப்பமிடுகிறது, எனவே மூல உடலை hash செய்யுங்கள்.
- பதிலளிக்கும் முன் வேலை செய்வது. Messenger 5 வினாடிகளுக்குள் 200 எதிர்பார்க்கிறது, ஒரு மணி நேரத் தோல்வி செயலியை Page-இலிருந்து சந்தா நீக்கும்.
- அனுப்பப்பட்ட நிகழ்வுகளில் Meta-வின் கையொப்பத்தைச் சரிபார்ப்பது. Meta easyCoexistence-இன் App Secret மூலம் கையொப்பமிடுகிறது; அனுப்பப்பட்ட நிகழ்வில் X-EC-Signature உள்ளது, அது Page-இன் கையொப்ப ரகசியத்தால் சரிபார்க்கப்படுகிறது.
ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகளைச் சேர்க்கும்போது குறையும், முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
Verify Token எங்கிருந்து வருகிறது?
நீங்களே தேர்வு செய்கிறீர்கள். இது App Dashboard-இல் வெப்ஹூக்குகளை அமைக்கும்போது 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 எச்சரிக்கை அனுப்பி, செயலியை Page-இலிருந்து சந்தா நீக்கும். எண்ட்பாயிண்டைச் சரிசெய்த பின், subscribed_apps மூலம் Page-ஐ மீண்டும் சந்தா செய்யுங்கள்.
ஒரு Page-இன் வெப்ஹூக்குகளைப் பெற எனக்கு சொந்த Meta செயலி தேவையா?
easyCoexistence உடன் தேவையில்லை. Meta தன் செயலிக்கு அனுப்பும், அது ஒவ்வொரு Page-இன் நிகழ்வுகளையும் நீங்கள் அமைத்த எண்ட்பாயிண்டுக்கு X-EC-Signature உடன் கையொப்பமிட்டு அனுப்பும்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: