Ponovni pokušaji, duplikati i redoslijed WhatsApp webhookova: kako ih obraditi
Meta ponovno šalje webhook za WhatsApp kojem nije vraćen HTTP 200, odmah, a zatim sve rjeđe, do 7 dana, nakon čega ga odbacuje. Ponovni pokušaji idu svakoj aplikaciji pretplaćenoj na račun, pa su duplikati uobičajeni. Odgovorite 200 brzo, deduplicirajte po ID-u poruke ili po ID-u statusa uz sam status te sortirajte događaje po njihovim vlastitim vremenskim oznakama.
easyCoexistence povezuje vaš broj WhatsApp Business aplikacije s Metinim Cloud API-jem putem Coexistence povezivanja i upija Metine ponovne isporuke prije nego ih vaše automatizacije vide, pa ponovno poslana poruka ne dobije drugi AI odgovor.
Koliko dugo Meta ponavlja webhook koji nije dobio HTTP 200, prije nego ga odbaci.
Većinu ažuriranja Meta šalje grupirano u jednom POST zahtjevu; Meta ne jamči grupiranje, pa svaki zahtjev obrađujte zasebno.
Najveći payload koji WhatsApp webhook POST može nositi.
Koliko dugo easyCoexistence pamti ID svake dolazne poruke, da ponovno isporučena poruka ne pokrene automatizaciju dvaput.
Pokušaji po prosljeđivanju na vaš Forward URL, svaki čeka 10 sekundi na 2xx, ukupno oko 33 sata.
Kada Meta ponavlja WhatsApp webhook?
Kad isporuka na vaš endpoint dobije HTTP status različit od 200 ili uopće ne može biti isporučena. Meta ponavlja odmah, zatim još nekoliko puta sve rjeđe tijekom sljedećih 7 dana, a ono što ostane neprihvaćeno nakon toga odbacuje. Ponovni pokušaji idu svakoj aplikaciji pretplaćenoj na WhatsApp Business Account za to polje, zbog čega Meta upozorava da mogu stvoriti duplicirane obavijesti. Ne postoji API za dohvat prošlih webhookova, pa isporuka koja istekne nakon 7 dana ostaje izgubljena za vaš sustav.
Zašto se duplikati pojavljuju i kad je vaš poslužitelj ispravan?
Zato što isporuka može uspjeti na vašoj strani, a Meta je ipak vidi kao neuspjelu. Obrađivač koji prvo radi posao, a tek onda odgovara, može prekoračiti Metino čekanje, pa Meta ponovi nešto što ste već obradili. Ponovna isporuka nove verzije koja pokrene poslužitelj usred zahtjeva, load balancer koji na trenutak vrati 502 ili odgovor 201 ili 204 umjesto 200 smatraju se neuspjesima. Serije dodaju još jedan slučaj: jedan POST može sadržavati mnogo ažuriranja, pa istek vremena na velikoj seriji vraća cijelu seriju, uključujući ažuriranja koja ste već obradili.
Po kojem ključu deduplicirati?
Po Metinim vlastitim ID-ovima, odabranim za svaki tip događaja, jer jedna poruka legitimno proizvodi više webhookova. Ključ statusa bez vrijednosti statusa izbacio bi delivered i read kao kopije sent, a ključ poziva bez događaja zadržao bi samo prvu fazu poziva. Ključeve pohranite s jedinstvenim indeksom, da dva radnika koja obrađuju isti ponovni pokušaj ne mogu oba uspjeti:
Kojim redoslijedom stižu webhookovi?
Ne nužno redoslijedom kojim su se stvari dogodile. Meta u dokumentaciji ne jamči redoslijed, ponovno isporučeni zahtjev stiže nakon novijih, a status može preskočiti korak: Meta šalje read bez delivered kad se poruka pročita čim stigne. Zato događaje pohranjujte s vlastitim poljem vremenske oznake, usporedite status po rangu, a ne po dolasku, i neka kasnija poruka kupca nadjača raniju koja je stigla kasno. Na Coexistence broju jednokratni uvoz povijesti može se preklapati s porukama uživo oko postavljanja, a ID poruke ih usklađuje.
Kako izgleda siguran obrađivač?
Četiri koraka: provjerite, odgovorite točno 200, deduplicirajte, pa obradite iz reda čekanja, tako da između Metina zahtjeva i vašeg odgovora ništa sporo ne stoji. Ova verzija provjerava X-Hub-Signature-256 tajnim ključem vlastite Meta aplikacije. Za broj povezan preko easyCoexistence Meta potpisuje tajnim ključem easyCoexistence aplikacije, pa izravno odredište zato provjerava autentičnost dugom tajnom u putanji URL-a ili prelazi na upravljano prosljeđivanje potpisano po broju.
// 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);Kako easyCoexistence upravlja ponovnim pokušajima na povezanom broju?
Na ulazu easyCoexistence provjerava Metin potpis, odgovara 200 i pokreće automatizacije nakon odgovora, pa Meta ne ponavlja zahtjev zato što AI odgovor traje nekoliko sekundi. Svaki ID dolazne poruke čuva se 7 dana, koliko traje Metin prozor za ponovne pokušaje, a ponovno isporučena poruka prepoznaje se i ne pokreće drugi automatski odgovor.
Na izlazu prema vašem Forward URL-u svaka Meta promjena postaje jedna isporuka s ID-om u X-EC-Delivery koji ostaje isti kroz ponovne pokušaje prosljeđivanja: 7 pokušaja tijekom oko 33 sata, svaki čeka 10 sekundi na 2xx. Promjenu koju Meta sama ponovno isporuči prosljeđuje se opet pod novim ID-om isporuke, pa deduplicirajte i po Metinim ID-ovima unutar polja value.
Uobičajene pogreške
- Deduplikacija statusa samo po ID-u. sent, delivered i read dijele wamid, pa ključ mora sadržavati i status.
- Obrada prije odgovora. Spor obrađivač tjera Metu da ponovi posao koji ste već obavili; prvo vratite 200, pa radite iz reda čekanja.
- Vraćanje 201 ili 204. Metina dokumentacija svaki status osim 200 tretira kao neuspjelu isporuku i ponavlja je.
- Deduplikacija prosljeđivanja samo po X-EC-Delivery. Promjena koju Meta ponovno isporuči stiže pod novim ID-om isporuke; Metin ID držite kao drugi ključ.
Prosljeđivanja na vaš poslužitelj su potpisana, u redu čekanja i ponovno se pokušavaju, a svaki broj nadzire se 24/7. Od US$ 9 do US$ 0,75 po povezanom broju mjesečno, uz pad kako dodajete brojeve, uz besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Koliko dugo trebam čuvati ID-ove koje sam već vidio?
Najmanje 7 dana, koliko traje Metin prozor za ponovne pokušaje. Isporuka koju Meta ponovi šestog dana mora i dalje odgovarati svom ključu, inače će se obraditi kao nova.
Što se događa s porukama mojih kupaca ako je moj endpoint nedostupan danima?
Meta ponavlja do 7 dana, a zatim odbacuje webhookove. Na Coexistence broju razgovori su i dalje u WhatsApp Business aplikaciji na telefonu, pa tvrtka može odgovoriti odatle.
Mogu li ponovno dohvatiti webhookove koje sam propustio?
Od Mete ne, jer ne postoji API za povijesne webhook podatke. Jednokratni uvoz povijesti Coexistence broja pokreće se samo pri postavljanju i za istu vezu ne može se ponovno zatražiti.
Šalje li Meta isto ažuriranje na više poslužitelja?
Šalje ga svakoj aplikaciji pretplaćenoj na WhatsApp Business Account za to polje. Uz zamjensko odredište, polja poruka tog broja idu na zamjenski URL umjesto na zadani callback te aplikacije.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na