WhatsApp वेबहुक रीट्राई, डुप्लिकेट और क्रम: इन्हें कैसे संभालें
Meta उस WhatsApp वेबहुक को दोबारा भेजता है जिसे HTTP 200 के अलावा कुछ और मिले, पहले तुरंत और फिर घटती आवृत्ति से, 7 दिन तक। उसके बाद उसे छोड़ दिया जाता है। रीट्राई अकाउंट से जुड़े हर ऐप को जाते हैं, इसलिए डुप्लिकेट सामान्य हैं। 200 जल्दी लौटाएँ, मैसेज आईडी या स्टेटस आईडी और स्टेटस के जोड़ से डुप्लिकेट पहचानें, और इवेंट को उनके अपने टाइमस्टैम्प से क्रम दें।
easyCoexistence आपके WhatsApp Business ऐप वाले नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है, और Meta की दोबारा डिलीवरी को आपके ऑटोमेशन तक पहुँचने से पहले सँभाल लेता है, ताकि दोबारा भेजे गए मैसेज को दूसरा AI जवाब न मिले।
Meta कितने समय तक उस वेबहुक को दोबारा भेजता रहता है जिसे HTTP 200 नहीं मिला, उसे छोड़ने से पहले।
ज़्यादातर अपडेट Meta एक POST में बैच करके भेजता है; Meta बैचिंग की गारंटी नहीं देता, इसलिए हर अनुरोध को अलग से संभालें।
एक WhatsApp वेबहुक POST में अधिकतम कितना पेलोड आ सकता है।
easyCoexistence हर आने वाली मैसेज आईडी को कितने समय तक याद रखता है, ताकि दोबारा मिला मैसेज ऑटोमेशन को दो बार न चलाए।
आपके फ़ॉरवर्ड यूआरएल पर हर फ़ॉरवर्ड की कोशिशें, हर एक 2xx के लिए 10 सेकंड रुकता है, लगभग 33 घंटे में।
Meta WhatsApp वेबहुक को कब रीट्राई करता है?
जब आपके एंडपॉइंट पर डिलीवरी HTTP का कोई ऐसा स्टेटस लौटाए जो 200 नहीं है, या बिल्कुल डिलीवर न हो पाए। Meta तुरंत रीट्राई करता है, फिर अगले 7 दिन में घटती आवृत्ति से कुछ और बार, और उसके बाद जो बिना स्वीकृति के बचा हो उसे छोड़ देता है। रीट्राई उस फ़ील्ड के लिए WhatsApp Business Account से जुड़े हर ऐप को जाते हैं, इसीलिए Meta चेतावनी देता है कि इनसे डुप्लिकेट नोटिफ़िकेशन बन सकते हैं। पिछले वेबहुक लाने का कोई एपीआई नहीं है, इसलिए जो डिलीवरी अपने 7 दिन पूरे कर लेती है वह आपके सिस्टम के लिए खो जाती है।
आपका सर्वर स्वस्थ हो तब भी डुप्लिकेट क्यों आते हैं?
क्योंकि डिलीवरी आपकी तरफ़ सफल हो सकती है और फिर भी Meta को असफल दिखे। ऐसा हैंडलर जो जवाब देने से पहले अपना काम करता है, Meta के इंतज़ार की सीमा से आगे निकल सकता है, तो Meta वह चीज़ दोबारा भेजता है जिसे आप पहले ही प्रोसेस कर चुके हैं। अनुरोध के बीच में सर्वर को रीस्टार्ट करने वाला डिप्लॉय, कुछ देर के लिए 502 लौटाने वाला लोड बैलेंसर, या 200 की जगह 201 या 204 भी असफलता मानी जाती हैं। बैच एक और मामला जोड़ते हैं: एक POST में कई अपडेट हो सकते हैं, इसलिए बड़े बैच पर टाइमआउट पूरे बैच को वापस ले आता है, उन अपडेट समेत जिन्हें आप पहले संभाल चुके हैं।
किस कुंजी पर डुप्लिकेट पहचानें?
Meta की अपनी आईडी, जो हर इवेंट प्रकार के अनुसार चुनी जाती है, क्योंकि एक मैसेज से वैध रूप से कई वेबहुक बनते हैं। स्टेटस की कुंजी बिना स्टेटस वैल्यू के delivered को sent की कॉपी मानकर हटा देगी, और कॉल की कुंजी बिना इवेंट के कॉल का केवल पहला चरण रखेगी। इन कुंजियों को यूनीक इंडेक्स के साथ स्टोर करें, ताकि एक ही रीट्राई संभालने वाले दो वर्कर दोनों जीत न सकें:
वेबहुक किस क्रम में आते हैं?
ज़रूरी नहीं कि उसी क्रम में जिसमें चीज़ें हुईं। Meta के दस्तावेज़ में क्रम की कोई गारंटी नहीं है, दोबारा भेजी गई डिलीवरी नए वाले के बाद पहुँचती है, और स्टेटस एक चरण छोड़ सकता है: जब मैसेज आते ही पढ़ लिया जाता है तो Meta delivered के बिना read भेजता है। इसलिए इवेंट को उनके अपने टाइमस्टैम्प फ़ील्ड के साथ स्टोर करें, स्टेटस की तुलना आने के समय से नहीं बल्कि रैंक से करें, और देर से आए पुराने मैसेज की जगह बाद में आया ग्राहक मैसेज जीते। Coexistence नंबर पर एक बार होने वाला इतिहास इम्पोर्ट ऑनबोर्डिंग के आसपास लाइव मैसेज के साथ ओवरलैप हो सकता है, और उन दोनों का मिलान मैसेज आईडी से होता है।
सुरक्षित हैंडलर कैसा दिखता है?
चार कदम: सत्यापित करें, ठीक 200 लौटाएँ, डुप्लिकेट हटाएँ, फिर क्यू से काम करें, ताकि Meta के अनुरोध और आपके जवाब के बीच कुछ धीमा न रहे। यह संस्करण आपके अपने Meta ऐप के सीक्रेट से X-Hub-Signature-256 की जाँच करता है; easyCoexistence के ज़रिए जुड़े नंबर के लिए Meta easyCoexistence के ऐप सीक्रेट से साइन करता है, इसलिए सीधा वेबहुक डेस्टिनेशन उसके यूआरएल पाथ में लंबे सीक्रेट के साथ प्रमाणित होता है, या हर नंबर पर साइन किए गए मैनेज्ड फ़ॉरवर्डिंग पर चला जाता है।
// 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 की रीट्राई विंडो की लंबाई है, और दोबारा मिले मैसेज को पहचाना जाता है और दूसरा ऑटोमेशन जवाब नहीं चलता।
बाहर आते समय, आपके फ़ॉरवर्ड यूआरएल की ओर, हर 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 दोबारा भेजता है उसकी कुंजी अब भी मेल खानी चाहिए, वरना उसे नई मानकर प्रोसेस किया जाएगा।
अगर मेरा एंडपॉइंट कई दिनों तक बंद रहे तो मेरे ग्राहकों के मैसेज का क्या होगा?
Meta 7 दिन तक रीट्राई करता है और फिर वेबहुक छोड़ देता है। Coexistence नंबर पर बातचीत फ़ोन पर WhatsApp Business ऐप में अब भी रहती है, इसलिए व्यवसाय वहीं से जवाब दे सकता है।
क्या मैं छूटे हुए वेबहुक दोबारा चला सकता हूँ?
Meta से नहीं: पिछले वेबहुक डेटा का कोई एपीआई नहीं है। Coexistence नंबर का एक बार होने वाला इतिहास इम्पोर्ट सिर्फ़ ऑनबोर्डिंग पर चलता है और उसी कनेक्शन के लिए दोबारा नहीं माँगा जा सकता।
क्या Meta एक ही अपडेट एक से अधिक सर्वर को भेजता है?
हाँ, उस फ़ील्ड के लिए WhatsApp Business Account से जुड़े हर ऐप को। डेस्टिनेशन ओवरराइड के साथ नंबर के मैसेज फ़ील्ड उस ऐप के डिफ़ॉल्ट कॉलबैक के बजाय ओवरराइड यूआरएल पर जाते हैं।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित