Facebook वेबहुक प्रमाणीकरण: hub.challenge र X-Hub-Signature-256
Facebook ले वेबहुक एन्डपोइन्टलाई GET अनुरोधमा hub.mode को मान subscribe, hub.verify_token र hub.challenge सहित प्रमाणित गर्छ। एन्डपोइन्टले टोकनलाई App Dashboard मा भएकोसँग मिलाउँछ र challenge लाई बडीमा फर्काउँछ। त्यसपछि हरेक इभेन्ट POST का रूपमा आउँछ, जसको X-Hub-Signature-256 मा sha256= लेखिएको हुन्छ, र त्यसपछि पेलोडको HMAC-SHA256 हुन्छ, जुन app secret बाट बनाइएको हुन्छ।
easyCoexistence ले तपाईंले जडान गर्ने हरेक Page का लागि Meta को पक्ष सम्हाल्छ: यसको एपले hub.challenge को प्रतिक्रिया दिन्छ, X-Hub-Signature-256 जाँच्छ, र Page लाई feed, म्यासेज र mention मा सदस्यता दिन्छ, त्यसपछि इभेन्टहरू तपाईंको HTTPS एन्डपोइन्टमा X-EC-Signature र त्यस Page को लागि सिक्रेटसहित हस्ताक्षरित पठाउँछ।
hub.mode सधैँ Meta को प्रमाणीकरण अनुरोधमा आउने मान हो; hub.challenge फर्काउनु पर्ने पूर्णांक हो।
X-Hub-Signature-256 को उपसर्ग, जसपछि Meta ले पेलोड र App Secret बाट बनाएको SHA256 हस्ताक्षर आउँछ।
Messenger वेबहुक एन्डपोइन्टले हरेक सूचनाको प्रतिक्रिया कति छिटो 200 OK सहित दिनुपर्छ।
असफल डेलिभरी कति भएपछि Webhooks Disabled अलर्ट आउँछ र एपको Page बाट सदस्यता रद्द हुन्छ।
Meta ले असफल Page सूचना कति समयसम्म, घट्दो आवृत्तिमा, पुनः प्रयास गर्छ र त्यसपछि हटाउँछ।
Meta को प्रमाणीकरण अनुरोधमा के हुन्छ?
Webhooks उत्पादन App Dashboard मा कन्फिगर गर्दा वा /{app-id}/subscriptions मार्फत सदस्यता बनाउँदा कलब्याक यूआरएलमा GET पठाइन्छ। यसमा तीन query प्यारामिटर आउँछन्:
- hub.mode: सधैँ subscribe हुन्छ।
- hub.challenge: फर्काउनु पर्ने एउटा पूर्णांक।
- hub.
verify_token: App Dashboard को Verify Token फिल्डमा राखिएको स्ट्रिङ। - PHP ले डटहरूलाई अन्डरस्कोरमा बदल्छ, त्यसैले तिनलाई
hub_mode,hub_challengeरhub_verify_tokenरूपमा पढ्छ।
एन्डपोइन्टले यसको प्रतिक्रिया कसरी दिनुपर्छ?
सम्पूर्ण बडी hub.challenge को मान भएको 200 प्रतिक्रिया दिइन्छ, तर केवल hub.mode subscribe हुँदा र hub.verify_token मिल्दा मात्र। अरू जुनसुकै अवस्थामा 403 फर्काइन्छ, Meta को नमुना एपमा जस्तै। App Dashboard ले एन्डपोइन्ट उत्तीर्ण भयो वा भएन भनेर देखाउँछ, र /{app-id}/subscriptions ले सफल वा त्रुटि फर्काउँछ। एन्डपोइन्टमा मान्य TLS वा SSL प्रमाणपत्रसहित HTTPS चाहिन्छ, किनकि सेल्फ-साइन्ड प्रमाणपत्र समर्थित छैन।
X-Hub-Signature-256 कसरी गणना गरिन्छ?
यो पेलोडको HMAC-SHA256 हो, जुन app को App Secret सँग कुञ्जीकृत हुन्छ, र sha256= पछि lowercase hex मा लेखिन्छ। 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 एपमा जडान गर्ने Page हरूका लागि एउटै कलब्याक यूआरएल हुन्छ, र त्यो एन्डपोइन्टले दुवै जाँच आफैँ गर्छ। यसले GET मा तब मात्र प्रतिक्रिया दिन्छ जब hub.mode subscribe हुन्छ र hub.verify_token मिल्छ, स्थिर समयमा तुलना गरिएको; अन्यथा 403 फर्काउँछ। यसले हरेक POST लाई raw text रूपमा पढ्छ, आफ्नो app secret सँग X-Hub-Signature-256 पुनः गणना गर्छ, मेल नखाएमा 401 सहित अस्वीकार गर्छ, र प्रतिक्रिया पछि इभेन्ट प्रशोधन गर्दै Meta लाई तुरुन्तै उत्तर दिन्छ।
easyCoexistence ले आफूले फर्वार्ड गर्ने कुरामा कसरी हस्ताक्षर गर्छ?
आफ्नै हस्ताक्षरसहित, किनकि Meta को हेडर केवल easyCoexistence को app secret सँग जाँच्न सकिन्छ र अगाडि पठाइँदैन। जडान गरिएको र endpoint सेट भएको हरेक Page को प्रविष्टि {platform, account_id, external_id, entry} सहित JSON को रूपमा त्यहाँ POST गरिन्छ, साथमा X-EC-Signature हेडर t=<unix>,v1=<hex> फर्म्याटमा हुन्छ। यहाँ v1 भनेको timestamp, एउटा डट र raw body को HMAC-SHA256 हो, जुन त्यस Page को signing secret सँग कुञ्जीकृत हुन्छ:
- सिक्रेट whsec_ बाट सुरु हुन्छ र
set_social_webhook_destinationवा Partner API मा PUT /channels/:id/webhook बाट एकपटक देखाइन्छ। - URL फेरि सेट गर्दा नयाँ सिक्रेट जारी हुन्छ, र null URL ले फर्वार्डिङ बन्द गर्छ।
- हरेक फर्वार्ड एकपटक पठाइन्छ, 8 सेकेन्डसम्म पर्खिएर, रिडाइरेक्ट नपछ्याइकन, र सार्वजनिक IP मा समाधान हुने HTTPS ठेगानामा।
- इभेन्टको कुनै प्रतिलिपि राखिँदैन, त्यसैले पुनः प्रयास गर्न केही हुँदैन।
X-EC-Signature कसरी प्रमाणित गर्ने?
हेडरलाई t र v1 मा विभाजन गर्नुहोस्, 5 मिनेटभन्दा पुरानो timestamp अस्वीकार गर्नुहोस्, Page को signing secret सँग t, डट र raw body माथि HMAC पुनः गणना गर्नुहोस्, र स्थिर समयमा तुलना गर्नुहोस्। 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 वा उद्धरण चिन्हमा बेर्नु। 200 को बडी challenge को मान नै हुनुपर्छ।
- JSON पार्सर पछि HMAC गणना गर्नु। पार्स र पुनः सिरियलाइज गर्दा बाइट बदलिन्छ, र Meta ले पेलोड यूनिकोड इस्केपसहित हस्ताक्षर गर्छ, त्यसैले raw body ह्यास गर्नुहोस्।
- उत्तर दिनुअघि काम गर्नु। Messenger ले 5 सेकेन्डभित्र 200 अपेक्षा गर्छ, र एक घण्टाको असफलताले एपलाई Page बाट सदस्यता रद्द गर्छ।
- फर्वार्ड गरिएका इभेन्टमा Meta को हस्ताक्षर जाँच्नु। Meta ले easyCoexistence को app secret सँग हस्ताक्षर गर्छ; फर्वार्ड गरिएको इभेन्टमा X-EC-Signature हुन्छ, जुन Page को signing secret सँग जाँचिन्छ।
US$ 9 देखि US$ 0.75 सम्म प्रति कनेक्सन प्रति महिना, कनेक्सन थप्दै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
hub.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 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको