لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

Facebook ویب ہک کی تصدیق: hub.challenge اور X-Hub-Signature-256

Facebook ایک GET درخواست کے ذریعے ویب ہک اینڈ پوائنٹ کی تصدیق کرتا ہے جس میں hub.mode کی قیمت subscribe ہوتی ہے، hub.verify_token اور hub.challenge ہوتے ہیں؛ اینڈ پوائنٹ ٹوکن کو ایپ ڈیش بورڈ میں موجود ٹوکن سے ملاتا ہے اور hub.challenge کو باڈی میں واپس بھیجتا ہے۔ اس کے بعد ہر ایونٹ ایک POST کے طور پر آتا ہے جس پر X-Hub-Signature-256 میں sha256= کے بعد پے لوڈ کا HMAC-SHA256 دستخط ہوتا ہے، جو ایپ سیکرٹ سے کلید بنایا جاتا ہے۔

easyCoexistence آپ کے جڑے ہر Page کے لیے Meta کی جانب کا کام سنبھالتا ہے: اس کی ایپ hub.challenge کا جواب دیتی ہے، X-Hub-Signature-256 چیک کرتی ہے، اور Page کو feed، میسجز اور mention کے لیے سبسکرائب کرتی ہے، پھر ایونٹس کو X-EC-Signature کے ساتھ اور اس Page کے سیکرٹ سے دستخط شدہ آپ کے HTTPS اینڈ پوائنٹ پر بھیجتی ہے۔

subscribe

hub.mode کی وہ قیمت جو Meta کی تصدیقی درخواست میں ہمیشہ آتی ہے؛ hub.challenge ایک عدد ہے جسے واپس بھیجنا ہے۔

sha256=

X-Hub-Signature-256 کا سابقہ sha256= ہے، جس کے بعد Meta کا بنایا ہوا SHA256 دستخط آتا ہے جو پے لوڈ اور ایپ سیکرٹ سے بنتا ہے۔

5 seconds

Messenger ویب ہک اینڈ پوائنٹ کو ہر اطلاع کا 200 OK کے ساتھ کتنی جلدی جواب دینا چاہیے۔

1 hour

ناکام ڈیلیوریز کی تعداد جس کے بعد Webhooks Disabled الرٹ آتا ہے اور ایپ Page سے ان سبسکرائب ہو جاتی ہے۔

36 hours

Meta کسی ناکام Page اطلاع کو کم ہوتی تعدد کے ساتھ کتنی دیر تک دوبارہ بھیجتا ہے، اس سے پہلے کہ اسے چھوڑ دے۔

Meta کی تصدیقی درخواست میں کیا ہوتا ہے؟

Webhooks پروڈکٹ جب بھی ایپ ڈیش بورڈ میں ترتیب دی جائے یا /{app-id}/subscriptions کے ذریعے سبسکرپشن بنائی جائے، تو کال بیک URL پر ایک GET بھیجا جاتا ہے۔ اس کے ساتھ تین کوئری پیرامیٹرز آتے ہیں:

  • 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 مماثل ہو؛ باقی ہر صورت میں Meta کے نمونہ ایپ کی طرح 403 جاتا ہے۔ ڈیش بورڈ بتاتا ہے کہ اینڈ پوائنٹ پاس ہوا یا نہیں، اور /{app-id}/subscriptions کامیابی یا خرابی کا جواب دیتا ہے۔ اینڈ پوائنٹ کو HTTPS کی ضرورت ہے جس کے پاس درست TLS یا SSL سرٹیفکیٹ ہو، کیونکہ خود دستخط شدہ سرٹیفکیٹ سپورٹ نہیں ہوتے۔

X-Hub-Signature-256 کیسے حساب کیا جاتا ہے؟

یہ ایپ سیکرٹ سے کلید بنائے گئے پے لوڈ کا HMAC-SHA256 ہوتا ہے، جو sha256= کے بعد چھوٹے حروف کے ہیکس میں لکھا جاتا ہے۔ Meta کی Messenger گائیڈ مزید بتاتی ہے کہ دستخط میں پے لوڈ Unicode escape کے ساتھ شامل ہوتا ہے، اس لیے äöå جیسی سٹرنگ \u00e4\u00f6\u00e5 شمار ہوتی ہے: خام باڈی کو ویسا ہی ہیش کریں جیسے وصول ہوئی، کبھی ڈی کوڈ یا دوبارہ سیریلائز کی ہوئی کاپی نہیں۔ Meta کہتا ہے کہ تصدیق اختیاری ہے مگر اس کی بھرپور سفارش کرتا ہے۔

کوڈ میں اس کی جانچ کیسے کریں؟

خام بائٹس رکھیں، HMAC نکالیں، مستقل وقت میں موازنہ کریں، پھر پارس کریں۔ Flask کا get_data باڈی کو جوں کا توں لوٹاتا ہے، اور دستخط اسی پر حساب ہوا تھا؛ پہلے پارس کرنا اور پھر دوبارہ سیریلائز کرنا بائٹس بدل دیتا ہے۔ ایک چھوٹا اینڈ پوائنٹ جو تصدیق کا جواب دیتا ہے اور ہر POST کی جانچ کرتا ہے:

Python: hub.challenge and X-Hub-Signature-256
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 ہے، اور وہ اینڈ پوائنٹ دونوں جانچیں خود کرتا ہے۔ 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 سیکنڈ انتظار کے ساتھ، ری ڈائریکٹ کی پیروی کیے بغیر، ایسے HTTPS پتے پر جو عوامی IP پر حل ہو۔
  • ایونٹ کی کوئی کاپی نہیں رکھی جاتی، اس لیے دوبارہ کوشش کے لیے کچھ نہیں ہوتا۔

X-EC-Signature کی تصدیق کیسے کریں؟

ہیڈر کو t اور v1 میں تقسیم کریں، پانچ منٹ سے زیادہ پرانا ٹائم اسٹیمپ رد کریں، Page کے دستخطی سیکرٹ سے t، ڈاٹ اور خام باڈی پر HMAC دوبارہ نکالیں، اور مستقل وقت میں موازنہ کریں۔ Node.js میں، باڈی کو خام بائٹس کے طور پر رکھتے ہوئے:

Node.js: checking X-EC-Signature on a forwarded event
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 کے دستخطی سیکرٹ سے چیک کیا جاتا ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ، جیسے جیسے آپ کنکشن شامل کرتے ہیں کم ہوتی جاتی ہے، پہلے 3 دن مفت۔

اکثر پوچھے جانے والے سوالات

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 سے دستخط شدہ۔

مزید پڑھیں

Facebook پیج کو ویب ہکس کے لیے سبسکرائب کرنا: subscribed_apps ایجPOST /{page-id}/subscribed_apps سے Facebook پیج کو ویب ہک فیلڈز کے لیے سبسکرائب کرنا: ٹوکن، ٹاسک، ایپ سطح کی سبسکرپشن، چیک اور ہٹانا۔Facebook Page ویب ہک فیلڈز: مکمل فہرستMeta کی دستاویز کردہ 64 Facebook Page ویب ہک فیلڈز: feed، mention، messages جیسے Messenger فیلڈز، پروفائل فیلڈز، اور ہر ایک کی درکار اجازت۔Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹسFacebook Page کے لیے Messenger میسجز اور منشنز کی ویب ہک فیلڈز: پے لوڈ کا ڈھانچہ، سینڈر آئی ڈیز، اور ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔Facebook Page feed ویب ہک: کمنٹس، پوسٹس اور ری ایکشنز کے ایونٹسFacebook Page فیڈ ویب ہک کیا بھیجتا ہے: کمنٹس، پوسٹس اور ری ایکشنز، آئٹم اور ورب فیلڈز، میٹا کا پے لوڈ ڈھانچہ، اور Page کیسے سبسکرائب کرتا ہے۔Facebook Page ایکسیس ٹوکن: کتنی دیر چلتا ہے اور کیا اسے بے اثر کرتا ہےFacebook Page کا ایکسیس ٹوکن جس کی میعاد ختم نہیں ہوتی: اسے کیسے حاصل کیا جاتا ہے، کون اسے حاصل کر سکتا ہے، اور Meta کب اسے قبول نہیں کرتا۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ