WhatsApp वेबहुकको फेरि प्रयास, डुप्लिकेट र क्रम: कसरी ह्यान्डल गर्ने
Meta ले WhatsApp वेबहुकलाई HTTP 200 बाहेक अरू जुनसुकै प्रतिक्रिया आए पनि तुरुन्तै, र त्यसपछि घट्दो बारम्बारतामा, 7 दिनसम्म फेरि प्रयास गर्छ, र त्यसपछि छोड्छ। फेरि प्रयास गरिएका सबै अनुरोध खातासँग जोडिएका हरेक एपमा जान्छन्, त्यसैले डुप्लिकेट सामान्य हो। 200 छिटो फर्काउनुहोस्, म्यासेज id वा status id प्लस स्ट्याटसको आधारमा डुप्लिकेट हटाउनुहोस्, र घटनाहरूलाई तिनको आफ्नै टाइमस्ट्याम्पले क्रम मिलाउनुहोस्।
easyCoexistence ले तपाईंको WhatsApp Business एप नम्बरलाई Coexistence मार्फत Meta को Cloud API सँग जोड्छ, र तपाईंका स्वचालनले देख्नुअघि Meta का फेरि-पठाइएका सूचनाहरू आफैँ सोस्छ, त्यसैले फेरि प्रयास गरिएको म्यासेजले दोस्रो AI उत्तर पाउँदैन।
Meta ले 200 नपाएको वेबहुकलाई छोड्नुअघि कति समयसम्म फेरि प्रयास गर्छ।
धेरैजसो अपडेट Meta ले एउटै POST मा ब्याचमा पठाउँछ; Meta ले ब्याचिङको वाचा गर्दैन, त्यसैले हरेक अनुरोध छुट्टै ह्यान्डल गर्नुहोस्।
WhatsApp वेबहुक POST ले बोक्न सक्ने सबैभन्दा ठूलो पेलोड।
easyCoexistence ले हरेक आउने म्यासेज id कति समय याद राख्छ, ताकि फेरि डेलिभर भएको म्यासेजले स्वचालन दुई पटक नचलोस्।
तपाईंको Forward URL मा प्रति फरवार्ड प्रयास संख्या, हरेकले 2xx का लागि 10 सेकेन्ड पर्खँदै, लगभग 33 घण्टामा।
Meta कहिले WhatsApp वेबहुक फेरि प्रयास गर्छ?
जब तपाईंको एन्डपोइन्टमा डेलिभरीले 200 बाहेक HTTP स्थिति पाउँछ, वा बिल्कुलै डेलिभर हुन सक्दैन। Meta तुरुन्तै फेरि प्रयास गर्छ, त्यसपछि अर्को 7 दिनमा घट्दो बारम्बारतामा केही पटक थप, र त्यसपछि स्वीकृत नभएको कुरा छोडिदिन्छ। यी फेरि प्रयास त्यो फिल्डका लागि WhatsApp Business Account मा सदस्यता लिएका हरेक एपमा जान्छन्, जसैले गर्दा Meta ले डुप्लिकेट सूचना आउन सक्ने चेतावनी दिन्छ। 7 दिन पूरा भएका वेबहुक ल्याउने कुनै API छैन, त्यसैले त्यो डेलिभरी तपाईंको प्रणालीका लागि हराउँछ।
तपाईंको सर्भर स्वस्थ हुँदा पनि डुप्लिकेट किन आउँछन्?
किनभने डेलिभरी तपाईंको पक्षबाट सफल भए पनि Meta का लागि असफल देखिन सक्छ। जवाफ दिनुअघि काम गर्ने ह्यान्डलरले Meta को प्रतीक्षा समय पार गर्न सक्छ, र त्यसैले Meta ले तपाईंले पहिले नै प्रशोधन गरिसकेको कुरा फेरि प्रयास गर्छ। अनुरोधको बीचमा सर्भर रिस्टार्ट गर्ने डिप्लोय, केही समयका लागि 502 फर्काउने लोड ब्यालेन्सर, वा 200 को सट्टा 201 वा 204, सबै असफलता मानिन्छन्। ब्याचले अर्को कारण थप्छ: एउटा POST मा धेरै अपडेट हुन सक्छन्, त्यसैले ठूलो ब्याचमा टाइमआउट भयो भने तपाईंले पहिले नै ह्यान्डल गरेका अपडेटसहित सम्पूर्ण ब्याच फिर्ता आउँछ।
कुन कुञ्जीमा डुप्लिकेट हटाउने?
हरेक घटना प्रकारअनुसार छानिएको Meta को आफ्नै id, किनभने एउटै म्यासेजले धेरै वेबहुक बनाउँछ। स्ट्याटस मान बिना स्ट्याटस कुञ्जीले delivered र read लाई sent का प्रतिलिपि ठानेर हटाउनेछ, र event बिना कल कुञ्जीले कलको पहिलो चरण मात्र राख्नेछ। कुञ्जीहरू unique index सहित भण्डारण गर्नुहोस्, ताकि एउटै फेरि प्रयास ह्यान्डल गर्ने दुई वर्कर दुवै जित्न नसकून्:
वेबहुक कुन क्रममा आउँछन्?
सधैं घटनाहरू जुन क्रममा भएका थिए त्यही क्रममा हुँदैन। Meta को कागजातले क्रमको कुनै वाचा गर्दैन, फेरि प्रयास गरिएको डेलिभरी नयाँ डेलिभरीहरूपछि आइपुग्छ, र स्ट्याटसले एउटा चरण छोड्न सक्छ: म्यासेज डेलिभर हुनुअघि नै पढिँदा Meta ले delivered बिना read पठाउँछ। त्यसैले घटनाहरू तिनको आफ्नै timestamp फिल्डसहित भण्डारण गर्नुहोस्, स्ट्याटसलाई आगमनको सट्टा रैंकले तुलना गर्नुहोस्, र ढिलो आएको पहिलेको म्यासेजभन्दा पछिल्लो ग्राहक म्यासेजलाई प्राथमिकता दिनुहोस्। Coexistence नम्बरमा एक-पटकको इतिहास आयात अनबोर्डिङ वरिपरि प्रत्यक्ष म्यासेजसँग ओभरल्याप हुन सक्छ, र दुईलाई मिलाउने काम म्यासेज id ले गर्छ।
सुरक्षित ह्यान्डलर कस्तो हुन्छ?
चार चरण: प्रमाणित गर्नुहोस्, ठ्याक्कै 200 फर्काउनुहोस्, डुप्लिकेट हटाउनुहोस्, र त्यसपछि क्युबाट काम गर्नुहोस्, ताकि Meta को अनुरोध र तपाईंको प्रतिक्रियाको बीचमा ढिलो कुनै कुरा नपरोस्। यो संस्करणले X-Hub-Signature-256 लाई तपाईंकै Meta एपको सिक्रेटसँग जाँच्छ; 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 फेरि प्रयास गर्दैन। हरेक आउने म्यासेज id 7 दिन राखिन्छ, जुन Meta को फेरि प्रयास विन्डोको लम्बाइ हो, र दोहोरिएको म्यासेज चिनिन्छ र दोस्रो स्वचालित उत्तर चलाउँदैन।
तपाईंको Forward URL तर्फ बाहिर जाँदा, प्रत्येक Meta परिवर्तन X-EC-Delivery मा id सहित एउटा डेलिभरी बन्छ, जुन फरवार्ड प्रयासहरूभरि एउटै रहन्छ: लगभग 33 घण्टामा 7 प्रयास, हरेकले 2xx का लागि 10 सेकेन्ड पर्खिन्छ। Meta ले आफैँ फेरि पठाएको परिवर्तन नयाँ डेलिभरी id अन्तर्गत फेरि फरवार्ड हुन्छ, त्यसैले value भित्रका Meta id मा पनि डुप्लिकेट हटाउनुहोस्।
सामान्य गल्तीहरू
- id मात्रैमा स्ट्याटस डुप्लिकेट हटाउनु। sent, delivered र read ले wamid साझा गर्छन्, त्यसैले कुञ्जीमा स्ट्याटस पनि चाहिन्छ।
- प्रशोधन जवाफभन्दा पहिले गर्नु। ढिलो ह्यान्डलरले तपाईंले पहिले नै गरिसकेको काम Meta लाई फेरि प्रयास गर्न लगाउँछ; पहिले 200 फर्काउनुहोस् र क्युबाट काम गर्नुहोस्।
- 201 वा 204 फर्काउनु। Meta को कागजातले 200 बाहेक कुनै पनि स्थितिलाई असफल डेलिभरी मान्छ र फेरि प्रयास गर्छ।
- फरवार्डमा केवल X-EC-Delivery मा डुप्लिकेट हटाउनु। Meta ले फेरि पठाएको परिवर्तन नयाँ डेलिभरी id सहित आउँछ; Meta को id लाई दोस्रो कुञ्जीको रूपमा राख्नुहोस्।
तपाईंको सर्भरतर्फ फरवार्डहरू हस्ताक्षरित, क्युमा राखिएका र फेरि प्रयास गरिएका हुन्छन्, र हरेक नम्बर 24/7 निगरानीमा हुन्छ। US$ 9 देखि US$ 0.75 सम्म प्रति नम्बर प्रति महिना, नम्बर थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
मैले देखेका id कति समय राख्नुपर्छ?
कम्तीमा 7 दिन, Meta को फेरि प्रयास विन्डो। छैठौं दिनमा Meta ले फेरि प्रयास गर्ने डेलिभरी आफ्नो कुञ्जीसँग मेल खानुपर्छ, नत्र यसलाई नयाँ मानेर प्रशोधन गरिनेछ।
मेरो एन्डपोइन्ट दिनौंसम्म बन्द भयो भने ग्राहकका म्यासेजहरूको के हुन्छ?
Meta 7 दिनसम्म फेरि प्रयास गर्छ र त्यसपछि वेबहुक छोड्छ। Coexistence नम्बरमा कुराकानीहरू अझै फोनको WhatsApp Business एपमा छन्, त्यसैले व्यवसायले त्यहाँबाट जवाफ दिन सक्छ।
छुटेका वेबहुक फेरि चलाउन सकिन्छ?
Meta बाट होइन: ऐतिहासिक वेबहुक डेटाका लागि कुनै API छैन। Coexistence नम्बरको एक-पटकको इतिहास आयात केवल अनबोर्डिङमा चल्छ र एउटै कनेक्सनका लागि फेरि अनुरोध गर्न सकिँदैन।
के Meta एउटै अपडेट एकभन्दा बढी सर्भरमा पठाउँछ?
हो, त्यस फिल्डको WhatsApp Business Account मा सदस्यता लिएका हरेक एपमा पठाउँछ। गन्तव्य override सहित, नम्बरका म्यासेज फिल्डहरू त्यस एपको पूर्वनिर्धारित callback को सट्टा override URL मा जान्छन्।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको