WhatsApp వెబ్హుక్ మళ్లీ ప్రయత్నాలు, డూప్లికేట్లు మరియు క్రమం: వాటిని ఎలా నిర్వహించాలి
HTTP 200 కాకుండా ఏ ప్రతిస్పందన వచ్చినా Meta WhatsApp వెబ్హుక్ను వెంటనే మళ్లీ పంపుతుంది, తర్వాత 7 రోజుల వరకు తగ్గుతున్న తరచుదనంతో మళ్లీ ప్రయత్నిస్తుంది, ఆ తర్వాత దానిని వదిలేస్తుంది. ఈ మళ్లీ పంపడాలు ఖాతాకు సబ్స్క్రైబ్ అయిన ప్రతి యాప్కు వెళ్తాయి, కాబట్టి డూప్లికేట్లు సాధారణమే. 200 ను త్వరగా ఇవ్వండి, మెసేజ్ ID లేదా స్టేటస్ ID మరియు స్టేటస్ ఆధారంగా డూప్లికేట్లను తొలగించండి, ఈవెంట్లను వాటి స్వంత టైమ్స్టాంప్ల ఆధారంగా క్రమబద్ధీకరించండి.
easyCoexistence మీ WhatsApp Business యాప్ నంబర్ను Coexistence ద్వారా Meta Cloud API కి కనెక్ట్ చేస్తుంది, మరియు మీ ఆటోమేషన్లు చూసే ముందే Meta మళ్లీ పంపినవాటిని గ్రహిస్తుంది, కాబట్టి మళ్లీ వచ్చిన మెసేజ్కు రెండవ AI రిప్లై రాదు.
Meta, HTTP 200 అందుకోని వెబ్హుక్ను వదిలేయడానికి ముందు ఎంతకాలం మళ్లీ ప్రయత్నిస్తుంది.
Meta ఎక్కువ అప్డేట్లను ఒకే POST లో బ్యాచ్ చేస్తుంది; బ్యాచింగ్కు Meta హామీ ఇవ్వదు, కాబట్టి ప్రతి అభ్యర్థనను విడిగా నిర్వహించండి.
WhatsApp వెబ్హుక్ POST మోయగల గరిష్ట పేలోడ్.
easyCoexistence ప్రతి ఇన్కమింగ్ మెసేజ్ ID ను ఎంతకాలం గుర్తుంచుకుంటుంది, తద్వారా మళ్లీ వచ్చిన మెసేజ్ ఆటోమేషన్ను రెండుసార్లు నడపదు.
మీ Forward URLకు ప్రతి ఫార్వర్డ్కు చేసే ప్రయత్నాలు, ఒక్కొక్కటి 2xx కోసం 10 సెకన్లు వేచి ఉంటుంది, సుమారు 33 గంటలలో.
WhatsApp వెబ్హుక్ను Meta ఎప్పుడు మళ్లీ పంపుతుంది?
మీ ఎండ్పాయింట్కు చేసిన డెలివరీకి HTTP 200 కాకుండా మరేదైనా స్టేటస్ వచ్చినప్పుడు, లేదా అసలు డెలివరీ కాలేనప్పుడు. Meta వెంటనే మళ్లీ పంపుతుంది, ఆ తర్వాత రాబోయే 7 రోజుల్లో తగ్గుతున్న తరచుదనంతో మరికొన్ని సార్లు పంపుతుంది, ఆ తర్వాత అంగీకరించని వాటిని వదిలేస్తుంది. ఆ ఫీల్డ్ కోసం WhatsApp బిజినెస్ ఖాతాకు సబ్స్క్రైబ్ అయిన ప్రతి యాప్కు మళ్లీ పంపడం జరుగుతుంది, అందుకే అవి డూప్లికేట్ నోటిఫికేషన్లను సృష్టించగలవని Meta హెచ్చరిస్తుంది. గత వెబ్హుక్లను తిరిగి పొందడానికి API లేదు, కాబట్టి 7 రోజులు గడిచిన డెలివరీ మీ సిస్టమ్కు పోతుంది.
సర్వర్ హెల్త్ బాగున్నప్పటికీ డూప్లికేట్లు ఎందుకు వస్తాయి?
ఎందుకంటే మీ వైపు డెలివరీ విజయవంతం కావచ్చు, అయినా Meta కి అది విఫలమైనట్టు కనిపించవచ్చు. సమాధానం ఇవ్వడానికి ముందు పనిని చేసే హ్యాండ్లర్ Meta వేచి ఉండే సమయాన్ని దాటిపోవచ్చు, దాంతో మీరు ఇప్పటికే ప్రాసెస్ చేసిన దాన్ని Meta మళ్లీ పంపుతుంది. అభ్యర్థన మధ్యలో సర్వర్ను రీస్టార్ట్ చేసే డిప్లాయ్మెంట్, కొద్దిసేపు 502 ఇచ్చే లోడ్ బ్యాలెన్సర్, లేదా 200 బదులు 201 లేదా 204 రావడం, ఇవన్నీ వైఫల్యాలుగా లెక్కించబడతాయి. బ్యాచ్లు మరో కేసును జోడిస్తాయి: ఒకే POST లో అనేక అప్డేట్లు ఉండవచ్చు, కాబట్టి పెద్ద బ్యాచ్పై టైమ్అవుట్ వస్తే, మీరు ఇప్పటికే హ్యాండిల్ చేసిన అప్డేట్లతో సహా మొత్తం బ్యాచ్ తిరిగి వస్తుంది.
ఏ కీతో డూప్లికేట్లను తొలగించాలి?
Meta సొంత IDలు, ఈవెంట్ రకాన్ని బట్టి ఎంచుకున్నవి, ఎందుకంటే ఒక మెసేజ్ సహజంగానే అనేక వెబ్హుక్లను ఉత్పత్తి చేస్తుంది. స్టేటస్ విలువ లేని స్టేటస్ కీ delivered ను sent కు కాపీలుగా భావించి తీసేస్తుంది, మరియు కాల్ ఈవెంట్ లేని కాల్ కీ కాల్ మొదటి దశను మాత్రమే ఉంచుతుంది. కీలను ప్రత్యేక ఇండెక్స్తో నిల్వ చేయండి, తద్వారా ఒకే మళ్లీ ప్రయత్నాన్ని నిర్వహిస్తున్న ఇద్దరు వర్కర్లు ఇద్దరూ గెలవలేరు:
వెబ్హుక్లు ఏ క్రమంలో వస్తాయి?
జరిగిన క్రమంలోనే వస్తాయని కచ్చితంగా చెప్పలేం. Meta డాక్యుమెంటేషన్ క్రమానికి హామీ ఇవ్వదు, మళ్లీ పంపిన డెలివరీ కొత్తవాటి తర్వాత చేరుతుంది, మరియు స్టేటస్ ఒక దశను దాటేయవచ్చు: మెసేజ్ వచ్చిన వెంటనే చదివితే, Meta delivered లేకుండా read పంపుతుంది. కాబట్టి ఈవెంట్లను వాటి సొంత టైమ్స్టాంప్ ఫీల్డ్తో నిల్వ చేయండి, స్టేటస్ను అందిన క్రమంతో కాకుండా ర్యాంక్ ద్వారా పోల్చండి, మరియు ఆలస్యంగా వచ్చిన పాత కస్టమర్ మెసేజ్ కంటే తర్వాత వచ్చిన కొత్త మెసేజ్ గెలిచేలా చూడండి. Coexistence నంబర్పై ఒకసారి జరిగే హిస్టరీ ఇంపోర్ట్ ఆన్బోర్డింగ్ చుట్టూ లైవ్ మెసేజ్లతో అతివ్యాప్తి కావచ్చు, మరియు ఆ రెండింటిని సరిచేసేది మెసేజ్ ID.
సురక్షిత హ్యాండ్లర్ ఎలా ఉంటుంది?
నాలుగు దశలు: ధృవీకరించండి, ఖచ్చితంగా 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 మళ్లీ పంపదు. ప్రతి ఇన్కమింగ్ మెసేజ్ ID 7 రోజుల పాటు ఉంచబడుతుంది, అంటే Meta మళ్లీ ప్రయత్నించే కాలం, మరియు మళ్లీ పంపిన మెసేజ్ గుర్తించబడుతుంది, రెండవ ఆటోమేషన్ రిప్లై ట్రిగర్ చేయదు.
బయటికి మీ Forward URLకు వెళ్లేటప్పుడు, ప్రతి Meta మార్పు ఒక డెలివరీగా మారుతుంది, X-EC-Delivery లో ఒకే ID తో, ఇది ఫార్వర్డ్ ప్రయత్నాల మధ్య మారదు: ప్రతిదానికి 2xx కోసం 10 సెకన్లు వేచి, సుమారు 33 గంటల్లో 7 ప్రయత్నాలు. 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 బిజినెస్ యాప్లోనే ఉంటాయి, కాబట్టి వ్యాపారం అక్కడి నుండే సమాధానం ఇవ్వగలదు.
మిస్ అయిన వెబ్హుక్లను రీప్లే చేయవచ్చా?
Meta నుండి కాదు: గత వెబ్హుక్ డేటా కోసం API లేదు. Coexistence నంబర్ యొక్క ఒకసారి జరిగే హిస్టరీ ఇంపోర్ట్ ఆన్బోర్డింగ్ సమయంలో మాత్రమే నడుస్తుంది, మరియు అదే కనెక్షన్ కోసం మళ్లీ అభ్యర్థించలేరు.
Meta ఒకే అప్డేట్ను ఒకటి కంటే ఎక్కువ సర్వర్లకు పంపుతుందా?
ఆ ఫీల్డ్ కోసం WhatsApp బిజినెస్ ఖాతాకు సబ్స్క్రైబ్ అయిన ప్రతి యాప్కు పంపుతుంది. డెస్టినేషన్ ఓవర్రైడ్తో, ఆ నంబర్ యొక్క మెసేజ్ ఫీల్డ్లు ఆ యాప్ డిఫాల్ట్ కాల్బ్యాక్కు బదులుగా ఓవర్రైడ్ URLకు వెళ్తాయి.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ