लॉग इनमोफत ट्रायल सुरू करा
Meta Tech Provider

WhatsApp वेबहुक पुन्हा प्रयत्न, डुप्लिकेट आणि क्रम: त्यांना कसे हाताळावे

Meta एखादा WhatsApp वेबहुक, ज्याला HTTP 200 व्यतिरिक्त काहीही मिळते, तो लगेच आणि नंतर कमी होत जाणाऱ्या वारंवारतेने 7 दिवसांपर्यंत पुन्हा पाठवते, आणि त्यानंतर सोडून देते. पुन्हा प्रयत्न त्या खात्याची सदस्यता घेतलेल्या प्रत्येक ॲपकडे जातात, त्यामुळे डुप्लिकेट सामान्य आहेत. 200 जलद परत करा, message id वर किंवा status id आणि status वर डुप्लिकेट काढा, आणि घटनांची क्रमवारी त्यांच्या स्वतःच्या टाइमस्टॅम्पने लावा.

easyCoexistence तुमचा WhatsApp Business ॲप नंबर Coexistence द्वारे Meta च्या Cloud API शी जोडतो आणि तुमचे ऑटोमेशन पाहण्यापूर्वी Meta चे पुन्हा पाठवणे शोषून घेतो, त्यामुळे पुन्हा पाठवलेल्या मेसेजला दुसरे AI उत्तर मिळत नाही.

7 days

Meta HTTP 200 न मिळालेला वेबहुक सोडून देण्यापूर्वी किती काळ पुन्हा प्रयत्न करते.

1,000

Meta बहुतेक अद्यतने एका POST मध्ये एकत्र पाठवते; बॅचिंगची हमी Meta देत नाही, म्हणून प्रत्येक विनंती स्वतंत्रपणे हाताळा.

3 MB

WhatsApp वेबहुक POST मध्ये वाहून नेता येणारा सर्वात मोठा पेलोड.

7 days

easyCoexistence प्रत्येक येणाऱ्या message id ची किती काळ आठवण ठेवते, जेणेकरून पुन्हा पाठवलेला मेसेज ऑटोमेशन दोनदा चालवत नाही.

7 attempts

तुमच्या Forward URL वर प्रत्येक फॉरवर्डसाठी प्रयत्न, प्रत्येक 2xx साठी 10 सेकंद वाट पाहत, सुमारे 33 तासांत.

Meta WhatsApp वेबहुक पुन्हा कधी पाठवते?

जेव्हा तुमच्या endpoint वरील डिलिव्हरीला HTTP 200 व्यतिरिक्त स्टेटस मिळतो, किंवा ती अजिबात पोहोचवता येत नाही. Meta लगेच पुन्हा प्रयत्न करते, आणि नंतर पुढील 7 दिवसांत कमी होत जाणाऱ्या वारंवारतेने आणखी काही वेळा करते, आणि त्यानंतर ज्याची पावती मिळालेली नाही ते सोडून देते. हे पुन्हा प्रयत्न त्या फील्डसाठी WhatsApp Business Account ची सदस्यता घेतलेल्या प्रत्येक ॲपकडे जातात, म्हणूनच Meta चेतावणी देते की ते डुप्लिकेट सूचना निर्माण करू शकतात. भूतकाळातील वेबहुक मिळवण्यासाठी कोणतेही API नाही, त्यामुळे 7 दिवस संपलेली डिलिव्हरी तुमच्या सिस्टमसाठी गमावली जाते.

तुमचा सर्व्हर निरोगी असतानाही डुप्लिकेट का येतात?

कारण डिलिव्हरी तुमच्या बाजूने यशस्वी होऊ शकते आणि तरीही Meta ला अयशस्वी वाटू शकते. उत्तर देण्यापूर्वी काम करणारा हँडलर Meta च्या प्रतीक्षा वेळेच्या पलीकडे जाऊ शकतो, म्हणून Meta अशी गोष्ट पुन्हा पाठवते जी तुम्ही आधीच प्रक्रिया केलेली आहे. विनंतीच्या मध्येच सर्व्हर रीस्टार्ट करणारी डिप्लॉय, काही क्षणांसाठी 502 परत करणारा लोड बॅलन्सर, किंवा 200 ऐवजी 201 किंवा 204 हे सर्व अपयश मानले जातात. बॅचमुळे आणखी एक प्रकरण येते: एका POST मध्ये अनेक अद्यतने असू शकतात, त्यामुळे मोठ्या बॅचवरील टाइमआउटमुळे तुम्ही हाताळलेली अद्यतनेही संपूर्ण बॅच परत येते.

कोणत्या की वर डुप्लिकेट काढावे?

Meta च्या स्वतःच्या आयडी, प्रत्येक इव्हेंट प्रकारानुसार निवडलेले, कारण एक मेसेज कायदेशीररीत्या अनेक वेबहुक तयार करतो. स्टेटस मूल्याशिवाय स्टेटस की delivered आणि read यांना sent च्या प्रती समजून टाकून देईल, आणि कॉल की इव्हेंटशिवाय कॉलचा फक्त पहिला टप्पा ठेवेल. या की एका unique index सह साठवा, जेणेकरून एकाच पुन्हा प्रयत्नावर काम करणारे दोन वर्कर्स दोन्ही जिंकू शकत नाहीत:

messages[].idIncoming messages: the wamid.
statuses[].id + statusOne message has sent, delivered, read; each is its own event.
message_echoes[].idReplies the owner typed in the WhatsApp Business app.
calls[].id + eventA call's connect, statuses and terminate share the wacid.
user id + value + timestampuser_preferences: a customer can stop and resume more than once.

वेबहुक कोणत्या क्रमाने येतात?

कदाचित घडलेल्या क्रमाने नाही. Meta च्या कागदपत्रांत क्रमाची कोणतीही हमी नाही, पुन्हा पाठवलेली डिलिव्हरी नंतरच्या डिलिव्हरींच्या मागे येते, आणि स्टेटस एखादा टप्पा वगळू शकतो: मेसेज येण्याच्या क्षणी वाचला गेल्यास Meta delivered शिवाय read पाठवते. म्हणून घटना त्यांच्या स्वतःच्या टाइमस्टॅम्प फील्डसह साठवा, स्टेटसची तुलना आगमन वेळेनुसार नाही तर रँकने करा, आणि उशिरा आलेल्या जुन्या मेसेजपेक्षा नंतरचा ग्राहक मेसेज वरचढ ठरू द्या. Coexistence नंबरवर एकदाच होणारी इतिहास आयात ऑनबोर्डिंगच्या आसपास लाइव्ह मेसेजांशी ओव्हरलॅप होऊ शकते, आणि ते दोन्ही जुळवण्याचे काम message id करतो.

सुरक्षित हँडलर कसा दिसतो?

चार पावले: पडताळा, अचूक 200 द्या, डुप्लिकेट काढा, मग रांगेतून काम करा, जेणेकरून Meta च्या विनंती आणि तुमच्या प्रतिसादादरम्यान काहीही संथ राहणार नाही. ही आवृत्ती तुमच्या स्वतःच्या Meta ॲपच्या सीक्रेटने X-Hub-Signature-256 तपासते; easyCoexistence द्वारे जोडलेल्या नंबरसाठी Meta easyCoexistence च्या ॲप सीक्रेटने स्वाक्षरी करते, म्हणून थेट गंतव्य URL पथातील लांब सीक्रेटने प्रमाणीकरण करते, किंवा प्रति नंबर स्वाक्षरी केलेल्या व्यवस्थापित फॉरवर्डिंगकडे वळते.

meta-webhook.mjs: 200 first, then deduplicate (Node.js, no dependencies)
// 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 पुन्हा प्रयत्न करत नाही. प्रत्येक येणारा message id 7 दिवस ठेवला जातो, जो Meta च्या पुन्हा प्रयत्न विंडोची लांबी आहे, आणि पुन्हा पाठवलेला मेसेज ओळखला जातो व दुसरे ऑटोमेशन उत्तर ट्रिगर करत नाही. बाहेरच्या दिशेने तुमच्या Forward URL कडे, Meta च्या प्रत्येक बदलातून एक डिलिव्हरी तयार होते, ज्याचा X-EC-Delivery मधील आयडी फॉरवर्ड पुन्हा प्रयत्नांमध्ये सारखाच राहतो: सुमारे 33 तासांत 7 प्रयत्न, प्रत्येक 2xx साठी 10 सेकंद वाट पाहत. Meta स्वतः पुन्हा पाठवलेला बदल नवीन डिलिव्हरी आयडीखाली पुन्हा फॉरवर्ड होतो, म्हणून value च्या आत Meta च्या आयडींवरही डुप्लिकेट काढा.

सामान्य चुका

  • स्टेटसवर फक्त id वरून डुप्लिकेट काढणे. sent, delivered आणि read एकच wamid सामायिक करतात, म्हणून की मध्ये स्टेटसही हवा.
  • उत्तर देण्यापूर्वी प्रक्रिया करणे. संथ हँडलर Meta ला तुम्ही आधीच केलेले काम पुन्हा करायला लावतो; आधी 200 परत करा आणि मग रांगेतून काम करा.
  • 201 किंवा 204 परत करणे. Meta च्या दस्तऐवजात 200 व्यतिरिक्त कोणत्याही स्टेटसला अयशस्वी डिलिव्हरी मानले जाते आणि ती पुन्हा पाठवली जाते.
  • फॉरवर्ड्स फक्त X-EC-Delivery वरून डुप्लिकेट काढणे. Meta ने पुन्हा पाठवलेला बदल नवीन डिलिव्हरी आयडीखाली येतो; Meta चे आयडी दुसरी की म्हणून ठेवा.
EasyCoexistence सोबत हे करताना

तुमच्या सर्व्हरकडे जाणारे फॉरवर्ड स्वाक्षरीकृत, रांगेत टाकलेले आणि पुन्हा प्रयत्न केलेले असतात, आणि प्रत्येक नंबर 24/7 मॉनिटर केला जातो. प्रति नंबर प्रति महिना US$ 9 ते US$ 0.75, नंबर वाढवल्यास कमी होत जाते, पहिले 3 दिवस मोफत.

वारंवार विचारले जाणारे प्रश्न

मी पाहिलेले आयडी किती काळ ठेवावेत?

किमान 7 दिवस, Meta च्या पुन्हा प्रयत्न विंडोइतके. सहाव्या दिवशी Meta पुन्हा पाठवलेली डिलिव्हरी तिच्या की शी जुळली पाहिजे, नाहीतर ती नवीन म्हणून प्रक्रिया होईल.

माझा endpoint काही दिवस बंद असल्यास ग्राहकांच्या मेसेजचे काय होते?

Meta 7 दिवसांपर्यंत पुन्हा प्रयत्न करते आणि नंतर वेबहुक सोडून देते. Coexistence नंबरवर संभाषणे फोनवरील WhatsApp Business ॲपमध्ये अजूनही असतात, त्यामुळे व्यवसाय तिथून उत्तर देऊ शकतो.

मी चुकवलेले वेबहुक पुन्हा चालवू शकतो का?

Meta कडून नाही: ऐतिहासिक वेबहुक डेटासाठी कोणतेही API नाही. Coexistence नंबरची एकदाची इतिहास आयात फक्त ऑनबोर्डिंगवेळी चालते आणि त्याच कनेक्शनसाठी पुन्हा विनंती करता येत नाही.

Meta एकाच अद्यतनाची प्रत एकापेक्षा जास्त सर्व्हरवर पाठवते का?

ते त्या फील्डसाठी WhatsApp Business Account ची सदस्यता घेतलेल्या प्रत्येक ॲपला पाठवते. destination override सह, नंबरची मेसेज फील्ड्स त्या ॲपच्या डिफॉल्ट कॉलबॅकऐवजी override URL वर जातात.

पुढे वाचा

WhatsApp वेबहुक स्टेटस: sent, delivered, read आणि failedWhatsApp तुम्ही पाठवलेल्या मेसेजचे काय झाले ते कसे कळवते: statuses array, प्रत्येक स्टेटस मूल्य, प्रत्येक फील्ड, wamid आणि Meta चा खरा पेलोड.WhatsApp मेसेज का अयशस्वी झाला: अयशस्वी स्टेटस आणि त्रुटी वाचणेअयशस्वी स्टेटस म्हणजे Meta तुमचा WhatsApp मेसेज पाठवू किंवा पोहोचवू शकले नाही. errors array आणि 131047, 131049, 131050 सारखे कोड आणि त्यावरील उपाय वाचा.messages वेबहुकग्राहक पाठवतो ते सर्व या फील्डवर येते. पेलोडमध्ये काय असते, प्रतिसाद कसा द्यायचा आणि routed नंबरवरील provider पर्यंत ते का पोहोचत नाही.WhatsApp मेसेज तुमच्या सर्व्हरपर्यंत कसे पोहोचतात: थेट की व्यवस्थापित, आणि स्वाक्षरीची पडताळणीथेट: Meta तुमच्या सर्व्हरवर पाठवते. व्यवस्थापित: ऑटोमेशन उत्तर देतात, स्वाक्षरी केलेली प्रत फॉरवर्ड यूआरएलवर जाते. X-EC-Signature, पेलोड, पुन्हा प्रयत्न.WhatsApp वेबहुक एंडपॉइंटची पडताळणीMeta GET द्वारे तुमच्या एंडपॉइंटला चॅलेंज पाठवते. काय परत करायचे आणि चुकीचे उत्तर का अपयशी ठरते.WhatsApp वेबहुक्स: मेसेज थेट तुमच्या सर्व्हरवर पाठवणेWhatsApp वेबहुक्स कसे काम करतात, Meta काय पाठवते आणि मेसेज प्रदात्याच्या प्लॅटफॉर्मऐवजी थेट तुमच्या एंडपॉइंटवर कसे पाठवायचे.

सुरुवात करण्यासाठी तयार आहात?

WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.

मोफत ट्रायल सुरू करा

पडताळले: