WhatsApp ওয়েবহুক রিট্রাই, ডুপ্লিকেট ও ক্রম: কীভাবে সামলাবেন
Meta কোনো WhatsApp ওয়েবহুককে HTTP 200 ছাড়া অন্য কিছু দিয়ে সাড়া দিলে তৎক্ষণাৎ আবার পাঠায়, এরপর 7 দিন পর্যন্ত ক্রমশ কম ঘনঘন, এবং তারপর বাদ দেয়। রিট্রাই অ্যাকাউন্টে সাবস্ক্রাইব করা প্রতিটি অ্যাপে যায়, তাই ডুপ্লিকেট স্বাভাবিক। দ্রুত 200 ফেরত দিন, মেসেজ আইডি বা status id ও স্ট্যাটাসের ওপর ভিত্তি করে ডুপ্লিকেট বাদ দিন, এবং ইভেন্ট সাজান তাদের নিজস্ব টাইমস্ট্যাম্প দিয়ে।
easyCoexistence Coexistence-এর মাধ্যমে আপনার WhatsApp Business অ্যাপের নম্বরকে Meta-র Cloud API-র সঙ্গে যুক্ত করে এবং আপনার অটোমেশন দেখার আগেই Meta-র পুনরায় পাঠানো ডেলিভারি সামলায়, তাই একটি রিট্রাই করা মেসেজ দ্বিতীয় AI উত্তর পায় না।
Meta HTTP 200 না পাওয়া ওয়েবহুক কতদিন রিট্রাই করতে থাকে, তারপর সেটি বাদ দেয়।
বেশিরভাগ আপডেট Meta একটি POST-এ ব্যাচ করে; Meta ব্যাচিংয়ের প্রতিশ্রুতি দেয় না, তাই প্রতিটি রিকোয়েস্ট আলাদাভাবে হ্যান্ডল করুন।
একটি WhatsApp ওয়েবহুক POST-এ সর্বোচ্চ কত বড় পেলোড থাকতে পারে।
easyCoexistence প্রতিটি আসা মেসেজ আইডি কতদিন মনে রাখে, যাতে পুনরায় পাঠানো মেসেজ দিয়ে অটোমেশন দুবার না চলে।
আপনার Forward URL-এ প্রতি ফরওয়ার্ডে 7 বার চেষ্টা হয়, প্রতিবার 2xx-এর জন্য 10 সেকেন্ড অপেক্ষা করে, প্রায় 33 ঘণ্টা জুড়ে।
Meta কখন একটি WhatsApp ওয়েবহুক রিট্রাই করে?
যখনই আপনার এন্ডপয়েন্টে ডেলিভারি HTTP 200 ছাড়া অন্য কোনো স্ট্যাটাস পায়, অথবা একেবারেই ডেলিভার করা না যায়। Meta তৎক্ষণাৎ রিট্রাই করে, তারপর পরের 7 দিনে ক্রমশ কম ঘনঘন আরও কয়েকবার, এবং এরপর যা স্বীকৃত হয়নি তা বাদ দেয়। রিট্রাই ওই ফিল্ডের জন্য WhatsApp Business Account-এ সাবস্ক্রাইব করা প্রতিটি অ্যাপে যায়, যে কারণে Meta সতর্ক করে যে এতে ডুপ্লিকেট নোটিফিকেশন আসতে পারে। পুরোনো ওয়েবহুক আনার কোনো API নেই, তাই যে ডেলিভারির 7 দিন শেষ হয়ে যায় সেটি আপনার সিস্টেম থেকে হারিয়ে যায়।
আপনার সার্ভার ঠিক থাকলেও কেন ডুপ্লিকেট আসে?
কারণ আপনার দিকে একটি ডেলিভারি সফল হতে পারে, তবু Meta-র কাছে সেটি ব্যর্থ মনে হতে পারে। সাড়া দেওয়ার আগে যে হ্যান্ডলার কাজ শেষ করে, সে Meta-র অপেক্ষার সময় পার করে ফেলতে পারে, ফলে Meta এমন কিছু আবার পাঠায় যা আপনি আগেই প্রক্রিয়া করেছেন। অনুরোধ চলাকালে সার্ভার রিস্টার্ট করে এমন ডিপ্লয়, কিছু সময়ের জন্য লোড ব্যালান্সারের 502, বা 200-এর বদলে 201 বা 204, এসবই ব্যর্থতা হিসেবে গণ্য হয়। ব্যাচ আরও একটি ক্ষেত্র যোগ করে: একটি POST-এ অনেক আপডেট থাকতে পারে, তাই বড় ব্যাচে টাইমআউট হলে পুরো ব্যাচ ফিরে আসে, যার মধ্যে আপনার আগে হ্যান্ডল করা আপডেটগুলোও থাকে।
কোন কী দিয়ে ডুপ্লিকেট বাদ দেবেন?
Meta-র নিজস্ব আইডি, প্রতিটি ইভেন্ট টাইপ অনুযায়ী বেছে নেওয়া, কারণ একটি মেসেজ বৈধভাবেই কয়েকটি ওয়েবহুক তৈরি করে। স্ট্যাটাস কী-তে স্ট্যাটাসের মান না থাকলে delivered ও read-কে sent-এর কপি বলে বাদ দেওয়া হবে, আর কল কী-তে ইভেন্ট না থাকলে কলের শুধু প্রথম ধাপ থাকবে। কী-গুলো একটি ইউনিক ইনডেক্স দিয়ে সংরক্ষণ করুন, যাতে একই রিট্রাই হ্যান্ডল করা দুটি ওয়ার্কার দুজনেই জিততে না পারে:
ওয়েবহুকগুলো কোন ক্রমে আসে?
সবসময় ঘটনার আসল ক্রমে নয়। Meta-র ডকুমেন্টেশনে ক্রমের কোনো প্রতিশ্রুতি নেই, পুনরায় পাঠানো একটি ডেলিভারি নতুনগুলোর পরে এসে পৌঁছায়, এবং একটি স্ট্যাটাস একটি ধাপ বাদ দিতে পারে: মেসেজ আসার মুহূর্তেই পড়া হলে Meta delivered ছাড়াই read পাঠায়। তাই ইভেন্টগুলো তাদের নিজস্ব timestamp ফিল্ডসহ সংরক্ষণ করুন, স্ট্যাটাস তুলনা করুন আগমনের ক্রম দিয়ে নয়, ধাপের ক্রম দিয়ে, এবং দেরিতে আসা পুরোনো কোনো কাস্টমার মেসেজের চেয়ে নতুন কাস্টমার মেসেজকে অগ্রাধিকার দিন। Coexistence নম্বরে অনবোর্ডিংয়ের আশপাশে একবারের ইতিহাস আমদানি লাইভ মেসেজের সঙ্গে ওভারল্যাপ করতে পারে, এবং মেসেজ আইডিই দুটিকে মেলায়।
একটি নিরাপদ হ্যান্ডলার কেমন দেখায়?
চারটি ধাপ: যাচাই করুন, ঠিক 200 ফেরত দিন, ডুপ্লিকেট বাদ দিন, তারপর কিউ থেকে কাজ করুন, যাতে Meta-র রিকোয়েস্ট ও আপনার উত্তরের মাঝখানে কিছু ধীর না থাকে। এই সংস্করণ নিজের Meta অ্যাপের সিক্রেট দিয়ে X-Hub-Signature-256 যাচাই করে; easyCoexistence-এর মাধ্যমে সংযুক্ত নম্বরের জন্য Meta easyCoexistence-এর অ্যাপ সিক্রেট দিয়ে সাইন করে, তাই সরাসরি গন্তব্য তার URL পাথে একটি দীর্ঘ সিক্রেট দিয়ে প্রমাণীকরণ করে, অথবা প্রতি নম্বরে সাইন করা managed forwarding-এ যান।
// 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 কীভাবে রিট্রাই হ্যান্ডল করে?
ভেতরে আসার সময় easyCoexistence Meta-র সিগনেচার যাচাই করে, 200 ফেরত দেয় এবং উত্তর পাঠানোর পরে অটোমেশন চালায়, তাই AI উত্তরে কয়েক সেকেন্ড লাগলে Meta আবার পাঠায় না। প্রতিটি আসা মেসেজ আইডি 7 দিন রাখা হয়, যা Meta-র রিট্রাই উইন্ডোর দৈর্ঘ্য, এবং পুনরায় পাঠানো মেসেজ চিহ্নিত হয় ও দ্বিতীয় অটোমেশন উত্তর ট্রিগার করে না।
আপনার Forward URL-এর দিকে বেরিয়ে যাওয়ার সময়, Meta-র প্রতিটি change একটি ডেলিভারি হয়ে যায়, যার X-EC-Delivery-তে একটি আইডি থাকে, যা ফরওয়ার্ড রিট্রাইয়ের সময়ও একই থাকে: প্রায় 33 ঘণ্টা জুড়ে 7 বার চেষ্টা, প্রতিবার 2xx-এর জন্য 10 সেকেন্ড অপেক্ষা করে। Meta নিজে যে change পুনরায় পাঠায়, সেটি নতুন ডেলিভারি আইডি নিয়ে আবার ফরওয়ার্ড হয়, তাই value-এর ভেতরেও Meta-র আইডির ওপর ডুপ্লিকেট বাদ দিন।
সাধারণ ভুলগুলো
- শুধু আইডি দিয়ে স্ট্যাটাস ডুপ্লিকেট বাদ দেওয়া। sent, delivered ও read একই wamid ভাগ করে, তাই কী-তে স্ট্যাটাসের মানও লাগে।
- প্রক্রিয়া করার আগে উত্তর না দেওয়া। ধীর হ্যান্ডলার Meta-কে এমন কাজ আবার করায় যা আপনি করে ফেলেছেন; আগে 200 ফেরত দিন এবং কিউ থেকে কাজ করুন।
- 201 বা 204 ফেরত দেওয়া। Meta-র ডকুমেন্টেশন 200 ছাড়া যেকোনো স্ট্যাটাসকে ব্যর্থ ডেলিভারি ধরে এবং রিট্রাই করে।
- শুধু X-EC-Delivery দিয়ে ফরওয়ার্ড ডুপ্লিকেট বাদ দেওয়া। Meta-র পুনরায় পাঠানো change নতুন ডেলিভারি আইডি নিয়ে আসে; Meta-র আইডিকে দ্বিতীয় কী হিসেবে রাখুন।
আপনার সার্ভারে যাওয়া ফরওয়ার্ড স্বাক্ষরিত, কিউতে রাখা ও রিট্রাই করা হয়, এবং প্রতিটি নম্বর 24/7 পর্যবেক্ষণ করা হয়। প্রতি নম্বরে প্রতি মাসে US$ 9 থেকে US$ 0.75, আরও নম্বর যোগ করলে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
যে আইডিগুলো দেখেছি সেগুলো কতদিন রাখব?
কমপক্ষে 7 দিন, যা Meta-র রিট্রাই উইন্ডো। ষষ্ঠ দিনে Meta যে ডেলিভারি আবার পাঠায়, সেটিকে তার কী-র সঙ্গে মিলতে হবে, নয়তো সেটি নতুন হিসেবে প্রক্রিয়া হবে।
আমার এন্ডপয়েন্ট কয়েক দিন বন্ধ থাকলে আমার কাস্টমারদের মেসেজের কী হবে?
Meta 7 দিন পর্যন্ত রিট্রাই করে, তারপর ওয়েবহুক বাদ দেয়। Coexistence নম্বরে কথোপকথন তখনও ফোনের WhatsApp Business অ্যাপে থাকে, তাই ব্যবসা সেখান থেকে উত্তর দিতে পারে।
যেসব ওয়েবহুক মিস করেছি সেগুলো কি রিপ্লে করতে পারি?
Meta থেকে নয়: ঐতিহাসিক ওয়েবহুক ডেটার কোনো API নেই। Coexistence নম্বরের একবারের ইতিহাস আমদানি শুধু অনবোর্ডিংয়ের সময় চলে, এবং একই সংযোগের জন্য আর অনুরোধ করা যায় না।
Meta কি একই আপডেট একাধিক সার্ভারে পাঠায়?
এটি সেই ফিল্ডের জন্য WhatsApp Business Account-এ সাবস্ক্রাইব করা প্রতিটি অ্যাপে পাঠায়। একটি destination override থাকলে নম্বরের মেসেজ ফিল্ডগুলো সেই অ্যাপের ডিফল্ট কলব্যাকের বদলে override URL-এ যায়।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে