IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Majaribio upya, marudio na mpangilio wa webhook za WhatsApp: jinsi ya kuyashughulikia

Meta hujaribu upya webhook ya WhatsApp inayopokea chochote isipokuwa HTTP 200, mara moja kisha kwa marudio yanayopungua hadi siku 7, na kuiondoa baada ya hapo. Majaribio upya huenda kwa kila programu iliyojisajili kwenye akaunti, kwa hiyo marudio ni ya kawaida. Jibu 200 haraka, ondoa marudio kwa kitambulisho cha ujumbe au kwa kitambulisho cha hali pamoja na hali, kisha panga matukio kwa muda wao wenyewe.

easyCoexistence huunganisha nambari yako ya programu ya WhatsApp Business na Cloud API ya Meta kupitia Coexistence, na hufyonza marudio ya Meta kabla ya automations zako kuyaona, kwa hiyo ujumbe uliotumwa tena hautapata jibu la pili la AI.

7 days

Muda ambao Meta huendelea kujaribu upya webhook isiyopata HTTP 200, kabla ya kuiondoa.

1,000

Mara nyingi Meta huunganisha masasisho kuwa POST moja; Meta haiahidi kuunganisha, kwa hiyo shughulikia kila ombi peke yake.

3 MB

Ukubwa mkubwa zaidi wa payload ambao POST ya webhook ya WhatsApp inaweza kubeba.

7 days

Muda ambao easyCoexistence hukumbuka kila kitambulisho cha ujumbe unaoingia, ili ujumbe uliotumwa tena usiendeshe kiotomatiki mara mbili.

7 attempts

Majaribio kwa kila uwasilishaji kwa Forward URL yako, kila moja likisubiri sekunde 10 kwa 2xx, kwa takriban saa 33.

Meta hujaribu upya webhook ya WhatsApp lini?

Kila wakati uwasilishaji kwa endpoint yako unapopata hali ya HTTP isiyo 200, au usipoweza kuwasilishwa kabisa. Meta hujaribu mara moja, kisha mara kadhaa zaidi kwa marudio yanayopungua ndani ya siku 7 zijazo, na huondoa kile ambacho bado hakijakubaliwa baada ya hapo. Majaribio upya huenda kwa kila programu iliyojisajili kwenye WhatsApp Business Account kwa uga huo, ndiyo maana Meta inaonya kwamba yanaweza kuleta arifa zinazorudiwa. Hakuna API ya kupata webhook zilizopita, kwa hiyo uwasilishaji unaomaliza siku zake 7 umepotea kwa mfumo wako.

Kwa nini marudio yanafika hata server yako ikiwa na afya?

Kwa sababu uwasilishaji unaweza kufaulu upande wako na bado uonekane umeshindwa kwa Meta. Kishughulikiaji kinachofanya kazi kabla ya kujibu kinaweza kuzidi muda wa kusubiri wa Meta, kwa hiyo Meta hujaribu upya kitu ulichokwishachakata. Kuanzishwa upya kwa server wakati wa ombi, load balancer kurudisha 502 kwa muda mfupi, au 201 au 204 badala ya 200, vyote huhesabiwa kuwa hitilafu. Batch huongeza kisa kingine: POST moja inaweza kubeba masasisho mengi, kwa hiyo muda wa kusubiri kwenye batch kubwa unarudisha batch nzima, ikiwa ni pamoja na masasisho uliyoshughulikia.

Unapaswa kuondoa marudio kwa ufunguo gani?

Vitambulisho vya Meta vyenyewe, vilivyochaguliwa kwa kila aina ya tukio, kwa sababu ujumbe mmoja huzalisha webhook kadhaa kihalali. Ufunguo wa hali usio na thamani ya hali ungeondoa delivered na read kama nakala za sent, na ufunguo wa simu usio na tukio ungehifadhi hatua ya kwanza tu ya simu. Hifadhi funguo hizo kwa faharasa ya kipekee, ili wafanyakazi wawili wanaoshughulikia marudio yaleyale wasiweze wote kufaulu:

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.

Webhook huja kwa mpangilio gani?

Si lazima kwa mpangilio ambao mambo yalitokea. Meta haitoi ahadi ya mpangilio katika nyaraka zake, uwasilishaji uliojaribiwa upya hufika baada ya matukio mapya, na hali inaweza kuruka hatua: Meta hutuma read bila delivered ujumbe unaposomwa mara unapofika. Kwa hiyo hifadhi matukio kwa uga wao wa muda, linganisha hali kwa cheo badala ya wakati wa kufika, na ruhusu ujumbe wa mteja wa baadaye kushinda wa awali uliofika kwa kuchelewa. Kwenye nambari ya Coexistence, uingizaji wa historia wa mara moja unaweza kuingiliana na ujumbe wa moja kwa moja wakati wa onboarding, na kitambulisho cha ujumbe ndicho kinachoupatanisha.

Kishughulikiaji salama kinaonekanaje?

Hatua nne: thibitisha, jibu 200 hasa, ondoa marudio, kisha fanya kazi kutoka kwenye foleni, ili hakuna kitu cha polepole kiwe kati ya ombi la Meta na jibu lako. Toleo hili hukagua X-Hub-Signature-256 kwa siri ya programu yako mwenyewe ya Meta; kwa nambari iliyounganishwa kupitia easyCoexistence, Meta husaini kwa siri ya programu ya easyCoexistence, kwa hiyo lengwa la moja kwa moja huthibitishwa kwa siri ndefu iliyo kwenye njia ya URL, au ubadilishe hadi usambazaji unaosimamiwa uliosainiwa kwa kila nambari.

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

easyCoexistence hushughulikiaje marudio kwenye nambari iliyounganishwa?

Inapoingia, easyCoexistence hukagua sahihi ya Meta, hujibu 200 na kuendesha kiotomatiki baada ya jibu, ili Meta isijaribu upya kwa sababu jibu la AI lilichukua sekunde chache. Kila kitambulisho cha ujumbe unaoingia huhifadhiwa kwa siku 7, urefu wa dirisha la marudio la Meta, na ujumbe uliotumwa tena hutambuliwa na hauanzishi jibu la pili la kiotomatiki.

Inapotoka kwenda Forward URL yako, kila mabadiliko ya Meta huwa uwasilishaji mmoja wenye kitambulisho katika X-EC-Delivery kinachobaki sawa kwenye majaribio upya ya usambazaji: majaribio 7 kwa takriban saa 33, kila moja likisubiri sekunde 10 kwa 2xx. Mabadiliko ambayo Meta yenyewe huyatuma tena husambazwa tena chini ya kitambulisho kipya cha uwasilishaji, kwa hiyo ondoa marudio kwa vitambulisho vya Meta ndani ya value pia.

Makosa ya kawaida

  • Kuondoa marudio ya hali kwa kitambulisho pekee. sent, delivered na read hushiriki wamid, kwa hiyo ufunguo unahitaji hali pia.
  • Kushughulikia kabla ya kujibu. Kishughulikiaji cha polepole humfanya Meta kujaribu upya kazi uliyokwishafanya; rudisha 200 kwanza kisha fanya kazi kutoka kwenye foleni.
  • Kurudisha 201 au 204. Nyaraka za Meta huchukulia hali yoyote isiyo 200 kama uwasilishaji ulioshindwa na huujaribu upya.
  • Kuondoa marudio ya usambazaji kwa X-EC-Delivery pekee. Mabadiliko ambayo Meta huyatuma tena hufika chini ya kitambulisho kipya cha uwasilishaji; weka vitambulisho vya Meta kama ufunguo wa pili.
Kufanya hili ukitumia EasyCoexistence

Usambazaji kwa server yako umesainiwa, umewekwa kwenye foleni na hujaribiwa upya, na kila nambari inafuatiliwa saa 24 kila siku. US$ 9 hadi US$ 0.75 kwa kila nambari kwa mwezi, bei hushuka kadri unavyoongeza nambari, pamoja na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Nipaswa kuhifadhi vitambulisho nilivyoona kwa muda gani?

Angalau siku 7, dirisha la marudio la Meta. Uwasilishaji ambao Meta huujaribu upya siku ya sita lazima bado ulingane na ufunguo wake, la sivyo utashughulikiwa kama mpya.

Nini kitatokea kwa ujumbe wa wateja wangu server yangu ikiwa chini kwa siku kadhaa?

Meta hujaribu upya kwa hadi siku 7 kisha huondoa webhook. Kwenye nambari ya Coexistence, mazungumzo bado yako kwenye programu ya WhatsApp Business kwenye simu, kwa hiyo biashara inaweza kujibu kutoka hapo.

Naweza kucheza upya webhook nilizokosa?

Si kutoka Meta: hakuna API ya data ya webhook za kihistoria. Uingizaji wa historia wa mara moja wa nambari ya Coexistence hufanyika wakati wa onboarding pekee, na hauwezi kuombwa tena kwa muunganisho uleule.

Je, Meta hutuma masasisho yaleyale kwa zaidi ya server moja?

Hutuma kwa kila programu iliyojisajili kwenye WhatsApp Business Account kwa uga huo. Kwa lengwa lililobadilishwa, sehemu za ujumbe za nambari huenda kwenye URL ya kubadilishwa badala ya callback ya kawaida ya programu hiyo.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye