Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

WhatsApp webhook retry, duplicate at order: paano hawakan ang mga ito

Inuulit ng Meta ang WhatsApp webhook na hindi HTTP 200 ang sagot, agad-agad at pagkatapos ay mas bihira, hanggang 7 araw, at tinatanggal ito pagkatapos noon. Ang mga retry ay napupunta sa bawat app na naka-subscribe sa account, kaya normal ang duplicate. Sumagot ng 200 agad, mag-deduplicate gamit ang ID ng mensahe o status ID kasama ang status, at i-order ang mga event ayon sa sarili nilang timestamp.

Ikinokonekta ng easyCoexistence ang inyong WhatsApp Business app na numero sa Cloud API ng Meta sa pamamagitan ng Coexistence at sinasalo ang mga muling delivery ng Meta bago makita ng inyong automation, kaya hindi nakakakuha ng pangalawang AI reply ang mensaheng na-retry.

7 days

Gaano katagal patuloy na nag-re-retry ang Meta sa webhook na hindi nakakuha ng HTTP 200, bago ito tanggalin.

1,000

Karamihan ng update ay pinagsasama ng Meta sa isang POST; hindi ito garantisado, kaya hawakan ang bawat hiling nang hiwalay.

3 MB

Pinakamalaking payload na kayang dalhin ng isang WhatsApp webhook POST.

7 days

Gaano katagal inaalala ng easyCoexistence ang bawat incoming ID ng mensahe, para hindi tumakbo nang dalawang beses ang automation sa mensaheng muling naihatid.

7 attempts

Bilang ng tries bawat forward sa inyong Forward URL, bawat isa naghihintay ng 10 segundo para sa 2xx, sa loob ng mga 33 oras.

Kailan nag-re-retry ang Meta ng WhatsApp webhook?

Tuwing ang delivery sa inyong endpoint ay may HTTP status na hindi 200, o hindi talaga maihatid. Agad itong inuulit ng Meta, saka ilang beses pa sa mas bihirang agwat sa loob ng 7 araw, at tinatanggal ang hindi pa kinikilala pagkatapos nito. Napupunta ang retry sa bawat app na naka-subscribe sa WhatsApp Business Account para sa field na iyon, kaya nagbabala ang Meta na maaari itong maging duplicate na notification. Walang API para kunin ang mga nakaraang webhook, kaya ang delivery na naubos ang 7 araw ay mawawala na sa sistema ninyo.

Bakit may lumalabas na duplicate kahit maayos ang server?

Dahil maaaring magtagumpay ang delivery sa panig ninyo pero mukhang pumalya pa rin sa Meta. Ang handler na gumagawa muna ng trabaho bago sumagot ay maaaring lumampas sa paghihintay ng Meta, kaya inuulit ng Meta ang bagay na naproseso na ninyo. Ang deploy na nagre-restart ng server habang may hiling, ang load balancer na nagbabalik ng 502 sandali, o ang 201 o 204 sa halip na 200 ay pawang binibilang na pagkabigo. Nagdadagdag ng isa pang kaso ang batch: maaaring maglaman ng maraming update ang isang POST, kaya ang timeout sa malaking batch ay nagbabalik ng buong batch, kasama ang mga update na naasikaso na ninyo.

Aling key ang dapat gamitin sa deduplicate?

Ang sariling ID ng Meta, na pinipili ayon sa uri ng event, dahil iisang mensahe ay lehitimong nakakagawa ng ilang webhook. Ang status key na walang status value ay tatanggalin ang delivered at ituturing itong kopya ng sent, at ang call key na walang event ay magtatago lamang ng unang yugto ng tawag. Itabi ang mga key na may unique index, para hindi makapanalo ang dalawang worker na humahawak sa parehong retry:

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.

Anong pagkakasunod-sunod dumarating ang mga webhook?

Hindi kinakailangang ito ang pagkakasunod-sunod ng mga pangyayari. Walang garantiya ng pagkakasunod-sunod sa dokumentasyon ng Meta, ang inulit na delivery ay dumarating pagkatapos ng mas bagong mga event, at maaaring lumaktaw ang isang status sa isang hakbang: nagpapadala ang Meta ng read nang walang delivered kapag nabasa agad ang mensahe pagdating nito. Kaya itabi ang mga event kasama ang sarili nilang timestamp field, ihambing ang status ayon sa ranggo sa halip na sa oras ng pagdating, at hayaang manalo ang mas bagong mensahe ng customer kaysa sa nauna pero late na dumating. Sa Coexistence na numero, maaaring mag-overlap ang one-time history import sa live na mga mensahe sa paligid ng onboarding, at ang ID ng mensahe ang nagkakasundo sa dalawa.

Ano ang hitsura ng ligtas na handler?

Apat na hakbang: i-verify, sumagot nang eksaktong 200, mag-deduplicate, saka magtrabaho mula sa queue, para walang mabagal sa pagitan ng hiling ng Meta at ng sagot ninyo. Sinusuri ng bersyong ito ang X-Hub-Signature-256 gamit ang app secret ng sarili ninyong Meta app; para sa numerong nakakonekta sa pamamagitan ng easyCoexistence, pinipirmahan ng Meta ang app secret ng easyCoexistence, kaya ang direktang destination ay nag-a-authenticate gamit ang mahabang secret sa URL path nito, o lumilipat sa managed forwarding na pinirmahan bawat numero.

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

Paano hinahawakan ng easyCoexistence ang retry sa konektadong numero?

Sa pagpasok, sinusuri ng easyCoexistence ang signature ng Meta, sumasagot ng 200, at pagkatapos ng sagot saka tumatakbo ang mga automation, kaya hindi nag-re-retry ang Meta dahil ilang segundo ang inabot ng AI reply. Itinatago ang bawat incoming ID ng mensahe nang 7 araw, ang haba ng retry window ng Meta, at ang mensaheng muling naihatid ay nakikilala at hindi nagti-trigger ng pangalawang automation reply.

Sa paglabas papunta sa inyong Forward URL, bawat change ng Meta ay nagiging isang delivery na may ID sa X-EC-Delivery na nananatiling pareho sa mga forward retry: 7 pagsubok sa loob ng mga 33 oras, bawat isa naghihintay ng 10 segundo para sa 2xx. Ang change na mismong muling inihatid ng Meta ay ipinapasa muli sa ilalim ng bagong delivery ID, kaya mag-deduplicate din sa ID ng Meta sa loob ng value.

Mga karaniwang pagkakamali

  • Pag-deduplicate ng status sa id lamang. Ang sent, delivered at read ay may iisang wamid, kaya kailangan ng key ang status din.
  • Pagproseso bago sumagot. Ang mabagal na handler ay pinauulit ng Meta ang trabahong nagawa na; sumagot muna ng 200 at magtrabaho mula sa queue.
  • Pagbabalik ng 201 o 204. Itinuturing ng dokumentasyon ng Meta na pagkabigo ang anumang status maliban sa 200 at inuulit ito.
  • Pag-deduplicate ng forward gamit lamang ang X-EC-Delivery. Ang change na muling inihatid ng Meta ay dumarating sa ilalim ng bagong delivery ID; panatilihin ang ID ng Meta bilang pangalawang key.
Ginagawa ito gamit ang EasyCoexistence

Ang forward papunta sa inyong server ay pinipirmahan, nasa queue, at inuulit, at may pagmo-monitor sa bawat numero 24/7. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, at may unang 3 araw na libre.

Mga madalas itanong

Gaano katagal dapat itago ang mga ID na nakita ko na?

Hindi bababa sa 7 araw, ang retry window ng Meta. Ang delivery na inulit ng Meta sa ikaanim na araw ay dapat tumugma pa rin sa key nito, kung hindi ay ituturing itong bago.

Ano ang mangyayari sa mga mensahe ng customer ko kung down ang endpoint ko nang ilang araw?

Nag-re-retry ang Meta hanggang 7 araw at pagkatapos ay tinatanggal ang mga webhook. Sa Coexistence na numero, nasa WhatsApp Business app pa rin sa telepono ang mga usapan, kaya masasagot ito ng negosyo mula roon.

Maaari ko bang i-replay ang mga webhook na hindi ko nakuha?

Hindi mula sa Meta: walang API para sa historical na webhook data. Ang one-time history import ng Coexistence na numero ay tumatakbo lamang sa onboarding at hindi na mahihiling muli para sa parehong koneksyon.

Nagpapadala ba ang Meta ng parehong update sa higit sa isang server?

Nagpapadala ito sa bawat app na naka-subscribe sa WhatsApp Business Account para sa field na iyon. Kapag may destination override, ang mga field ng mensahe ng numero ay ipinapadala sa override URL sa halip na sa default callback ng app na iyon.

Magpatuloy sa pagbabasa

Handa na po ba kayong magsimula?

I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.

Magsimula ng Libreng Trial

Na-verify noong