Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Reîncercări, duplicate și ordine la webhook-urile WhatsApp: cum le gestionați

Meta reîncearcă un webhook WhatsApp care primește altceva decât HTTP 200, imediat și apoi tot mai rar, timp de până la 7 zile, după care îl abandonează. Reîncercările ajung la fiecare aplicație abonată la cont, deci duplicatele sunt normale. Răspundeți rapid cu 200, deduplicați pe ID-ul mesajului sau pe ID-ul statusului plus statusul și ordonați evenimentele după propriile marcaje de timp.

easyCoexistence conectează numărul dvs.

7 days

Cât timp reîncearcă Meta un webhook care nu a primit HTTP 200, înainte să îl abandoneze.

1,000

Cele mai multe actualizări Meta le trimite grupate într-un singur POST; Meta nu garantează gruparea, așa că tratați fiecare cerere separat.

3 MB

Cea mai mare dimensiune pe care o poate avea un POST de webhook WhatsApp.

7 days

Cât timp ține easyCoexistence minte fiecare ID de mesaj primit, ca un mesaj redistribuit să nu ruleze o automatizare de două ori.

7 attempts

Încercări pentru fiecare redirecționare către Forward URL-ul dvs., fiecare așteptând 10 secunde un răspuns 2xx, timp de aproximativ 33 de ore.

Când reîncearcă Meta un webhook WhatsApp?

Ori de câte ori o livrare către endpoint-ul dvs. primește un cod HTTP diferit de 200 sau nu poate fi livrată deloc. Meta reîncearcă imediat, apoi de câteva ori în continuare, tot mai rar, în următoarele 7 zile, și abandonează ce rămâne neconfirmat după aceea. Reîncercările ajung la fiecare aplicație abonată la WhatsApp Business Account pentru acel câmp, motiv pentru care Meta avertizează că pot produce notificări duplicate. Nu există API pentru a prelua webhook-urile trecute, deci o livrare care își epuizează cele 7 zile se pierde pentru sistemul dvs.

De ce apar duplicate chiar când serverul dvs. funcționează bine?

Pentru că o livrare poate reuși de partea dvs. și totuși să pară eșuată pentru Meta. Un handler care își face treaba înainte să răspundă poate depăși timpul de așteptare al Meta, așa că Meta reîncearcă ceva ce ați procesat deja. O repornire a serverului în mijlocul unei cereri, un load balancer care returnează 502 pentru o clipă sau un 201 ori 204 în loc de 200 sunt toate considerate eșecuri. Grupările adaugă un caz în plus: un singur POST poate conține multe actualizări, deci un timeout pe un lot mare readuce întregul lot, inclusiv actualizările pe care le-ați tratat deja.

Pe ce cheie ar trebui să deduplicați?

Pe ID-urile proprii ale Meta, alese pentru fiecare tip de eveniment, pentru că un mesaj produce legitim mai multe webhook-uri. O cheie de status fără valoarea statusului ar elimina delivered și read ca fiind copii ale sent, iar o cheie de apel fără tipul evenimentului ar păstra doar prima etapă a unui apel. Stocați cheile cu un index unic, ca doi workeri care tratează aceeași reîncercare să nu poată câștiga amândoi:

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.

În ce ordine ajung webhook-urile?

Nu neapărat în ordinea în care s-au întâmplat lucrurile. Documentația Meta nu promite nicio ordine, o livrare reîncercată ajunge după cele mai noi, iar un status poate sări un pas: Meta trimite read fără delivered atunci când un mesaj este citit în momentul sosirii. Stocați deci evenimentele cu propriul câmp de timp, comparați un status după rang, nu după sosire, și lăsați un mesaj mai recent al clientului să câștige în fața unuia mai vechi care a sosit târziu. Pe un număr Coexistence, importul unic al istoricului poate să se suprapună cu mesajele live în jurul onboarding-ului, iar ID-ul mesajului este cel care le reconciliază.

Cum arată un handler sigur?

Patru pași: verificați, răspundeți exact 200, deduplicați, apoi lucrați dintr-o coadă, astfel încât nimic lent să nu stea între cererea Meta și răspunsul dvs. Această versiune verifică X-Hub-Signature-256 cu secretul aplicației dvs. Meta; pentru un număr conectat prin easyCoexistence, Meta semnează cu secretul aplicației easyCoexistence, deci o destinație directă se autentifică printr-un secret lung în calea URL-ului, sau trece la redirecționare gestionată, semnată pe număr.

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

Cum gestionează easyCoexistence reîncercările pe un număr conectat?

La intrare, easyCoexistence verifică semnătura Meta, răspunde 200 și rulează automatizările după răspuns, astfel încât Meta să nu reîncerce pentru că un răspuns AI a durat câteva secunde. Fiecare ID de mesaj primit este păstrat 7 zile, lungimea ferestrei de reîncercare a Meta, iar un mesaj redistribuit este recunoscut și nu declanșează un al doilea răspuns automat.

La ieșire, către Forward URL-ul dvs., fiecare modificare Meta devine o singură livrare cu un ID în X-EC-Delivery, care rămâne același la reîncercările redirecționării: 7 încercări în aproximativ 33 de ore, fiecare așteptând 10 secunde un răspuns 2xx. O modificare pe care Meta însăși o redistribuie este redirecționată din nou sub un nou ID de livrare, deci deduplicați și pe ID-urile Meta din interiorul value.

Greșeli frecvente

  • Deduplicarea statusurilor doar pe ID. sent, delivered și read au același wamid, deci cheia trebuie să includă și statusul.
  • Procesarea înainte de răspuns. Un handler lent face ca Meta să reîncerce munca deja făcută; returnați 200 mai întâi și lucrați dintr-o coadă.
  • Returnarea lui 201 sau 204. Documentația Meta tratează orice status diferit de 200 drept livrare eșuată și o reîncearcă.
  • Deduplicarea redirecționărilor doar pe X-EC-Delivery. O modificare redistribuită de Meta sosește sub un nou ID de livrare; păstrați ID-urile Meta drept a doua cheie.
Faceți acest lucru cu EasyCoexistence

din aplicația WhatsApp Business la Cloud API al Meta prin Coexistence și absoarbe redistribuirile Meta înainte ca automatizările dvs. să le vadă, astfel încât un mesaj reîncercat să nu primească un al doilea răspuns AI. Redirecționările către serverul dvs. sunt semnate, puse în coadă și reîncercate, iar fiecare număr este monitorizat 24/7. De la US$ 9 până la US$ 0.75 pe număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Cât timp ar trebui să păstrez ID-urile pe care le-am văzut?

Cel puțin 7 zile, fereastra de reîncercare a Meta. O livrare reîncercată de Meta în ziua a șasea trebuie să se potrivească încă cu cheia sa, altfel va fi tratată ca nouă.

Ce se întâmplă cu mesajele clienților mei dacă endpoint-ul meu nu funcționează zile întregi?

Meta reîncearcă timp de până la 7 zile, apoi abandonează webhook-urile. Pe un număr Coexistence, conversațiile rămân în aplicația WhatsApp Business de pe telefon, deci afacerea poate răspunde de acolo.

Pot reda webhook-urile pe care le-am ratat?

Nu de la Meta: nu există API pentru datele istorice ale webhook-urilor. Importul unic de istoric al unui număr Coexistence rulează doar la onboarding și nu poate fi cerut din nou pentru aceeași conexiune.

Trimite Meta aceeași actualizare la mai multe servere?

Trimite către fiecare aplicație abonată la WhatsApp Business Account pentru acel câmp. Cu o suprascriere a destinației, câmpurile de mesaje ale numărului merg la URL-ul de suprascriere în loc de callback-ul implicit al aplicației respective.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la