WhatsApp webhook retry, අනුපිටපත් සහ පිළිවෙළ: ඒවා හසුරුවන ආකාරය
HTTP 200 නොවන ඕනෑම දෙයක් ලැබුණු WhatsApp webhook එකක් Meta වහාම, පසුව අඩු වාර ගණනකින් දින 7ක් දක්වා retry කරයි, ඉන් පසු එය අතහරියි. Retry සියලු subscribed app වලට යන බැවින් අනුපිටපත් සාමාන්යයි. 200 වහාම ප්රතිචාර දක්වන්න, message id හෝ status id සහ status මත deduplicate කරන්න, සහ events ඒවායේ තමන්ගේම timestamp වලින් පිළිවෙළ කරන්න.
easyCoexistence ඔබේ WhatsApp Business app අංකය Coexistence හරහා Meta ගේ Cloud API වෙත සම්බන්ධ කර, ඔබේ automations දකින්නට පෙර Meta ගේ නැවත delivery අවශෝෂණය කරයි, එබැවින් retry කළ පණිවිඩයකට දෙවන AI පිළිතුරක් නොලැබේ.
Meta, HTTP 200 නොලැබුණු webhook එකක් අතහැරීමට පෙර කොපමණ කාලයක් retry කරයිද.
බොහෝ updates Meta එක POST එකකට batch කරයි; batching සහතික නොකරන බැවින් සෑම request එකක්ම තනිව හසුරුවන්න.
WhatsApp webhook POST එකකට ගෙන යා හැකි විශාලතම payload එක.
easyCoexistence සෑම ingress message id එකක්ම කොපමණ කාලයක් මතක තබා ගන්නේද, එවිට නැවත ලැබුණු පණිවිඩයක් automation එකක් දෙවරක් ක්රියාත්මක නොකරයි.
Forward URL එකට forward එකකට උත්සාහ, එක් එක් 2xx සඳහා තත්පර 10ක් රැඳී, පැය 33ක් පමණ කාලයක් තුළ.
WhatsApp webhook එකක් Meta කවදා retry කරයිද?
HTTP 200 නොවන status එකක් ලැබෙන විට හෝ delivery එක කිසිසේත් කළ නොහැකි විට Meta retry කරයි. වහාම retry කර, පසුව ඊළඟ දින 7 තුළ අඩු වාර ගණනකින් තවත් කිහිප වරක් retry කර, ඉන් පසු තවමත් පිළිගැනීමක් නොලැබුණු දේ අතහරියි. Retry, එම field සඳහා WhatsApp Business Account එකට subscribed සියලු app වලටම යන බැවින් අනුපිටපත් notifications ඇති විය හැකි බව Meta අනතුරු ඇඟවීය. අතීත webhooks ලබා ගැනීමට API එකක් නැත, එබැවින් දින 7 ඉක්මවන delivery එකක් ඔබේ පද්ධතියට අහිමි වේ.
ඔබේ server health හොඳ වුවත් අනුපිටපත් ලැබෙන්නේ ඇයි?
Delivery එකක් ඔබේ පැත්තේ සාර්ථක වුවද Meta ට අසාර්ථක ලෙස පෙනිය හැකි බැවිනි. ප්රතිචාර දීමට පෙර වැඩ කරන handler එකක් Meta ගේ බලාපොරොත්තු කාලය පසු කර, ඔබ දැනටමත් සකසා ඇති දෙයක් Meta retry කරයි. Deploy එකක් මගින් request එකක් මැද server එක restart කිරීම, load balancer එක මොහොතකට 502 ලබා දීම, හෝ 200 වෙනුවට 201 හෝ 204 ලබා දීම සියල්ල අසාර්ථක ලෙස ගණන් ගනී. Batches තවත් එක් අවස්ථාවක් එකතු කරයි: එක් POST එකක updates බොහෝ ගණනක් තිබිය හැකි බැවින්, විශාල batch එකකදී timeout වීමක් මුළු batch එක ආපසු ගෙනෙයි, ඔබ දැනටමත් හසුරුවා ඇති updates ද ඇතුළුව.
Deduplicate කළ යුත්තේ කුමන key එක මතද?
Meta ගේම ids, event type අනුව තෝරාගත්, මන්ද එක් පණිවිඩයක් නීත්යානුකූලව webhooks කිහිපයක් ජනනය කරයි. Status value නැති status key එකක් delivered සහ read, sent හි පිටපත් ලෙස අතහැරේ, event නැති call key එකක් call හි පළමු අදියර පමණක් තබා ගනී. Keys unique index එකක් සමඟ ගබඩා කරන්න, එවිට එකම retry එක හසුරුවන workers දෙදෙනාට එකවර ජයග්රහණය කළ නොහැක:
Webhooks ලැබෙන්නේ කුමන පිළිවෙළකින්ද?
අවශ්යයෙන්ම සිදුවීම් සිදු වූ පිළිවෙළ නොවේ. Meta ගේ ලේඛනවල පිළිවෙළ සඳහා කිසිදු පොරොන්දුවක් නැත, retry කළ delivery එකක් නව ඒවාට පසුව පැමිණේ, සහ status එකක් පියවරක් මඟ හැරිය හැක: පණිවිඩය පැමිණි මොහොතේම කියවූ විට Meta delivered නොමැතිව read යවයි. එබැවින් events ඒවායේම timestamp field එක සමඟ ගබඩා කරන්න, status එකක් ලැබීමේ පිළිවෙළ මගින් නොව rank මගින් සසඳන්න, සහ පසුව ලැබුණු ගැනුම්කරුගේ පණිවිඩයක් කලින් ලැබුණු එකට වඩා ජයගන්න ඉඩ දෙන්න. Coexistence number එකක onboarding වටා එක් වරක් වන ඉතිහාස ආයාත කිරීම (import) සජීවී පණිවිඩ සමඟ අතිච්ඡාදනය විය හැකි අතර, එම දෙකම සමථයට පත් කරන්නේ message id එකයි.
ආරක්ෂිත handler එකක් කෙසේ පෙනේද?
පියවර හතරක්: සත්යාපනය කරන්න, 200 හරියටම පිළිතුරු දෙන්න, deduplicate කරන්න, ඉන් පසු queue එකකින් වැඩ කරන්න, එවිට Meta ගේ request එකත් ඔබේ response එකත් අතර මන්දගාමී කිසිවක් නොසිටී. මෙම අනුවාදය ඔබේම Meta app එකේ secret සමඟ X-Hub-Signature-256 පරීක්ෂා කරයි; easyCoexistence හරහා සම්බන්ධ කළ අංකයක් සඳහා Meta easyCoexistence ගේ app secret සමඟ අත්සන් කරන බැවින්, සෘජු ගමනාන්තයක් එහි URL path එකේ දිගු secret එකක් සමඟ සත්යාපනය කරයි, නැතහොත් එක් අංකයකට අත්සන් කළ managed 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 සම්බන්ධ අංකයක retry හසුරුවන්නේ කෙසේද?
ඇතුළු වන විට, easyCoexistence Meta ගේ අත්සන පරීක්ෂා කර, 200 පිළිතුරු දී, response එකෙන් පසුව automations ක්රියාත්මක කරයි; එවිට AI පිළිතුරකට තත්පර කිහිපයක් ගත වීම නිසා Meta retry නොකරයි. ලැබුණු සෑම message id එකක්ම දින 7ක් තබා ගනී, එය Meta ගේ retry කවුළුවේ දිග වන අතර, නැවත ලැබුණු පණිවිඩයක් හඳුනාගෙන දෙවන automation පිළිතුරක් ප්රේරණය නොකරයි.
ඔබේ Forward URL එකට පිටව යන විට, Meta ගේ සෑම change එකක්ම X-EC-Delivery තුළ id එකක් සහිත එක් delivery එකක් බවට පත් වන අතර, forward retry අතරතුර එය එකම පවතී: පැය 33ක් පමණ කාලයක් තුළ උත්සාහ 7ක්, එක් එක් 2xx සඳහා තත්පර 10ක් රැඳී. Meta ම නැවත delivery කරන change එකක් නව delivery id එකක් යටතේ නැවත forward වේ, එබැවින් value තුළ Meta ගේ ids මත ද deduplicate කරන්න.
සාමාන්ය වැරදි
- Statuses id එක පමණක් මත deduplicate කිරීම. sent, delivered සහ read එකම wamid එක බෙදා ගන්නා බැවින්, key එකට status එකද අවශ්යයි.
- පිළිතුරු දීමට පෙර සැකසීම. මන්දගාමී handler එකක් Meta ඔබ දැනටමත් කළ වැඩ retry කරවයි; පළමුව 200 ලබා දී queue එකකින් වැඩ කරන්න.
- 201 හෝ 204 ලබා දීම. Meta ගේ ලේඛන 200 නොවන ඕනෑම status එකක් අසාර්ථක delivery එකක් ලෙස සලකා එය retry කරයි.
- X-EC-Delivery මත පමණක් forwards deduplicate කිරීම. Meta නැවත delivery කරන change එකක් නව delivery id එකක් යටතේ පැමිණේ; Meta ගේ ids දෙවන key ලෙස තබා ගන්න.
ඔබේ server වෙත යන forwards අත්සන් කර, queue කර, retry කරයි, සහ සෑම අංකයක්ම 24/7 නිරීක්ෂණය වේ. එක් අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු කරන විට පහත වැටේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
කලින් දුටු ids කොපමණ කාලයක් තබා ගත යුතුද?
අවම වශයෙන් දින 7ක්, Meta ගේ retry කවුළුව. දින හයේ Meta retry කරන delivery එකක් තවමත් එහි key එකට ගැළපිය යුතුය, නැතහොත් එය නව ලෙස සකසනු ඇත.
ඔබේ endpoint දින ගණනාවක් ක්රියා නොකරන්නේ නම් ගැනුම්කරුවන්ගේ පණිවිඩවලට කුමක් වේද?
Meta දින 7 දක්වා retry කර ඉන් පසු webhooks අතහරියි. Coexistence අංකයක සංවාද තවමත් දුරකථනයේ WhatsApp Business app එකේ ඇති බැවින්, ව්යාපාරයට එතැනින් පිළිතුරු දිය හැක.
ඔබ මග හැරුණු webhooks නැවත ධාවනය කළ හැකිද?
Meta වෙතින් නොහැක: අතීත webhook දත්ත සඳහා API එකක් නැත. Coexistence අංකයක එක් වරක් වන ඉතිහාස ආයාත කිරීම onboarding වලදී පමණක් ධාවනය වන අතර, එම සම්බන්ධතාවය සඳහා නැවත ඉල්ලිය නොහැක.
Meta එකම update එක එක් server එකකට වඩා වැඩියෙකට යවයිද?
එය WhatsApp Business Account එකට එම field සඳහා subscribed සෑම app එකටම යවයි. Destination override එකක් සමඟ, අංකයේ message fields එම app එකේ පෙරනිමි callback වෙනුවට override URL එකට යයි.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ