Prijavite seZapočnite besplatni probni period
Meta Tech Provider

WhatsApp webhook ponovni pokušaji, duplikati i redosled: kako ih obraditi

Meta ponovo šalje WhatsApp webhook koji ne dobije HTTP 200, odmah, a zatim sve ređe, do 7 dana, i posle toga ga odbacuje. Ponovni pokušaji idu svakoj aplikaciji pretplaćenoj na nalog, pa su duplikati normalni. Odgovorite 200 brzo, uklonite duplikate po ID-ju poruke ili po ID-ju statusa plus statusu, i poredajte događaje po sopstvenim vremenskim oznakama.

easyCoexistence povezuje vaš broj WhatsApp Business aplikacije sa Metinim Cloud API-jem preko Coexistence i apsorbuje Metina ponovna slanja pre nego što ih vaše automatizacije vide, pa ponovo poslata poruka ne dobija drugi AI odgovor.

7 days

Koliko dugo Meta nastavlja da ponavlja webhook koji nije dobio HTTP 200, pre nego što ga odbaci.

1,000

Većinu ažuriranja Meta grupiše u jedan POST; Meta ne garantuje grupisanje, pa svaki zahtev obrađujte zasebno.

3 MB

Najveći payload koji WhatsApp webhook POST može da nosi.

7 days

Koliko dugo easyCoexistence pamti ID svake dolazne poruke, kako ponovno isporučena poruka ne bi dvaput pokrenula automatizaciju.

7 attempts

Pokušaja po prosleđivanju na vaš Forward URL, svaki čeka 10 sekundi na 2xx, u ukupno oko 33 sata.

Kada Meta ponovo šalje WhatsApp webhook?

Kada isporuka na vaš endpoint dobije HTTP status različit od 200 ili uopšte ne može da se isporuči. Meta ponovo šalje odmah, pa još nekoliko puta sa sve manjom učestalošću tokom narednih 7 dana, a ono što ostane bez potvrde posle toga odbacuje. Ponovni pokušaji idu svakoj aplikaciji pretplaćenoj na WhatsApp Business nalog za to polje, zbog čega Meta upozorava da mogu da izazovu duplirana obaveštenja. Ne postoji API za preuzimanje prošlih webhookova, pa isporuka koja istekne posle 7 dana ostaje izgubljena za vaš sistem.

Zašto se duplikati pojavljuju i kada je server ispravan?

Zato što isporuka može da uspe na vašoj strani, a da Meta ipak vidi neuspeh. Obrađivač koji radi posao pre odgovora može da pređe Metino vreme čekanja, pa Meta ponovo šalje nešto što ste već obradili. Restart servera usred zahteva tokom deploy-a, load balancer koji na trenutak vrati 502, ili 201 ili 204 umesto 200, sve se računa kao neuspeh. Grupisanje dodaje još jedan slučaj: jedan POST može da sadrži mnogo ažuriranja, pa timeout na velikoj grupi vraća celu grupu, uključujući ažuriranja koja ste već obradili.

Po kom ključu treba deduplikovati?

Po Meta-inim ID-jevima, odabranim za svaki tip događaja, jer jedna poruka legitimno proizvodi nekoliko webhookova. Ključ za status bez vrednosti statusa bi odbacio delivered i read kao kopije sent, a ključ za poziv bez događaja zadržao bi samo prvu fazu poziva. Čuvajte ključeve sa jedinstvenim indeksom, da dva radnika koja obrađuju isti ponovni pokušaj ne mogu oba da prođu:

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.

Kojim redosledom stižu webhookovi?

Ne nužno onim redosledom kojim su se stvari dogodile. Meta u dokumentaciji ne obećava redosled, ponovno isporučen zahtev stiže posle novijih, a status može da preskoči korak: Meta šalje read bez delivered kada se poruka pročita čim stigne. Zato događaje čuvajte sa sopstvenim poljem vremenske oznake, statuse upoređujte po rangu, a ne po dolasku, i neka kasnija poruka klijenta pobedi raniju koja je stigla kasno. Na Coexistence broju jednokratni uvoz istorije može da se preklopi sa živim porukama oko onboardinga, a ID poruke je ono što ih usklađuje.

Kako izgleda bezbedan obrađivač?

Četiri koraka: proverite, vratite tačno 200, deduplikujte, pa radite iz reda čekanja, tako da ništa sporo ne stoji između Metinog zahteva i vašeg odgovora. Ova verzija proverava X-Hub-Signature-256 tajnim ključem sopstvene Meta aplikacije; za broj povezan preko easyCoexistence, Meta potpisuje tajnim ključem easyCoexistence aplikacije, pa direktno odredište autentifikuje dugim tajnim ključem u putanji URL-a ili prelazi na upravljano prosleđivanje potpisano po broju.

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);

Kako easyCoexistence obrađuje ponovne pokušaje na povezanom broju?

Na ulazu, easyCoexistence proverava Metin potpis, odgovara 200 i pokreće automatizacije posle odgovora, pa Meta ne ponavlja zahtev zato što je AI odgovor trajao nekoliko sekundi. ID svake dolazne poruke čuva se 7 dana, koliko traje Metin prozor za ponavljanje, a ponovo isporučena poruka se prepoznaje i ne pokreće drugi automatski odgovor.

Na izlazu ka vašem Forward URL-u, svaka Meta promena postaje jedna isporuka sa ID-jem u X-EC-Delivery koji ostaje isti kroz sve ponovne pokušaje prosleđivanja: 7 pokušaja u ukupno oko 33 sata, svaki čeka 10 sekundi na 2xx. Promena koju Meta sama ponovo isporučuje prosleđuje se ponovo pod novim ID-jem isporuke, zato i unutar value deduplikujte po Meta-inim ID-jevima.

Česte greške

  • Deduplikacija statusa samo po ID-ju. sent, delivered i read dele wamid, pa ključu treba i status.
  • Obrada pre odgovora. Spor obrađivač izaziva da Meta ponovo šalje posao koji ste već uradili; prvo vratite 200, pa radite iz reda čekanja.
  • Vraćanje 201 ili 204. Metina dokumentacija tretira svaki status osim 200 kao neuspešnu isporuku i ponavlja je.
  • Deduplikacija prosleđivanja samo po X-EC-Delivery. Promena koju Meta ponovo isporuči stiže pod novim ID-jem isporuke; Metin ID ostavite kao drugi ključ.
Ovo radite uz EasyCoexistence

Prosleđivanja vašem serveru su potpisana, stavljena u red i ponovo pokušavana, a svaki broj se prati 24/7. Od US$ 9 do US$ 0.75 po broju mesečno, uz pad kako dodajete brojeve, sa prva 3 dana besplatno.

Često postavljana pitanja

Koliko dugo treba da čuvam ID-jeve koje sam već video?

Najmanje 7 dana, koliko traje Metin prozor za ponavljanje. Isporuka koju Meta ponovo šalje šestog dana mora i dalje da odgovara svom ključu, inače će biti obrađena kao nova.

Šta se dešava sa porukama mojih klijenata 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 firma može da odgovara odatle.

Mogu li ponovo da pustim webhookove koje sam propustio?

Ne preko Mete: ne postoji API za istorijske podatke webhookova. Jednokratni uvoz istorije Coexistence broja pokreće se samo pri onboardingu i ne može ponovo da se zatraži za istu vezu.

Da li Meta šalje isto ažuriranje na više servera?

Šalje ga svakoj aplikaciji pretplaćenoj na WhatsApp Business nalog za to polje. Uz preusmeravanje odredišta, polja poruka broja idu na URL preusmeravanja umesto na podrazumevani callback te aplikacije.

Nastavite sa čitanjem

Spremni da počnete?

Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.

Započnite besplatni probni period

Provereno na