Cubaan semula, pendua dan susunan webhook WhatsApp: cara mengendalikannya
Meta mencuba semula webhook WhatsApp yang menerima apa-apa selain HTTP 200, segera dan kemudian dengan kekerapan yang semakin berkurang selama sehingga 7 hari, lalu menggugurkannya selepas itu. Cubaan semula dihantar kepada setiap aplikasi yang melanggan akaun, jadi pendua adalah perkara biasa. Balas 200 dengan segera, nyahpendua mengikut id mesej atau id status ditambah status, dan susun acara mengikut cap masa masing-masing.
easyCoexistence menyambungkan nombor aplikasi WhatsApp Business anda kepada Cloud API Meta melalui Coexistence dan menyerap penghantaran semula Meta sebelum automasi anda melihatnya, jadi mesej yang dicuba semula tidak mendapat balasan AI kedua.
Tempoh Meta terus mencuba semula webhook yang tidak menerima HTTP 200, sebelum menggugurkannya.
Kebanyakan kemas kini Meta hantar dalam satu POST berkelompok; Meta tidak menjanjikan pengelompokan, jadi kendalikan setiap permintaan secara berasingan.
Muatan terbesar yang boleh dibawa oleh satu POST webhook WhatsApp.
Tempoh easyCoexistence mengingati setiap id mesej masuk, supaya mesej yang dihantar semula tidak menjalankan automasi dua kali.
Percubaan bagi setiap penghantaran ke URL Forward anda, setiap satu menunggu 10 saat untuk respons 2xx, sepanjang kira-kira 33 jam.
Bilakah Meta mencuba semula webhook WhatsApp?
Apabila penghantaran ke endpoint anda menerima status HTTP selain 200, atau tidak dapat dihantar langsung. Meta mencuba semula serta-merta, kemudian beberapa kali lagi dengan kekerapan yang semakin berkurang sepanjang 7 hari seterusnya, dan menggugurkan apa yang masih belum diakui selepas itu. Cubaan semula dihantar kepada setiap aplikasi yang melanggan WhatsApp Business Account bagi medan itu, sebab itu Meta memberi amaran bahawa ia boleh menghasilkan pemberitahuan pendua. Tiada API untuk mendapatkan semula webhook lama, jadi penghantaran yang habis tempoh 7 harinya hilang daripada sistem anda.
Mengapa pendua tiba walaupun pelayan anda sihat?
Kerana penghantaran boleh berjaya di pihak anda tetapi masih kelihatan gagal kepada Meta. Pengendali yang menjalankan kerjanya sebelum menjawab boleh melepasi tempoh tunggu Meta, lalu Meta mencuba semula sesuatu yang sudah anda proses. Penyebaran yang memulakan semula pelayan di tengah permintaan, pengimbang beban yang memulangkan 502 seketika, atau 201 atau 204 dan bukan 200, semuanya dikira sebagai kegagalan. Kelompok menambah satu lagi kes: satu POST boleh mengandungi banyak kemas kini, jadi tamat masa pada kelompok besar menghantar semula keseluruhan kelompok, termasuk kemas kini yang sudah anda kendalikan.
Kunci mana yang patut anda gunakan untuk nyahpendua?
Id Meta sendiri, dipilih mengikut jenis acara, kerana satu mesej secara sah menghasilkan beberapa webhook. Kunci status tanpa nilai status akan menggugurkan delivered dan read sebagai salinan sent, dan kunci panggilan tanpa acara hanya akan mengekalkan peringkat pertama panggilan. Simpan kunci dengan indeks unik, supaya dua pekerja yang mengendalikan cubaan semula yang sama tidak boleh kedua-duanya berjaya:
Dalam susunan apakah webhook tiba?
Tidak semestinya mengikut susunan kejadian sebenar. Dokumentasi Meta tidak menjanjikan sebarang susunan, penghantaran yang dicuba semula tiba selepas yang lebih baharu, dan status boleh melangkau satu langkah: Meta menghantar read tanpa delivered apabila mesej dibaca sebaik sahaja tiba. Jadi simpan acara dengan medan cap masanya sendiri, bandingkan status mengikut kedudukan dan bukan mengikut ketibaan, dan biarkan mesej pelanggan yang lebih baharu menggantikan yang lewat tiba. Pada nombor Coexistence, import sejarah sekali sahaja boleh bertindih dengan mesej langsung sekitar onboarding, dan id mesej itulah yang menyelaraskan kedua-duanya.
Bagaimanakah pengendali yang selamat kelihatan?
Empat langkah: sahkan, balas tepat 200, nyahpendua, kemudian kerjakan daripada barisan giliran, supaya tiada apa yang perlahan berada di antara permintaan Meta dan respons anda. Versi ini menyemak X-Hub-Signature-256 dengan rahsia aplikasi Meta anda sendiri; bagi nombor yang disambungkan melalui easyCoexistence, Meta menandatangani dengan rahsia aplikasi easyCoexistence, jadi destinasi terus mengesahkan dengan rahsia panjang dalam laluan URL, atau bertukar kepada pemajuan terurus yang ditandatangani bagi setiap nombor.
// 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);Bagaimana easyCoexistence mengendalikan cubaan semula pada nombor yang disambungkan?
Pada laluan masuk, easyCoexistence menyemak tandatangan Meta, membalas 200 dan menjalankan automasi selepas respons, jadi Meta tidak mencuba semula kerana balasan AI mengambil beberapa saat. Setiap id mesej masuk disimpan selama 7 hari, tempoh tetingkap cubaan semula Meta, dan mesej yang dihantar semula dikenal pasti serta tidak mencetuskan balasan automasi kedua.
Pada laluan keluar ke URL Forward anda, setiap perubahan Meta menjadi satu penghantaran dengan id dalam X-EC-Delivery yang kekal sama merentas cubaan semula forward: 7 percubaan sepanjang kira-kira 33 jam, setiap satu menunggu 10 saat untuk respons 2xx. Perubahan yang Meta hantar semula sendiri diforward semula di bawah id penghantaran baharu, jadi nyahpendua mengikut id Meta di dalam value juga.
Kesilapan biasa
- Menyahpendua status mengikut id sahaja. sent, delivered dan read berkongsi wamid, jadi kunci itu perlu merangkumi status juga.
- Memproses sebelum menjawab. Pengendali yang perlahan menyebabkan Meta mencuba semula kerja yang sudah anda buat; pulangkan 200 dahulu dan kerjakan daripada barisan giliran.
- Memulangkan 201 atau 204. Dokumentasi Meta menganggap sebarang status selain 200 sebagai penghantaran yang gagal dan mencubanya semula.
- Menyahpendua forward hanya mengikut X-EC-Delivery. Perubahan yang dihantar semula Meta tiba di bawah id penghantaran baharu; simpan id Meta sebagai kunci kedua.
Penghantaran ke pelayan anda ditandatangani, diletakkan dalam barisan giliran dan dicuba semula, dan setiap nombor dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 bagi setiap nombor sebulan, menurun apabila anda menambah nombor, dengan 3 hari pertama percuma.
Soalan lazim
Berapa lama saya perlu simpan id yang sudah saya lihat?
Sekurang-kurangnya 7 hari, tetingkap cubaan semula Meta. Penghantaran yang Meta cuba semula pada hari keenam mesti masih sepadan dengan kuncinya, jika tidak ia akan diproses sebagai baharu.
Apa yang berlaku kepada mesej pelanggan saya jika endpoint saya tidak berfungsi selama berhari-hari?
Meta mencuba semula sehingga 7 hari dan kemudian menggugurkan webhook. Pada nombor Coexistence, perbualan masih ada dalam aplikasi WhatsApp Business di telefon, jadi perniagaan boleh membalas dari situ.
Bolehkah saya mainkan semula webhook yang terlepas?
Bukan daripada Meta: tiada API untuk data webhook sejarah. Import sejarah sekali sahaja bagi nombor Coexistence hanya berjalan semasa onboarding dan tidak boleh diminta semula untuk sambungan yang sama.
Adakah Meta menghantar kemas kini yang sama kepada lebih daripada satu pelayan?
Ia dihantar kepada setiap aplikasi yang melanggan WhatsApp Business Account bagi medan itu. Dengan override destinasi, medan mesej nombor dihantar ke URL override dan bukan ke callback lalai aplikasi itu.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada