WhatsApp ویب ہک کی دوبارہ کوششیں، ڈپلیکیٹس اور ترتیب: انہیں کیسے سنبھالیں
Meta ایسے واٹس ایپ ویب ہک کو دوبارہ بھیجتا ہے جسے HTTP 200 کے سوا کوئی بھی جواب ملے، پہلے فوراً اور پھر کم ہوتی تعداد کے ساتھ 7 دن تک، اور اس کے بعد اسے چھوڑ دیتا ہے۔ دوبارہ کوشش ہر اس ایپ کو جاتی ہے جو اکاؤنٹ کو سبسکرائب ہے، اس لیے ڈپلیکیٹ معمول ہیں۔ جلدی 200 کا جواب دیں، میسج آئی ڈی یا اسٹیٹس آئی ڈی اور اسٹیٹس کی بنیاد پر ڈپلیکیٹ ہٹائیں، اور ایونٹس کو ان کے اپنے ٹائم اسٹیمپ سے ترتیب دیں۔
easyCoexistence آپ کا WhatsApp Business ایپ نمبر Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے اور Meta کی دوبارہ ڈیلیوریز کو آپ کی آٹومیشن تک پہنچنے سے پہلے جذب کرتا ہے، تاکہ دوبارہ آنے والا میسج AI کا دوسرا جواب نہ پائے۔
وہ مدت جس تک Meta اس ویب ہک کی دوبارہ کوشش جاری رکھتا ہے جس کا HTTP 200 جواب نہ آیا ہو، اس کے چھوڑنے سے پہلے
زیادہ تر اپ ڈیٹس Meta ایک POST میں بیچز کی صورت میں بھیجتا ہے۔ Meta بیچنگ کا وعدہ نہیں کرتا، اس لیے ہر درخواست کو الگ سے سنبھالیں۔
ایک WhatsApp ویب ہک POST میں آ سکنے والا سب سے بڑا پے لوڈ
easyCoexistence ہر آنے والے میسج آئی ڈی کو کتنی دیر یاد رکھتا ہے، تاکہ دوبارہ موصول ہونے والا میسج آٹومیشن کو دو بار نہ چلائے
ہر فارورڈ کے لیے آپ کے Forward URL پر کوششیں، ہر کوشش 2xx جواب کے لیے 10 سیکنڈ انتظار کرتی ہے، تقریباً 33 گھنٹوں میں
Meta WhatsApp ویب ہک کو کب دوبارہ کوشش کرتا ہے؟
جب بھی آپ کے اینڈ پوائنٹ پر ڈیلیوری HTTP 200 کے علاوہ کوئی اسٹیٹس دے، یا بالکل پہنچ نہ سکے۔ Meta فوراً دوبارہ کوشش کرتا ہے، پھر اگلے 7 دنوں میں کم ہوتے وقفے سے کچھ مزید بار، اور اس کے بعد جو ڈیلیوری ابھی تک تسلیم نہ ہوئی ہو اسے چھوڑ دیتا ہے۔ یہ دوبارہ کوششیں اس فیلڈ کے لیے WhatsApp Business Account کی ہر سبسکرائب ایپ کو جاتی ہیں، اسی لیے Meta خبردار کرتا ہے کہ ان سے ڈپلیکیٹ اطلاعات بن سکتی ہیں۔ پچھلے ویب ہکس حاصل کرنے کا کوئی API نہیں، اس لیے جو ڈیلیوری اپنے 7 دن پورے کر لے وہ آپ کے سسٹم کے لیے ضائع ہو جاتی ہے۔
صحت مند سرور کے باوجود ڈپلیکیٹ کیوں آتے ہیں؟
کیونکہ ایک ڈیلیوری آپ کی طرف کامیاب ہو سکتی ہے اور پھر بھی Meta کو ناکام لگ سکتی ہے۔ ایسا ہینڈلر جو جواب دینے سے پہلے کام کرتا ہے Meta کے انتظار سے آگے نکل سکتا ہے، تو Meta ایسی چیز دوبارہ بھیجتا ہے جو آپ پہلے ہی پروسیس کر چکے ہیں۔ ڈیپلائے کے دوران درخواست کے دوران سرور ری اسٹارٹ ہو جائے، لوڈ بیلنسر کچھ دیر کے لیے 502 دے، یا 200 کے بجائے 201 یا 204 آئے، یہ سب ناکامی شمار ہوتا ہے۔ بیچز ایک اور صورت بناتے ہیں: ایک POST میں کئی اپ ڈیٹس ہو سکتی ہیں، تو بڑے بیچ پر ٹائم آؤٹ پورے بیچ کو واپس لے آتا ہے، جن میں وہ اپ ڈیٹس بھی شامل ہیں جو آپ نے ہینڈل کر لی تھیں۔
کون سی کلید پر ڈپلیکیٹ ہٹانا چاہیے؟
Meta کی اپنی آئی ڈیز، ہر ایونٹ کی قسم کے لحاظ سے منتخب، کیونکہ ایک میسج جائز طور پر کئی ویب ہکس پیدا کرتا ہے۔ صرف اسٹیٹس کی کلید بغیر اسٹیٹس ویلیو کے delivered اور read کو sent کی نقل سمجھ کر ہٹا دے گی، اور کال کی کلید ایونٹ کے بغیر صرف کال کا پہلا مرحلہ رکھے گی۔ کلیدوں کو یونیک انڈیکس کے ساتھ محفوظ کریں، تاکہ ایک ہی دوبارہ کوشش سنبھالنے والے دو ورکرز دونوں کامیاب نہ ہوں:
ویب ہکس کس ترتیب سے آتے ہیں؟
ضروری نہیں کہ وہی ترتیب ہو جس میں چیزیں ہوئیں۔ Meta کی دستاویزات ترتیب کا کوئی وعدہ نہیں کرتیں، دوبارہ کوشش ہونے والی ڈیلیوری نئی ڈیلیوریز کے بعد پہنچتی ہے، اور اسٹیٹس ایک مرحلہ چھوڑ بھی سکتا ہے: جب میسج آتے ہی پڑھ لیا جائے تو Meta delivered کے بغیر read بھیجتا ہے۔ اس لیے ایونٹس کو ان کے اپنے ٹائم اسٹیمپ فیلڈ کے ساتھ محفوظ کریں، اسٹیٹس کا موازنہ آمد کے بجائے درجے کے مطابق کریں، اور کسٹمر کا بعد والا میسج اس پہلے والے پر فوقیت دے جو دیر سے پہنچا۔ Coexistence نمبر پر آن بورڈنگ کے آس پاس ایک بار کی ہسٹری امپورٹ لائیو میسجز سے اوورلیپ ہو سکتی ہے، اور دونوں کو ملانے والی چیز میسج آئی ڈی ہے۔
محفوظ ہینڈلر کیسا ہوتا ہے؟
چار اقدامات: تصدیق کریں، بالکل 200 کا جواب دیں، ڈپلیکیٹ ہٹائیں، پھر کیو سے کام کریں، تاکہ Meta کی درخواست اور آپ کے جواب کے درمیان کوئی سست کام نہ ہو۔ یہ ورژن آپ کی اپنی Meta ایپ کے سیکرٹ کے ساتھ X-Hub-Signature-256 کی جانچ کرتا ہے؛ easyCoexistence کے ذریعے جڑے نمبر کے لیے Meta easyCoexistence کی ایپ کے سیکرٹ سے دستخط کرتا ہے، اس لیے براہِ راست منزل اپنے URL کے پاتھ میں ایک لمبے سیکرٹ کے ساتھ تصدیق کرتی ہے، یا نمبر کے حساب سے دستخط شدہ مینیجڈ فارورڈنگ پر منتقل ہو جاتی ہے۔
// meta-webhook.mjs: node meta-webhook.mjs (no dependencies)
import crypto from "node:crypto";
import http from "node:http";
const APP_SECRET = process.env.META_APP_SECRET; // the secret of the Meta app that subscribed
const seen = new Set(); // keys already accepted: a unique index in a database in production
// One key per thing that happened, so a redelivery maps to the same keys.
function keysOf(field, value) {
const keys = [];
for (const m of value.messages ?? []) keys.push(`${field}:msg:${m.id}`);
for (const s of value.statuses ?? []) keys.push(`${field}:status:${s.id}:${s.status}`);
for (const e of value.message_echoes ?? []) keys.push(`${field}:echo:${e.id}`);
for (const c of value.calls ?? []) keys.push(`${field}:call:${c.id}:${c.event}`);
return keys;
}
http.createServer((req, res) => {
const chunks = [];
req.on("data", (c) => chunks.push(c));
req.on("end", () => {
const raw = Buffer.concat(chunks);
const got = Buffer.from(String(req.headers["x-hub-signature-256"] ?? ""));
const want = Buffer.from("sha256=" + crypto.createHmac("sha256", APP_SECRET).update(raw).digest("hex"));
if (req.method !== "POST" || got.length !== want.length || !crypto.timingSafeEqual(got, want)) {
res.writeHead(401).end();
return;
}
res.writeHead(200).end(); // exactly 200, before any work
const body = JSON.parse(raw.toString("utf8"));
for (const entry of body.entry ?? []) {
for (const change of entry.changes ?? []) {
for (const key of keysOf(change.field, change.value ?? {})) {
if (seen.has(key)) continue; // a retry of something already accepted
seen.add(key);
// queue { key, field: change.field, value: change.value } for a worker here
console.log("new", key);
}
}
}
});
}).listen(process.env.PORT ?? 3000);easyCoexistence جڑے ہوئے نمبر پر دوبارہ کوششیں کیسے سنبھالتا ہے؟
اندر آنے کی جانب easyCoexistence Meta کا دستخط چیک کرتا ہے، 200 کا جواب دیتا ہے، اور جواب کے بعد آٹومیشن چلاتا ہے، تاکہ AI کے جواب میں چند سیکنڈ لگنے پر Meta دوبارہ کوشش نہ کرے۔ ہر آنے والی میسج آئی ڈی 7 دن تک رکھی جاتی ہے، جو Meta کی دوبارہ کوشش کی مدت ہے، اور دوبارہ موصول ہونے والے میسج کو پہچانا جاتا ہے اور دوسرا آٹومیشن جواب نہیں دیتا۔
باہر کی جانب آپ کے Forward URL پر، ہر Meta تبدیلی ایک ڈیلیوری بنتی ہے جس کی آئی ڈی X-EC-Delivery میں ہوتی ہے اور فارورڈ کی دوبارہ کوششوں میں یکساں رہتی ہے: تقریباً 33 گھنٹوں میں 7 کوششیں، ہر ایک 2xx کے لیے 10 سیکنڈ انتظار کرتی ہے۔ وہ تبدیلی جو Meta خود دوبارہ بھیجے، نئی ڈیلیوری آئی ڈی کے ساتھ دوبارہ فارورڈ ہوتی ہے، اس لیے value کے اندر Meta کی آئی ڈیز پر بھی ڈپلیکیٹ ہٹائیں۔
عام غلطیاں
- اسٹیٹسز کو صرف آئی ڈی سے ڈپلیکیٹ ہٹانا۔ sent، delivered اور read ایک ہی wamid رکھتے ہیں، اس لیے کلید میں اسٹیٹس بھی ضروری ہے۔
- جواب دینے سے پہلے پروسیس کرنا۔ سست ہینڈلر Meta سے وہ کام دوبارہ کروا دیتا ہے جو آپ پہلے کر چکے؛ پہلے 200 لوٹائیں اور کام کو کیو سے کریں۔
- 201 یا 204 لوٹانا۔ Meta کی دستاویزات 200 کے علاوہ کسی بھی اسٹیٹس کو ناکام ڈیلیوری سمجھتی ہیں اور اسے دوبارہ کوشش کرتی ہیں۔
- فارورڈز کو صرف X-EC-Delivery سے ڈپلیکیٹ ہٹانا۔ وہ تبدیلی جو Meta دوبارہ بھیجے نئی ڈیلیوری آئی ڈی کے ساتھ آتی ہے؛ Meta کی آئی ڈیز کو دوسری کلید کے طور پر رکھیں۔
آپ کے سرور کو فارورڈز دستخط شدہ، کیو میں اور دوبارہ کوشش کے ساتھ جاتے ہیں، اور ہر نمبر 24/7 مانیٹر ہوتا ہے۔ فی نمبر فی مہینہ US$ 9 سے US$ 0.75 تک، جیسے جیسے نمبرز بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
میں جو آئی ڈیز دیکھ چکا ہوں انہیں کتنی دیر رکھوں؟
کم از کم 7 دن، Meta کی دوبارہ کوشش کی مدت۔ چھٹے دن دوبارہ کی جانے والی ڈیلیوری کو اپنی کلید سے میل کھانا چاہیے، ورنہ اسے نیا سمجھ کر پروسیس کیا جائے گا۔
اگر میرا اینڈ پوائنٹ کئی دن تک بند رہے تو میرے کسٹمرز کے میسجز کا کیا ہوتا ہے؟
Meta 7 دن تک دوبارہ کوشش کرتا ہے، پھر ویب ہکس چھوڑ دیتا ہے۔ Coexistence نمبر پر گفتگوئیں فون میں WhatsApp Business ایپ میں اب بھی موجود رہتی ہیں، اس لیے کاروبار وہیں سے جواب دے سکتا ہے۔
کیا میں جو ویب ہکس چھوٹ گئے انہیں دوبارہ چلا سکتا ہوں؟
Meta سے نہیں: تاریخی ویب ہک ڈیٹا کا کوئی API نہیں۔ Coexistence نمبر کی ایک بار کی ہسٹری امپورٹ صرف آن بورڈنگ پر چلتی ہے اور اسی کنکشن کے لیے دوبارہ درخواست نہیں کی جا سکتی۔
کیا Meta ایک ہی اپ ڈیٹ ایک سے زیادہ سرورز کو بھیجتا ہے؟
یہ ہر اس ایپ کو بھیجتا ہے جو اس فیلڈ کے لیے WhatsApp Business Account کو سبسکرائب ہے۔ destination override کے ساتھ، نمبر کے میسج فیلڈز اس ایپ کے ڈیفالٹ callback کے بجائے override URL کو جاتے ہیں۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ