Facebook వెబ్హుక్ ధృవీకరణ: hub.challenge మరియు X-Hub-Signature-256
Facebook ఒక వెబ్హుక్ ఎండ్పాయింట్ను ధృవీకరిస్తుంది: hub.mode subscribe గా, hub.verify_token మరియు hub.challenge తో కూడిన GET అభ్యర్థన పంపుతుంది; ఎండ్పాయింట్ టోకెన్ను App Dashboard లో ఉన్న దానితో పోల్చి, challenge ను బాడీగా తిరిగి ఇస్తుంది. ఆ తర్వాత ప్రతి ఈవెంట్ X-Hub-Signature-256 లో సంతకం చేసిన POST గా వస్తుంది: sha256= తర్వాత పేలోడ్ యొక్క HMAC-SHA256, యాప్ సీక్రెట్తో కీ చేయబడింది.
easyCoexistence మీరు కనెక్ట్ చేసే ప్రతి Page కు Meta వైపు నిర్వహిస్తుంది: దాని యాప్ hub.challenge కు స్పందిస్తుంది, X-Hub-Signature-256 ను తనిఖీ చేస్తుంది, Page ను feed, messages మరియు mention కు సబ్స్క్రైబ్ చేస్తుంది, తర్వాత ఈవెంట్లను మీ HTTPS ఎండ్పాయింట్కు ఫార్వర్డ్ చేస్తుంది, X-EC-Signature మరియు ఆ Page కోసం సీక్రెట్తో సంతకం చేసి.
Meta యొక్క ధృవీకరణ అభ్యర్థనలో hub.mode ఎల్లప్పుడూ కలిగి ఉండే విలువ; hub.challenge అనేది తిరిగి పంపాల్సిన పూర్ణ సంఖ్య.
X-Hub-Signature-256 యొక్క ఉపసర్గ, తర్వాత Meta పేలోడ్ మరియు App Secret నుండి రూపొందించిన SHA256 సంతకం.
Messenger వెబ్హుక్ ఎండ్పాయింట్ ప్రతి నోటిఫికేషన్కు 200 OK తో ఎంత త్వరగా స్పందించాలి.
Webhooks Disabled హెచ్చరికకు ముందు ఎన్ని విఫల డెలివరీలు జరుగుతాయి, అప్పుడు యాప్ Page నుండి అన్సబ్స్క్రైబ్ అవుతుంది.
Meta విఫలమైన Page నోటిఫికేషన్ను ఎంత సేపు, తగ్గుతున్న ఫ్రీక్వెన్సీతో తిరిగి ప్రయత్నిస్తుంది, తర్వాత వదిలేస్తుంది.
Meta యొక్క ధృవీకరణ అభ్యర్థనలో ఏముంటుంది?
కాల్బ్యాక్ URL కు GET అభ్యర్థన వెళుతుంది; Webhooks ఉత్పత్తి App Dashboard లో కాన్ఫిగర్ చేసినప్పుడు, లేదా /{app-id}/subscriptions ద్వారా సబ్స్క్రిప్షన్ సృష్టించినప్పుడల్లా ఇది పంపబడుతుంది. దానితో మూడు క్వెరీ పారామీటర్లు వస్తాయి:
- hub.mode: ఎల్లప్పుడూ subscribe.
- hub.challenge: ఎండ్పాయింట్ తిరిగి పంపాల్సిన పూర్ణ సంఖ్య.
- hub.
verify_token: డాష్బోర్డ్ లోని Verify Token ఫీల్డ్లో నమోదు చేసిన స్ట్రింగ్. - PHP చుక్కలను అండర్స్కోర్లుగా మారుస్తుంది, కాబట్టి అది వీటిని
hub_mode,hub_challengeమరియుhub_verify_tokenగా చదువుతుంది.
ఎండ్పాయింట్ దానికి ఎలా స్పందించాలి?
బాడీ మొత్తం hub.challenge విలువగా ఉండే 200 తో, కానీ hub.mode subscribe అయి, hub.verify_token సరిపోలినప్పుడు మాత్రమే; మిగతావన్నీ Meta నమూనా యాప్లో ఉన్నట్లుగా 403 పొందుతాయి. ధృవీకరణ పాసైందో లేదో డాష్బోర్డ్ చూపిస్తుంది, మరియు /{app-id}/subscriptions విజయం లేదా లోపంతో స్పందిస్తుంది. ఎండ్పాయింట్కు చెల్లుబాటు అయ్యే TLS లేదా SSL సర్టిఫికెట్తో HTTPS అవసరం, ఎందుకంటే సెల్ఫ్-సైన్డ్ సర్టిఫికెట్లకు మద్దతు లేదు.
X-Hub-Signature-256 ఎలా లెక్కించబడుతుంది?
అభ్యర్థన పేలోడ్ యొక్క HMAC-SHA256, యాప్ యొక్క App Secret తో కీ చేయబడి, sha256= తర్వాత చిన్న అక్షరాల హెక్స్లో రాయబడుతుంది. Meta యొక్క Messenger గైడ్ జోడిస్తుంది, ఈ సంతకం Unicode escape చేయబడిన పేలోడ్ను కవర్ చేస్తుంది, కాబట్టి äöå వంటి స్ట్రింగ్ \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 కోసం ఒకే కాల్బ్యాక్ URL ఉంది, మరియు ఆ ఎండ్పాయింట్ రెండు తనిఖీలనూ స్వయంగా చేస్తుంది. hub.mode subscribe అయి, ధృవీకరణ టోకెన్ సరిపోలినప్పుడు మాత్రమే GET కు స్పందిస్తుంది, స్థిర సమయంలో పోల్చి, లేకపోతే 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_ తో మొదలవుతుంది మరియు ఒకసారి మాత్రమే చూపబడుతుంది; Partner API పై
set_social_webhook_destinationలేదా 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 పేలోడ్ను Unicode escape చేసి సంతకం చేస్తుంది, కాబట్టి రా బాడీని హ్యాష్ చేయండి.
- స్పందించే ముందు పని చేయడం. Messenger 5 సెకన్లలోపు 200 ఆశిస్తుంది, మరియు ఒక గంట వైఫల్యాలు యాప్ను Page నుండి అన్సబ్స్క్రైబ్ చేస్తాయి.
- ఫార్వర్డ్ చేసిన ఈవెంట్లపై Meta సంతకాన్ని తనిఖీ చేయడం. Meta easyCoexistence యాప్ సీక్రెట్తో సంతకం చేస్తుంది; ఫార్వర్డ్ చేసిన ఈవెంట్లో X-EC-Signature ఉంటుంది, అది Page యొక్క సంతకం సీక్రెట్తో తనిఖీ చేయబడుతుంది.
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లను జోడించే కొద్దీ తగ్గుతూ, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
ధృవీకరణ టోకెన్ ఎక్కడి నుండి వస్తుంది?
మీరే ఎంచుకుంటారు. ఇది 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 పర్యవేక్షణ
ధృవీకరించిన తేదీ