WhatsApp-webhookien uudelleenyritykset, kaksoiskappaleet ja järjestys: näin ne käsitellään
Meta yrittää WhatsApp-webhookia uudelleen heti, jos se saa muun kuin HTTP 200 -vastauksen, ja sen jälkeen harvemmin jopa 7 päivän ajan. Kun aika on kulunut, Meta hylkää sen. Uudelleenyritykset menevät jokaiseen tiliin tilattuun sovellukseen, joten kaksoiskappaleet ovat normaaleja. Vastaa nopeasti 200:lla, poista kaksoiskappaleet viestin id:n tai tilan id:n ja tilan perusteella ja järjestä tapahtumat niiden omien aikaleimojen mukaan.
easyCoexistence yhdistää WhatsApp Business -sovelluksesi numeron Metan Cloud API -rajapintaan Coexistencen kautta ja ottaa vastaan Metan uudelleentoimitukset ennen kuin automaatiosi näkevät ne, joten uudelleenyritetty viesti ei saa toista AI-vastausta.
Kuinka kauan Meta yrittää uudelleen webhookia, jota ei ole hyväksytty HTTP 200:lla, ennen kuin se hylkää sen.
Useimmat päivitykset Meta yhdistää yhdeksi POST-pyynnöksi. Meta ei lupaa yhdistämistä, joten käsittele jokainen pyyntö erikseen.
Suurin payload-koko, jonka WhatsApp-webhookin POST-pyyntö voi kuljettaa.
Kuinka kauan easyCoexistence muistaa jokaisen saapuvan viestin id:n, jotta uudelleen toimitettu viesti ei käynnistä automaatiota kahdesti.
Yrityksiä kohti edelleenlähetystä Forward URL -osoitteeseesi, joista kukin odottaa 2xx-vastausta 10 sekuntia, noin 33 tunnin ajan.
Milloin Meta yrittää uudelleen WhatsApp-webhookia?
Aina, kun toimitus endpointiisi saa muun HTTP-tilan kuin 200 tai ei onnistu lainkaan. Meta yrittää heti, ja sen jälkeen muutaman kerran harvemmin seuraavan 7 päivän aikana, ja hylkää sen jälkeen kaiken, mikä on jäänyt vahvistamatta. Uudelleenyritykset menevät jokaiseen WhatsApp Business -tilille kyseiselle kentälle tilattuun sovellukseen, minkä vuoksi Meta varoittaa niiden voivan tuottaa kaksoisilmoituksia. Menneitä webhookeja ei voi hakea API:n kautta, joten toimitus, joka jää 7 päivän jälkeen, katoaa järjestelmältäsi.
Miksi kaksoiskappaleita tulee, vaikka palvelimesi on terve?
Toimitus voi onnistua puolellasi ja silti näyttää Metalle epäonnistuneelta. Käsittelijä, joka tekee työnsä ennen vastaamista, voi ylittää Metan odotusajan, jolloin Meta yrittää uudelleen jotain, minkä olet jo käsitellyt. Palvelimen uudelleenkäynnistys kesken pyynnön, kuormantasaajan hetkellinen 502-virhe tai 201 tai 204 200:n sijaan lasketaan kaikki epäonnistuneiksi toimituksiksi. Erät lisäävät yhden tapauksen: yksi POST voi sisältää monta päivitystä, joten suuren erän aikakatkaisu tuo koko erän takaisin, myös jo käsitellyt päivitykset.
Minkä avaimen perusteella kaksoiskappaleet kannattaa poistaa?
Metan omat id:t, valittuna tapahtumatyypeittäin, koska yksi viesti tuottaa oikeasti useita webhookeja. Tilan avain ilman tilan arvoa pudottaisi delivered- ja read-tilat pois sent-tilan kopioina, ja puhelun avain ilman tapahtumaa säilyttäisi vain puhelun ensimmäisen vaiheen. Tallenna avaimet yksilöllisellä indeksillä, jotta kaksi työntekijää, jotka käsittelevät saman uudelleenyrityksen, eivät voi molemmat voittaa:
Missä järjestyksessä webhookit saapuvat?
Eivät välttämättä siinä järjestyksessä kuin asiat tapahtuivat. Metan dokumentaatio ei lupaa järjestystä, uudelleen toimitettu pyyntö saapuu uudempien jälkeen, ja tila voi ohittaa vaiheen: Meta lähettää read-tilan ilman delivered-tilaa, kun viesti luetaan heti saapuessaan. Tallenna siis tapahtumat niiden omalla aikaleimakentällä, vertaa tilaa arvojärjestyksen eikä saapumisen mukaan ja anna myöhempi asiakasviesti voittaa sellaisen aiemman viestin, joka saapui myöhässä. Coexistence-numerossa kertaluonteinen historian tuonti voi mennä päällekkäin reaaliaikaisten viestien kanssa käyttöönoton aikana, ja viestin id on se, joka sovittaa ne yhteen.
Miltä turvallinen käsittelijä näyttää?
Neljä vaihetta: tarkista, vastaa täsmälleen 200, poista kaksoiskappaleet ja työstä sitten jonosta, jotta mikään hidas ei jää Metan pyynnön ja vastauksesi väliin. Tämä versio tarkistaa X-Hub-Signature-256-otsakkeen omalla Meta-sovelluksesi salaisuudella. Numerolle, joka on yhdistetty easyCoexistencen kautta, Meta allekirjoittaa easyCoexistencen sovelluksen salaisuudella, joten suora kohde todentaa pitkällä salaisuudella URL-osoitteen polussa, tai vaihda hallinnoituun edelleenlähetykseen, joka allekirjoitetaan numeroittain.
// 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);Miten easyCoexistence käsittelee uudelleenyritykset yhdistetyllä numerolla?
Sisään tullessaan easyCoexistence tarkistaa Metan allekirjoituksen, vastaa 200:lla ja ajaa automaatiot vastauksen jälkeen, joten Meta ei yritä uudelleen, vaikka AI-vastaus kestäisi muutaman sekunnin. Jokainen saapuva viestin id säilytetään 7 päivää, eli Metan uudelleenyritysikkunan pituuden, ja uudelleen toimitettu viesti tunnistetaan eikä käynnistä toista automaattista vastausta.
Ulospäin Forward URL -osoitteeseesi jokainen Metan muutos muuttuu yhdeksi toimitukseksi, jonka tunnus X-EC-Delivery pysyy samana edelleenlähetyksen uudelleenyrityksissä: 7 yritystä noin 33 tunnin aikana, joista kukin odottaa 2xx-vastausta 10 sekuntia. Muutos, jonka Meta itse toimittaa uudelleen, välitetään uudella toimitustunnuksella, joten poista kaksoiskappaleet myös Metan id:iden perusteella value-kentän sisältä.
Yleiset virheet
- Tilojen kaksoiskappaleiden poisto pelkällä id:llä. sent, delivered ja read jakavat saman wamid:n, joten avaimessa on oltava myös tila.
- Käsittely ennen vastaamista. Hidas käsittelijä saa Metan yrittämään uudelleen työtä, jonka olet jo tehnyt. Palauta ensin 200 ja työstä sitten jonosta.
- 201 tai 204 palauttaminen. Metan dokumentaatio käsittelee muun tilan kuin 200 epäonnistuneena toimituksena ja yrittää sen uudelleen.
- Edelleenlähetysten kaksoiskappaleiden poisto pelkällä X-EC-Delivery-tunnuksella. Meta uudelleen toimittama muutos saapuu uudella toimitustunnuksella, joten pidä Metan id:t toisena avaimena.
Palvelimellesi menevät edelleenlähetykset on allekirjoitettu, jonotettu ja uudelleenyritetty, ja jokaista numeroa valvotaan ympäri vuorokauden. US$ 9 numeroa kohden kuukaudessa, laskien US$ 0.75:een lisäämiesi numeroiden myötä, ja ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Kuinka kauan minun pitäisi säilyttää näkemieni id:t?
Vähintään 7 päivää, Metan uudelleenyritysikkuna. Päivänä kuusi Metan uudelleen yrittämän toimituksen on yhä vastattava avaintaan, muuten se käsitellään uutena.
Mitä asiakkaideni viesteille tapahtuu, jos päätepisteeni on alhaalla päiviä?
Meta yrittää uudelleen jopa 7 päivän ajan ja hylkää sen jälkeen webhookit. Coexistence-numerossa keskustelut ovat yhä puhelimen WhatsApp Business -sovelluksessa, joten yritys voi vastata sieltä.
Voinko toistaa webhookit, jotka jäivät väliin?
Et Metalta: webhookien historiatietoon ei ole API:a. Coexistence-numeron kertaluonteinen historian tuonti tapahtuu vain käyttöönoton yhteydessä, eikä sitä voi pyytää uudelleen samalle yhteydelle.
Lähettääkö Meta saman päivityksen useammalle palvelimelle?
Se lähettää jokaiseen sovellukseen, joka on tilattu WhatsApp Business -tilille kyseiselle kentälle. Kohteen ohituksen kanssa numeron viestikentät menevät ohitusosoitteeseen sovelluksen oletuksena olevan takaisinkutsun sijaan.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu