Facebook ওয়েবহুক যাচাইকরণ: hub.challenge ও X-Hub-Signature-256
Facebook একটি এন্ডপয়েন্ট যাচাই করে একটি GET রিকোয়েস্টের মাধ্যমে, যেখানে hub.mode থাকে subscribe-এ সেট, সঙ্গে hub.verify_token ও hub.challenge। এন্ডপয়েন্ট টোকেনটি অ্যাপ ড্যাশবোর্ডের টোকেনের সঙ্গে মিলিয়ে দেখে এবং চ্যালেঞ্জটিকে বডি হিসেবে ফেরত পাঠায়। এরপর প্রতিটি ইভেন্ট একটি POST হিসেবে আসে, যার X-Hub-Signature-256 হলো sha256= এর পরে পেলোডের HMAC-SHA256, যা অ্যাপ সিক্রেট দিয়ে তৈরি।
easyCoexistence আপনার সংযুক্ত প্রতিটি Page-এর জন্য Meta-র দিকটি সামলায়: এর অ্যাপ hub.challenge-এর উত্তর দেয়, X-Hub-Signature-256 যাচাই করে এবং Page-কে feed, messages ও mention-এ সাবস্ক্রাইব করে, তারপর ইভেন্টগুলো আপনার HTTPS এন্ডপয়েন্টে ফরোয়ার্ড করে, যা X-EC-Signature ও ওই Page-এর জন্য একটি সিক্রেট দিয়ে সাইন করা।
hub.mode-এর মান Meta-র যাচাইকরণ অনুরোধে সবসময় থাকে; hub.challenge একটি পূর্ণসংখ্যা, যা ফেরত পাঠাতে হয়।
X-Hub-Signature-256-এর প্রিফিক্স, তারপর Meta-র তৈরি SHA256 সিগনেচার, যা পেলোড ও অ্যাপ সিক্রেট থেকে হয়।
Messenger ওয়েবহুক এন্ডপয়েন্ট প্রতিটি নোটিফিকেশনের জবাবে কত দ্রুত 200 OK দেবে।
ব্যর্থ ডেলিভারির সংখ্যা, যার পরে ওয়েবহুক ডিসেবল্ড সতর্কবার্তা আসে এবং অ্যাপ Page থেকে আনসাবস্ক্রাইব হয়।
Meta ব্যর্থ Page নোটিফিকেশন কতক্ষণ ধরে ক্রমশ কম ঘনঘন আবার পাঠাবে, তারপর বাদ দেওয়ার আগে।
Meta-র যাচাইকরণ অনুরোধে কী থাকে?
কলব্যাক URL-এ একটি GET যায়, যখনই অ্যাপ ড্যাশবোর্ডে ওয়েবহুক কনফিগার করা হয় বা /{app-id}/subscriptions-এর মাধ্যমে সাবস্ক্রিপশন তৈরি হয়। সঙ্গে তিনটি কোয়েরি প্যারামিটার আসে:
- hub.mode: সবসময় subscribe।
- hub.challenge: একটি পূর্ণসংখ্যা, যা এন্ডপয়েন্টকে ফেরত পাঠাতে হয়।
- hub.
verify_token: ড্যাশবোর্ডের ভেরিফাই টোকেন ফিল্ডে দেওয়া স্ট্রিং। - PHP ডটগুলোকে আন্ডারস্কোরে বদলে দেয়, তাই এগুলো পড়া হয়
hub_mode,hub_challengeওhub_verify_tokenহিসেবে।
এন্ডপয়েন্ট এটির উত্তর কীভাবে দেবে?
একটি 200 উত্তর দিতে হয়, যার পুরো বডি হবে hub.challenge-এর মান। তবে এটি শুধু তখনই, যখন hub.mode হয় subscribe এবং hub.verify_token মেলে; বাকি সব ক্ষেত্রে 403 দিতে হয়, যেমন Meta-র নমুনা অ্যাপে। ড্যাশবোর্ড জানায় এন্ডপয়েন্ট পাস করেছে কিনা, এবং /{app-id}/subscriptions সফলতা বা ত্রুটি জানায়। এন্ডপয়েন্টে HTTPS লাগে, বৈধ TLS বা SSL সার্টিফিকেট সহ, কারণ সেলফ-সাইনড সার্টিফিকেট সমর্থিত নয়।
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 মিনিট ব্যর্থতার পরে, ডেভেলপারের অ্যাকাউন্টে একটি সতর্কবার্তা পৌঁছায়।
- এক ঘণ্টা ব্যর্থতার পরে একটি ওয়েবহুক ডিসেবল্ড সতর্কবার্তা আসে এবং অ্যাপটি আবার সাবস্ক্রাইব না করা পর্যন্ত Page থেকে আনসাবস্ক্রাইব থাকে।
- রিট্রাইয়ের ফলে একই ইভেন্ট দুইবার এবং এলোমেলো ক্রমে আসতে পারে, তাই ডুপ্লিকেট বাদ দিন এবং মেসেজগুলো তাদের টাইমস্ট্যাম্প অনুযায়ী সাজান।
- পরে অতীতের নোটিফিকেশন আর জিজ্ঞেস করা যায় না, তাই যা লাগবে তা আসার সঙ্গে সঙ্গে সংরক্ষণ করুন।
easyCoexistence কীভাবে Meta-র যাচাই পাস করে?
এর Meta অ্যাপে প্রতিটি সংযুক্ত Page-এর জন্য একটি কলব্যাক URL আছে, এবং ওই এন্ডপয়েন্ট নিজেই দুটো যাচাই করে। এটি GET-এর উত্তর দেয় শুধু যখন hub.mode হয় subscribe এবং ভেরিফাই টোকেন মেলে, ধ্রুবক সময়ে তুলনা করে; অন্যথায় 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 সেকেন্ড পর্যন্ত অপেক্ষা করে, রিডাইরেক্ট অনুসরণ না করে, এমন একটি HTTPS ঠিকানায় যা একটি পাবলিক IP-তে রিজলভ হয়।
- ইভেন্টের কোনো কপি রাখা হয় না, তাই এখান থেকে রিট্রাই করার কিছু নেই।
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-এর বডি হতে হবে চ্যালেঞ্জের মানটি নিজেই।
- JSON পার্সারের পরে HMAC হিসাব করা। পার্স ও পুনরায় সিরিয়ালাইজ করলে বাইট বদলে যায়, আর Meta পেলোডকে Unicode escape সহ সাইন করে, তাই কাঁচা বডি হ্যাশ করুন।
- উত্তর দেওয়ার আগে কাজ করা। Messenger 5 সেকেন্ডের মধ্যে 200 আশা করে, আর এক ঘণ্টা ব্যর্থতায় অ্যাপটি Page থেকে আনসাবস্ক্রাইব হয়ে যায়।
- ফরোয়ার্ড করা ইভেন্টে Meta-র সিগনেচার যাচাই। Meta easyCoexistence-এর অ্যাপ সিক্রেট দিয়ে সাইন করে; ফরোয়ার্ড করা ইভেন্টে থাকে X-EC-Signature, যা Page-এর সাইনিং সিক্রেট দিয়ে যাচাই করা হয়।
প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ যোগ করার সঙ্গে কমে, প্রথম 3 দিনের ফ্রি ট্রায়াল সহ।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
ভেরিফাই টোকেন কোথা থেকে আসে?
আপনি নিজে এটি ঠিক করেন। এটি সেই স্ট্রিং যা অ্যাপ ড্যাশবোর্ডে ওয়েবহুক কনফিগার করার সময় ভেরিফাই টোকেন ফিল্ডে লেখা হয়, অথবা /{app-id}/subscriptions-এ পাঠানো verify_token।
curl দিয়ে কি যাচাইকরণ পরীক্ষা করা যায়?
হ্যাঁ। Meta-র Messenger গাইড একটি GET পাঠায় যাতে থাকে hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED এবং hub.mode=subscribe, আর কাজ করা এন্ডপয়েন্ট CHALLENGE_ACCEPTED দিয়ে উত্তর দেয়।
এক ঘণ্টা ব্যর্থ হলে আমার এন্ডপয়েন্টের কী হবে?
Meta একটি ওয়েবহুক ডিসেবল্ড সতর্কবার্তা পাঠায় এবং অ্যাপটিকে Page থেকে আনসাবস্ক্রাইব করে। এন্ডপয়েন্ট ঠিক করার পরে, subscribed_apps-এর মাধ্যমে Page-টিকে আবার সাবস্ক্রাইব করুন।
একটি Page-এর ওয়েবহুক পেতে কি আমার নিজের Meta অ্যাপ লাগবে?
easyCoexistence-এ লাগে না। Meta ইভেন্ট পাঠায় তার নিজের অ্যাপে, যা প্রতিটি Page-এর ইভেন্ট আপনার সেট করা এন্ডপয়েন্টে ফরোয়ার্ড করে, X-EC-Signature দিয়ে সাইন করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে