Instagram ویب ہک تصدیق: hub.challenge اور X-Hub-Signature-256
Instagram ویب ہکس سیٹ اپ کرنے کے لیے ایک HTTPS اینڈ پوائنٹ درکار ہے جو Meta کی تصدیقی GET درخواست کا جواب دے۔ اس درخواست میں hub.mode کی قدر subscribe، hub.verify_token اور hub.challenge ہوتے ہیں۔ اینڈ پوائنٹ ٹوکن جانچ کر challenge واپس کرتا ہے۔ اس کے بعد، جب ایپ فیلڈز سبسکرائب کر لے اور ہر اکاؤنٹ اپنے subscribed_apps ایج کے ذریعے سبسکرائب ہو جائے، Meta ایپ کے secret سے X-Hub-Signature-256 میں دستخط شدہ JSON ایونٹس بھیجتا ہے۔
easyCoexistence Meta کا حصہ سنبھالتا ہے: اس کی ایپ تصدیق پاس کرتی ہے، X-Hub-Signature-256 جانچتی ہے، ہر منسلک Instagram اکاؤنٹ کو comments، messages اور mentions کے لیے سبسکرائب کرتی ہے، اور ایونٹس کو X-EC-Signature کے ساتھ اور ہر اکاؤنٹ کے لیے الگ secret کے ساتھ دستخط شدہ کر کے آپ کے HTTPS اینڈ پوائنٹ پر فارورڈ کرتی ہے، جبکہ ہر کنکشن پر چوبیس گھنٹے نظر رکھتی ہے۔
Meta کی تصدیقی درخواست میں hub.mode کی قدر ہمیشہ موجود ہوتی ہے۔
وہ مدت جس کے دوران Meta ناکام اطلاع کو کم ہوتے وقفوں کے ساتھ دوبارہ بھیجتا ہے، پھر اسے چھوڑ دیتا ہے۔
ناکام میسج ڈیلیوریز کی تعداد جس کے بعد Meta ڈیولپر اکاؤنٹ کو الرٹ بھیجتا ہے۔
ناکام میسج ڈیلیوریز کی تعداد جس کے بعد Webhooks Disabled الرٹ آتا ہے اور ایپ کی اس اکاؤنٹ سے سبسکرپشن ختم ہو جاتی ہے۔
وہ ایپ موڈ جو Meta کو درکار ہے، اس سے پہلے کہ ایپ اپنے صارفین کے اکاؤنٹس کی اطلاعات وصول کرے۔
Instagram ویب ہکس کا سیٹ اپ کیسے کام کرتا ہے؟
Meta کی گائیڈ کی ترتیب کے مطابق چار مراحل میں۔ اینڈ پوائنٹ کو کوئی بھی فیلڈ منتخب کرنے سے پہلے تصدیق پاس کرنی ہوگی، ایپ کو اپنے صارفین کے اکاؤنٹس کی اطلاعات وصول کرنے کے لیے Live ہونا ضروری ہے، اور پروڈکشن رسائی کے لیے کاروباری تصدیق درکار ہے۔
تصدیقی درخواست میں کیا ہوتا ہے؟
کال بیک URL پر ایک GET درخواست، جو جب بھی App Dashboard میں Webhooks پروڈکٹ ترتیب دیا جائے بھیجی جاتی ہے۔ اگر hub.verify_token اینڈ پوائنٹ کے اپنے ٹوکن سے مل جائے تو جواب 200 ہوتا ہے، جس کی پوری باڈی hub.challenge کی قدر ہوتی ہے؛ ورنہ 403۔ ڈیش بورڈ بتاتا ہے کہ اینڈ پوائنٹ نے تصدیق پاس کی یا نہیں۔
- hub.mode: ہمیشہ subscribe ہوتا ہے۔
- hub.challenge: ایک integer جو Meta بناتا ہے، جسے اینڈ پوائنٹ کو واپس بھیجنا ہوتا ہے۔
- hub.
verify_token: وہ string جو ڈیش بورڈ کے Verify Token فیلڈ میں درج ہوتی ہے، جسے صرف Meta اور اینڈ پوائنٹ جانتے ہوں۔ - PHP میں ان ناموں کے ڈاٹ زیر خط بن جاتے ہیں، یوں قدریں
hub_mode،hub_challengeاورhub_verify_tokenکے طور پر پہنچتی ہیں۔
GET https://<YOUR_HOST>/webhooks/instagram
?hub.mode=subscribe
&hub.challenge=1158201444
&hub.verify_token=<YOUR_VERIFY_TOKEN>
HTTP/1.1 200 OK
Content-Type: text/plain
1158201444کال بیک اور فیلڈز کہاں سیٹ ہوتے ہیں؟
App Dashboard میں، Instagram کے تحت، API setup with Instagram login، Configure webhooks میں: کال بیک URL اور verify token وہاں درج ہوتے ہیں، اور انہیں محفوظ کرنے سے تصدیقی درخواست شروع ہو جاتی ہے۔ Instagram پروڈکٹ comments، live_comments، message_reactions، messages، messaging_optins، messaging_postbacks، messaging_referral اور messaging_seen کے ساتھ سبسکرائب شدہ حالت میں شروع ہوتا ہے، اور Manage کے ذریعے ان میں سے کسی بھی فیلڈ کی سبسکرپشن ختم کی جا سکتی ہے۔ Test بٹن منتخب فیلڈ کے لیے ایک نمونہ اطلاع بھیجتا ہے۔
X-Hub-Signature-256 کی جانچ کیسے ہوتی ہے؟
Meta ہر ایونٹ اطلاع پر پے لوڈ کا HMAC-SHA256 بناتا ہے، جسے ایپ کے secret سے کلید بنایا جاتا ہے، اور اسے X-Hub-Signature-256 ہیڈر میں sha256= کے بعد hex digest کی شکل میں بھیجتا ہے۔ وصول کنندہ خام درخواست باڈی پر وہی HMAC حساب کرتا ہے اور اسے constant time میں ہیڈر کے ساتھ موازنہ کرتا ہے۔ Meta کی میسجنگ گائیڈ بتاتی ہے کہ دستخط میں Unicode escaped ہونے کی حالت شامل ہے، اس لیے ڈی کوڈ شدہ یا دوبارہ سیریلائز شدہ JSON کا ہیش مختلف نتیجہ دیتا ہے۔
import crypto from "node:crypto";
import express from "express";
const app = express();
const { VERIFY_TOKEN, APP_SECRET } = process.env;
// Verification request: send hub.challenge back when the token matches
app.get("/webhooks/instagram", (req, res) => {
const ok = req.query["hub.mode"] === "subscribe" &&
req.query["hub.verify_token"] === VERIFY_TOKEN;
if (!ok) return res.sendStatus(403);
res.status(200).type("text/plain").send(req.query["hub.challenge"]);
});
// Event notification: check the signature over the raw bytes
app.post("/webhooks/instagram", express.raw({ type: "application/json" }), (req, res) => {
const expected = Buffer.from(
"sha256=" + crypto.createHmac("sha256", APP_SECRET).update(req.body).digest("hex")
);
const given = Buffer.from(req.get("X-Hub-Signature-256") ?? "");
if (given.length !== expected.length || !crypto.timingSafeEqual(given, expected)) {
return res.sendStatus(401);
}
res.sendStatus(200); // answer first, work after
const body = JSON.parse(req.body.toString("utf8"));
// hand body.entry to a queue or background job
});
app.listen(3000);صرف ایپ کا secret ہی اسے کیوں جانچ سکتا ہے؟
کیونکہ دستخط ایک HMAC ہے جو اسی secret سے کلید بنایا جاتا ہے۔ اس کے بغیر کوئی متوقع قدر حساب نہیں کر سکتا، اور پے لوڈ کی نقل رکھنے والا بھی کوئی جعلی نہیں بنا سکتا، اس لیے جانچ اس سرور پر ہونی چاہیے جو ایپ کے لیے Meta کی درخواستیں وصول کرتا ہے۔ Meta درخواست کرتا ہے کہ ایپ secrets، access ٹوکنز اور client credentials لاگز اور سپورٹ درخواستوں سے باہر رکھے جائیں۔ وہ سسٹم جو کسی دوسری ایپ کے بھیجے ہوئے ایونٹس وصول کرتا ہے، Meta کا دستخط بالکل نہیں جانچ سکتا، اور اس کے بجائے اس ایپ کے اپنے دستخط پر انحصار کرتا ہے۔
ہر اکاؤنٹ کو اپنی الگ سبسکرپشن کیوں چاہیے؟
کیونکہ App Dashboard یہ طے کرتا ہے کہ ایپ کیا وصول کر سکتی ہے، اور کسی اکاؤنٹ کی اطلاعات تب ہی شروع ہوتی ہیں جب وہ اکاؤنٹ بھی سبسکرائب ہو۔ Instagram Login کے ساتھ graph.instagram.com پر POST /<IG_ID>/subscribed_apps بھیجیں، جس میں اکاؤنٹ کا Instagram User access ٹوکن ہو اور subscribed_fields میں ایپ کے لیے منتخب فیلڈز کامے سے الگ کر کے درج ہوں۔ کامیاب کال success کو true کے طور پر واپس کرتی ہے۔
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }ڈیلیوری ناکام ہونے پر Meta کیا کرتا ہے؟
Meta دوبارہ کوشش کرتا ہے، پھر ہار مان لیتا ہے۔ Meta کی گائیڈ ہر اطلاع پر 200 OK کا تقاضا کرتی ہے اور خبردار کرتی ہے کہ 1,000 اپ ڈیٹس تک کی بیچنگ کی ضمانت نہیں۔ ناکام اپ ڈیٹ فوراً دوبارہ بھیجی جاتی ہے، پھر 36 گھنٹوں میں کم ہوتے وقفوں سے چند مزید بار، اور اس کے بعد چھوڑ دی جاتی ہے، اس لیے ایک ہی ایونٹ دو بار بھی پہنچ سکتا ہے۔ میسجنگ ایونٹس Meta کے میسجنگ ڈیلیوری اصولوں پر چلتے ہیں، جو زیادہ تیزی سے عمل کرتے ہیں:
- 200 OK پانچ سیکنڈ میں متوقع ہے، اور ناکام ڈیلیوری کو چند فوری دوبارہ کوششیں ملتی ہیں، اس لیے میسج mid کی بنیاد پر ڈپلیکیٹ ہٹائیں۔
- پندرہ منٹ کی ناکامی کے بعد ڈیولپر اکاؤنٹ کو الرٹ بھیجا جاتا ہے۔
- ایک گھنٹے کی ناکامی کے بعد Webhooks Disabled الرٹ آتا ہے، اور ایپ اکاؤنٹ کے ویب ہکس سے سبسکرپشن ختم کر دیتی ہے، جب تک وہ دوبارہ سبسکرائب نہ کرے۔
- آؤٹیج کے دوران بھیجے گئے میسجز غلط ترتیب میں پہنچ سکتے ہیں، اس لیے انہیں ٹائم اسٹیمپ کے مطابق ترتیب دیں۔
کچھ موصول نہ ہو تو کیا جانچنا چاہیے؟
Meta کی ٹربل شوٹنگ چیک لسٹ، جو زیادہ تر خاموش اینڈ پوائنٹس کا احاطہ کرتی ہے، اس ترتیب میں:
- کال بیک URL تصدیق پاس کر چکا ہو اور HTTPS پر معتبر سرٹیفکیٹ کے ساتھ قابلِ رسائی ہو؛ خود دستخط شدہ سرٹیفکیٹ سپورٹڈ نہیں ہیں۔
- ایپ نے فیلڈ منتخب کیا ہو اور اسے درکار رسائی کی سطح ہو، یعنی comments اور
live_commentsکے لیے Advanced Access۔ - اکاؤنٹ کے لیے اطلاعات
subscribed_appsکے ذریعے فعال ہوں، اور ٹوکن اسی لاگ ان سیٹ اپ سے ہو۔ - اکاؤنٹ فیلڈ کے اصولوں پر پورا اترے: کمنٹ اطلاعات کے لیے پبلک اکاؤنٹ کا ملکیتی میڈیا درکار ہے۔
- سرور سست کام شروع کرنے سے پہلے success واپس کرے۔
easyCoexistence فارورڈ ہونے والے ایونٹس پر دوبارہ دستخط کیوں کرتا ہے؟
کیونکہ Meta کا دستخط منتقل نہیں ہو سکتا۔ easyCoexistence کی ایپ Meta کی ڈیلیوری وصول کرتی ہے، اپنے ایپ secret سے X-Hub-Signature-256 جانچتی ہے، فوراً Meta کو جواب دیتی ہے، اور ہر منسلک اکاؤنٹ کی entry کو اس اکاؤنٹ کے لیے مقررہ اینڈ پوائنٹ پر platform، account_id، external_id اور entry پر مشتمل نئی باڈی میں POST کرتی ہے۔ Meta کا ہیڈر آگے نہیں بھیجا جاتا اور اس secret کے بغیر جانچا نہیں جا سکتا، اس لیے ہر فارورڈ کے ساتھ Content-Type: application/json اور X-EC-Signature جاتا ہے، جو اسی ایک اکاؤنٹ سے وابستہ secret سے کلید بنایا جاتا ہے۔
X-EC-Signature کی تصدیق کیسے کریں؟
ہیڈر t=<unix>,v1=<hex> کی شکل میں ہوتا ہے، جہاں v1 ٹائم اسٹیمپ، ایک ڈاٹ اور خام باڈی کا hex HMAC-SHA256 ہے، جسے اکاؤنٹ کے دستخطی secret سے کلید بنایا گیا ہو۔ باڈی کو ویسے ہی دوبارہ حساب کریں جیسے موصول ہوئی، constant time میں موازنہ کریں، اور پانچ منٹ سے پرانا ٹائم اسٹیمپ رد کریں۔
- secret whsec_ سے شروع ہوتا ہے اور صرف ایک بار دکھایا جاتا ہے، جب URL سیٹ ہو تو
set_social_webhook_destinationیا PUT /channels/:id/webhook کے ذریعے۔ - URL دوبارہ سیٹ کرنے سے نیا secret جاری ہوتا ہے، اور null URL فارورڈنگ بند کر دیتا ہے۔
- ہر ایونٹ ایک بار بھیجا جاتا ہے، 8 سیکنڈ تک انتظار کرتا ہے، ری ڈائریکٹ فالو کیے بغیر، ایک HTTPS پتے پر جو عوامی IP پر حل ہوتا ہو۔
- کنکشن ہٹانے سے اکاؤنٹ Meta کے ویب ہکس سے سبسکرپشن ختم ہو جاتی ہے اور اس کا اینڈ پوائنٹ اور secret صاف ہو جاتے ہیں۔
import hashlib, hmac, time
def verify_ec_signature(raw_body: bytes, header: str, secret: str) -> bool:
"""Check X-EC-Signature on an event forwarded by easyCoexistence."""
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, malformed or older than 5 minutes
expected = hmac.new(secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected.encode(), v1.encode())عام غلطیاں
- challenge کو JSON میں یا کوٹیشن کے اندر واپس کرنا۔ Meta توقع کرتا ہے کہ 200 اسٹیٹس کے ساتھ باڈی میں hub.challenge کی قدر بالکل ویسی ہو۔
- پارس شدہ باڈی کا ہیش کرنا۔ JSON باڈی پارسر وہ عین بائٹس ضائع کر دیتا ہے جن پر Meta نے دستخط کیے، اس لیے HMAC کے لیے خام باڈی رکھیں اور بعد میں پارس کریں۔
- ایپ کو سبسکرائب کرنا اور اکاؤنٹ کو بھول جانا۔ جب تک کسی اکاؤنٹ کے لیے POST /<IG_ID>/subscribed_apps کامیاب نہ ہو، اس کے لیے کوئی اطلاع نہیں آتی۔
- ایک گھنٹے تک اینڈ پوائنٹ کو ناکام ہونے دینا۔ Meta میسجنگ ویب ہکس غیر فعال کر دیتا ہے اور ایپ کی اس اکاؤنٹ سے سبسکرپشن ختم کر دیتا ہے، جسے پھر دوبارہ سبسکرائب کرنا پڑتا ہے۔
اسے set_social_webhook_destination یا Partner API سے فعال کریں۔ فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنکشنز بڑھنے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
Instagram ویب ہکس میں hub.challenge کیا ہے؟
Meta اپنی تصدیقی GET درخواست میں ایک integer بھیجتا ہے۔ hub.verify_token جانچنے کے بعد اینڈ پوائنٹ اسے جواب کی باڈی کے طور پر واپس کرتا ہے، جس سے ثابت ہوتا ہے کہ وہ URL کنٹرول کرتا ہے۔
PHP میں hub.mode اور hub.challenge کیوں غائب ہیں؟
PHP پیرامیٹر ناموں میں ڈاٹس کو زیر خط بنا دیتا ہے، اس لیے Meta کی تصدیقی قدریں hub_mode، hub_challenge اور hub_verify_token کے طور پر پہنچتی ہیں۔
Meta کی جانب سے غیر فعال کرنے کے بعد Instagram ویب ہکس دوبارہ کیسے فعال کروں؟
پہلے اینڈ پوائنٹ ٹھیک کریں، پھر وہی فیلڈز کے ساتھ POST /<IG_ID>/subscribed_apps سے اکاؤنٹ دوبارہ سبسکرائب کریں۔
کیا Instagram ویب ہک اینڈ پوائنٹ کے لیے خود دستخط شدہ سرٹیفکیٹ کام کرتا ہے؟
نہیں، Meta خود دستخط شدہ سرٹیفکیٹ سپورٹ نہیں کرتا: کال بیک URL کو HTTPS پر معتبر سرٹیفکیٹ کے ساتھ قابلِ رسائی ہونا چاہیے، جو Meta کی ٹربل شوٹنگ چیک لسٹ کا پہلا نکتہ ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ