WhatsApp வெப்ஹூக் மறுமுயற்சிகள், நகல்கள் மற்றும் வரிசை: எவ்வாறு கையாள்வது
HTTP 200 அல்லாத வேறெதைப் பெற்றாலும் Meta WhatsApp வெப்ஹூக்கை உடனடியாக மீண்டும் அனுப்பும்; பின்னர் 7 நாட்கள் வரை குறையும் இடைவெளியில் முயற்சிக்கும், அதன் பிறகு கைவிடும். மீண்டும் அனுப்புதல்கள் WhatsApp Business கணக்குடன் இணைக்கப்பட்ட ஒவ்வொரு ஆப்புக்கும் செல்லும், எனவே நகல்கள் இயல்பானவை. 200 என விரைவாகப் பதிலளியுங்கள், செய்தி id அல்லது status id மற்றும் status அடிப்படையில் நகல் நீக்குங்கள், நிகழ்வுகளை அவற்றின் சொந்த நேர முத்திரைகளால் வரிசைப்படுத்துங்கள்.
easyCoexistence உங்கள் WhatsApp Business ஆப் எண்ணை Coexistence வழியாக Meta-வின் Cloud API உடன் இணைக்கிறது, உங்கள் தானியங்கிகள் பார்ப்பதற்கு முன்பே Meta-வின் மீண்டும் அனுப்புதல்களை உள்வாங்குகிறது, அதனால் மீண்டும் வரும் செய்திக்கு இரண்டாவது AI பதில் கிடைக்காது.
HTTP 200 பெறாத வெப்ஹூக்கை கைவிடுவதற்கு முன் Meta எவ்வளவு காலம் மீண்டும் முயற்சிக்கிறது.
பெரும்பாலான புதுப்பிப்புகளை Meta ஒரே POST ஆகத் தொகுக்கிறது; தொகுப்பதை Meta உறுதியளிக்காததால், ஒவ்வொரு கோரிக்கையையும் தனியாகக் கையாளுங்கள்.
WhatsApp வெப்ஹூக் POST சுமக்கக்கூடிய மிகப் பெரிய பேலோட்.
ஒரு மீண்டும் வரும் செய்தி தானியங்கியை இரண்டு முறை இயக்காமல் இருக்க, easyCoexistence ஒவ்வொரு உள்வரும் செய்தி id-ஐயும் எவ்வளவு காலம் நினைவில் வைத்திருக்கிறது.
Forward URL-க்கு ஒவ்வொரு forward-க்கும் முயற்சிகள், ஒவ்வொன்றும் 2xx-க்காக 10 வினாடிகள் காத்திருக்கும், சுமார் 33 மணி நேரத்தில்.
Meta எப்போது WhatsApp வெப்ஹூக்கை மீண்டும் முயற்சிக்கிறது?
உங்கள் எண்ட்பாயிண்ட்டுக்கான ஒரு டெலிவரி HTTP 200 அல்லாத நிலையைப் பெறும்போது, அல்லது முற்றிலும் வழங்க முடியாதபோது எப்போதும். Meta உடனடியாக மீண்டும் முயற்சிக்கும், பின்னர் அடுத்த 7 நாட்களில் குறையும் இடைவெளியில் இன்னும் சில முறை, அதன் பிறகு இன்னும் ஒப்புக்கொள்ளப்படாதவற்றை கைவிடும். மீண்டும் முயற்சிகள் அந்தப் புலத்திற்காக WhatsApp Business கணக்குடன் இணைக்கப்பட்ட ஒவ்வொரு ஆப்புக்கும் செல்லும்; அதனால்தான் அவை நகல் அறிவிப்புகளை உருவாக்கக்கூடும் என்று Meta எச்சரிக்கிறது. கடந்த வெப்ஹூக்குகளைப் பெற API இல்லை, எனவே 7 நாட்கள் முடியும் டெலிவரி உங்கள் அமைப்புக்கு இழக்கப்படும்.
உங்கள் சர்வர் சரியாக இயங்கும்போதும் நகல்கள் ஏன் வருகின்றன?
ஏனெனில் ஒரு டெலிவரி உங்கள் பக்கத்தில் வெற்றிகரமாக இருக்கலாம், ஆனாலும் Meta-வுக்கு தோல்வியாகத் தெரியலாம். பதிலளிப்பதற்கு முன் வேலையைச் செய்யும் ஒரு ஹேண்ட்லர் Meta-வின் காத்திருப்பைத் தாண்டலாம், அதனால் நீங்கள் ஏற்கனவே செயலாக்கியதை Meta மீண்டும் முயற்சிக்கிறது. பதிலுக்கு முன் சர்வரை மறுதொடக்கம் செய்யும் deploy, ஒரு கணம் 502 திருப்பும் load balancer, அல்லது 200க்குப் பதிலாக 201 அல்லது 204 ஆகியவை எல்லாம் தோல்விகளாகக் கணக்கிடப்படும். தொகுப்புகள் இன்னொரு நிலையைச் சேர்க்கின்றன: ஒரு POST-இல் பல புதுப்பிப்புகள் இருக்கலாம், எனவே பெரிய தொகுப்பில் ஏற்படும் timeout முழு தொகுப்பையும் திருப்பி அனுப்பும், நீங்கள் ஏற்கனவே கையாண்ட புதுப்பிப்புகளும் அடங்கும்.
எந்த key-ஐ வைத்து நகல் நீக்க வேண்டும்?
Meta-வின் சொந்த id-கள், நிகழ்வு வகை வாரியாகத் தேர்ந்தெடுக்கப்பட்டவை, ஏனெனில் ஒரு செய்தி சட்டபூர்வமாக பல வெப்ஹூக்குகளை உருவாக்குகிறது. status மதிப்பு இல்லாத status key, delivered மற்றும் read ஐ sent-இன் நகல்களாகக் கைவிடும்; event இல்லாத call key, அழைப்பின் முதல் நிலையை மட்டுமே வைத்திருக்கும். key-களை unique index உடன் சேமியுங்கள், அப்போது ஒரே மீண்டும் முயற்சியைக் கையாளும் இரண்டு workers வெற்றி பெற முடியாது:
வெப்ஹூக்குகள் எந்த வரிசையில் வருகின்றன?
நிகழ்ந்த வரிசையில் அவசியமில்லை. Meta-வின் ஆவணங்கள் வரிசைக்கு எந்த உறுதியும் அளிக்கவில்லை, மீண்டும் முயற்சித்த டெலிவரி புதிய நிகழ்வுகளுக்குப் பின்னர் வந்துசேரும், மேலும் ஒரு status ஒரு படியைத் தவிர்க்கலாம்: செய்தி வந்த உடனேயே படிக்கப்பட்டால் Meta delivered இல்லாமல் read ஐ அனுப்புகிறது. எனவே நிகழ்வுகளை அவற்றின் சொந்த timestamp புலத்துடன் சேமியுங்கள், status-ஐ வருகை நேரத்தால் அல்ல, தரவரிசையால் ஒப்பிடுங்கள், தாமதமாக வந்த பழைய செய்தியை விட பின்னர் வந்த வாடிக்கையாளர் செய்தி வெற்றி பெறட்டும். Coexistence எண்ணில், ஒரு முறை நடக்கும் வரலாற்று இறக்குமதி ஆன்போர்டிங் நேரத்தில் நேரடி செய்திகளுடன் ஒன்றுடன் ஒன்று மேலெழலாம், அந்த இரண்டையும் ஒத்திசைப்பது செய்தி id தான்.
பாதுகாப்பான ஹேண்ட்லர் எப்படி இருக்கும்?
நான்கு படிகள்: சரிபார்க்கவும், சரியாக 200 பதிலளிக்கவும், நகல் நீக்கவும், பின்னர் வரிசையிலிருந்து வேலை செய்யவும், அதனால் Meta-வின் கோரிக்கைக்கும் உங்கள் பதிலுக்கும் இடையில் மெதுவான எதுவும் இருக்காது. இந்தப் பதிப்பு X-Hub-Signature-256 ஐ உங்கள் சொந்த Meta ஆப்பின் secret உடன் சரிபார்க்கிறது; easyCoexistence வழியாக இணைக்கப்பட்ட எண்ணுக்கு, Meta easyCoexistence-இன் ஆப் secret உடன் கையொப்பமிடுகிறது, எனவே நேரடி இலக்கு அதற்குப் பதிலாக URL பாதையில் நீண்ட secret உடன் அங்கீகரிக்கிறது, அல்லது ஒவ்வொரு எண்ணுக்கும் கையொப்பமிடப்பட்ட நிர்வகிக்கப்பட்ட forwarding-க்கு மாறுகிறது.
// 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 உடன் ஒரு டெலிவரியாகிறது, அது forward மீண்டும் முயற்சிகள் முழுவதும் அப்படியே இருக்கும்: சுமார் 33 மணி நேரத்தில் 7 முயற்சிகள், ஒவ்வொன்றும் 2xx-க்காக 10 வினாடிகள் காத்திருக்கும். Meta தானே மீண்டும் அனுப்பிய மாற்றம் புதிய டெலிவரி id உடன் மீண்டும் forward ஆகும், எனவே value-க்குள் உள்ள Meta id-களின் அடிப்படையிலும் நகல் நீக்குங்கள்.
பொதுவான தவறுகள்
- id மட்டும் கொண்டு statuses-ஐ நகல் நீக்குவது. sent, delivered மற்றும் read ஒரே wamid-ஐப் பகிர்கின்றன, அதனால் key-க்கு status-உம் தேவை.
- பதிலளிக்கும் முன் செயலாக்குவது. மெதுவான ஹேண்ட்லர் நீங்கள் ஏற்கனவே செய்த வேலையை Meta மீண்டும் முயற்சிக்கச் செய்கிறது; முதலில் 200 திருப்புங்கள், பின்னர் வரிசையிலிருந்து வேலை செய்யுங்கள்.
- 201 அல்லது 204 திருப்புவது. 200 அல்லாத எந்த நிலையையும் Meta-வின் ஆவணம் தோல்வியுற்ற டெலிவரியாகக் கருதி மீண்டும் முயற்சிக்கும்.
- forward-களை X-EC-Delivery மட்டும் கொண்டு நகல் நீக்குவது. Meta மீண்டும் அனுப்பிய மாற்றம் புதிய டெலிவரி id உடன் வரும்; Meta-வின் id-களை இரண்டாவது key ஆக வைத்திருங்கள்.
உங்கள் சர்வருக்கான forward-கள் கையொப்பமிடப்பட்டு, வரிசைப்படுத்தப்பட்டு, மீண்டும் முயற்சிக்கப்படுகின்றன, ஒவ்வொரு எண்ணும் 24/7 கண்காணிக்கப்படுகிறது. ஒவ்வொரு எண்ணுக்கும் மாதத்திற்கு US$ 9 முதல் US$ 0.75 வரை, எண்களைச் சேர்க்கச் சேர்க்கக் குறைகிறது, முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
நான் பார்த்த id-களை எவ்வளவு காலம் வைத்திருக்க வேண்டும்?
குறைந்தது 7 நாட்கள், Meta-வின் மீண்டும் முயற்சி சாளரம். ஆறாம் நாளில் Meta மீண்டும் முயற்சிக்கும் டெலிவரி இன்னும் அதன் key உடன் பொருந்த வேண்டும், இல்லையெனில் அது புதியதாகச் செயலாக்கப்படும்.
என் எண்ட்பாயிண்ட் பல நாட்கள் செயலிழந்தால் என் வாடிக்கையாளர்களின் செய்திகளுக்கு என்ன ஆகும்?
Meta 7 நாட்கள் வரை மீண்டும் முயற்சித்து பின்னர் வெப்ஹூக்குகளைக் கைவிடும். Coexistence எண்ணில் உரையாடல்கள் இன்னும் தொலைபேசியில் உள்ள WhatsApp Business ஆப்பில் இருக்கும், அதனால் வணிகம் அங்கிருந்து பதிலளிக்கலாம்.
நான் தவறவிட்ட வெப்ஹூக்குகளை மீண்டும் இயக்க முடியுமா?
Meta-விடமிருந்து இல்லை: வரலாற்று வெப்ஹூக் தரவுக்கு API இல்லை. Coexistence எண்ணின் ஒரு முறை வரலாற்று இறக்குமதி ஆன்போர்டிங்கில் மட்டுமே இயங்கும், அதே இணைப்புக்கு மீண்டும் கோர முடியாது.
Meta ஒரே புதுப்பிப்பை ஒன்றுக்கு மேற்பட்ட சர்வர்களுக்கு அனுப்புகிறதா?
அந்தப் புலத்திற்காக WhatsApp Business கணக்குடன் இணைக்கப்பட்ட ஒவ்வொரு ஆப்புக்கும் அனுப்புகிறது. இலக்கு மேலெழுதல் இருந்தால், எண்ணின் செய்தி புலங்கள் அந்த ஆப்பின் இயல்பு callback-க்குப் பதிலாக மேலெழுதல் URL-க்குச் செல்லும்.
தொடர்ந்து படிக்கவும்
தொடங்கத் தயாரா?
மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.
இலவச ட்ரையலைத் தொடங்குங்கள்இதில் சரிபார்க்கப்பட்டது: