গ্রাহকদের WhatsApp মেসেজ ও সোশ্যাল কমেন্ট ওয়েবহুকের মাধ্যমে কীভাবে পাবেন
প্রতিটি সংযোগের জন্য easyCoexistence-এর Partner API-এর মাধ্যমে আপনার গ্রাহকদের WhatsApp মেসেজ বা সোশ্যাল কমেন্টের আলাদা ওয়েবহুক পাওয়া যায়। WhatsApp মেসেজ Meta থেকে সরাসরি সেই URL-এ যায়, এবং তা Tech Provider অ্যাপের গোপন কী দিয়ে স্বাক্ষরিত হয়, আপনার নিজের রাখা কী দিয়ে নয়। তাই URL-এর পথ-অংশে থাকা একটি দীর্ঘ, এলোমেলো গোপন কী সেগুলোকে যাচাই করে। Instagram ও Facebook-এর কমেন্ট ও DM, আর TikTok-এর কমেন্ট, আসামাত্র ফরওয়ার্ড করা হয় এবং প্রতিটি অ্যাকাউন্টের জন্য আলাদাভাবে X-EC-Signature দিয়ে স্বাক্ষরিত হয়।
Meta-র সর্বোচ্চ দৈর্ঘ্য, যে বিকল্প কলব্যাক URL একটি নম্বরের মেসেজ আপনার এন্ডপয়েন্টে পাঠায়।
Meta কত সময় ধরে সেই WhatsApp ওয়েবহুক আবার পাঠাতে থাকে যা আপনার এন্ডপয়েন্ট গ্রহণ করেনি, ক্রমশ কম ঘনঘনভাবে, যা ডুপ্লিকেট তৈরি করতে পারে।
Meta-র নেটওয়ার্ক; whois রুট লুকআপে এর ঠিকানার তালিকা মেলে, যেখান থেকে WhatsApp ওয়েবহুক আসে, এবং Meta সেগুলো নিয়মিত বদলায়।
Meta অনুযায়ী একটি WhatsApp ওয়েবহুক পেলোড সর্বোচ্চ কত বড় হতে পারে।
ফরওয়ার্ড করা ইভেন্টের স্বাক্ষরিত টাইমস্ট্যাম্প কতক্ষণ পরে প্রত্যাখ্যান করা উচিত, এবং HMAC কীভাবে constant time-এ তুলনা হয়।
একটি সংযোগ কীভাবে নিজস্ব গন্তব্য পায়?
প্রতিটি রিসোর্সের জন্য একটি কল। একটি WhatsApp নম্বর PUT /connections/{id}/webhook কল করে, সঙ্গে url ও verify_token, অথবা কানেক্ট সেশনে একই জোড়া webhook_url ও webhook_verify_token হিসেবে দেয়, যাতে নম্বরটি প্রথম মিনিট থেকেই আপনার দিকে রাউট হয়। একটি সোশ্যাল অ্যাকাউন্ট সংযুক্ত হওয়ার পরে PUT /channels/{id}/webhook কল করে। যেকোনো একটিতে url null দিলে ডেলিভারি বন্ধ হয়ে যায়। দুই পথ আলাদা: কে ডেলিভারি করে এবং আপনি কীভাবে যাচাই করেন:
| WhatsApp number | Instagram, Facebook, TikTok | |
|---|---|---|
| Set with | webhook_url on the session, or PUT /connections/{id}/webhook | PUT /channels/{id}/webhook, after it connects |
| Delivered by | Meta, straight to your URL | easyCoexistence, forwarding each event as it arrives |
| Body | Meta's webhook, unchanged | platform, account_id, external_id and the network's entry |
| Authenticate | A long random secret in the URL path | X-EC-Signature, keyed with the account's secret |
| Retries | Meta's own, for up to 7 days | None: one attempt |
| Copy kept | None | None |
কীভাবে একটি নম্বরের মেসেজ আপনার এন্ডপয়েন্টে পাঠাবেন?
একটি HTTPS URL দিন, যার পথে একটি দীর্ঘ, এলোমেলো গোপন কী থাকে, সঙ্গে একটি ভেরিফাই টোকেন: কানেক্ট সেশনে webhook_verify_token (8 থেকে 200 অক্ষর) বা PUT-এ verify_token। Meta হ্যান্ডশেকের জন্য hub.mode=subscribe, hub.verify_token ও hub.challenge সহ একটি GET পাঠিয়ে URL তৎক্ষণাৎ পরীক্ষা করে, এবং টোকেন মিললে আপনার এন্ডপয়েন্টকে hub.challenge-এর মান ফেরত দিতে হবে। হ্যান্ডশেক ব্যর্থ হলে PUT ফেরত দেয় 502 meta_rejected সহ Meta-র নিজস্ব বার্তা; কানেক্ট সেশনে নম্বরটি তবু সংযুক্ত হয়, এবং সেশনের last_error ব্যাখ্যা করে কেন URL প্রয়োগ হয়নি।
import express from "express";
import { timingSafeEqual } from "node:crypto";
const PATH_SECRET = process.env.WA_PATH_SECRET; // the random part of webhook_url
const VERIFY_TOKEN = process.env.WA_VERIFY_TOKEN; // the verify token you sent
const app = express();
function same(a, b) {
const x = Buffer.from(String(a)), y = Buffer.from(String(b));
return x.length === y.length && timingSafeEqual(x, y);
}
// Meta's handshake, run when the destination is set
app.get("/wa/:secret", (req, res) => {
if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
if (req.query["hub.mode"] !== "subscribe" || !same(req.query["hub.verify_token"], VERIFY_TOKEN)) {
return res.sendStatus(403);
}
res.send(req.query["hub.challenge"]);
});
// Messages, echoes and the one-time import; payloads reach 3 MB
app.post("/wa/:secret", express.json({ limit: "4mb" }), (req, res) => {
if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
res.sendStatus(200); // answer first: Meta retries for up to 7 days
enqueue(req.body); // deduplicate on each message id before acting
});কেন Meta-র স্বাক্ষর যাচাই করা যায় না, আর তার বদলে কী?
Meta প্রতিটি ডেলিভারি X-Hub-Signature-256 দিয়ে স্বাক্ষর করে, যা পেলোডের HMAC-SHA256, গ্রহণকারী অ্যাপের App Secret দিয়ে তৈরি। আপনার গ্রাহকদের নম্বরের ক্ষেত্রে সেই অ্যাপ হলো easyCoexistence-এর Tech Provider অ্যাপ, এবং তার গোপন কী কখনো শেয়ার করা হয় না, তাই আপনার দিক থেকে হেডারটি যাচাই করা যায় না। তার বদলে URL-এর পথে থাকা দীর্ঘ, এলোমেলো গোপন কীটিই পরিচয়পত্র: সেটি constant time-এ তুলনা করুন এবং অন্য সবকিছু প্রত্যাখ্যান করুন। দ্বিতীয় স্তর হিসেবে Meta-র AS32934-এ নিবন্ধিত রুটের তালিকা অনুমোদিত তালিকায় রাখুন এবং তালিকাটি নিয়মিত হালনাগাদ করুন, কারণ Meta তার IP ঠিকানা মাঝে মাঝে বদলায়।
কোন WhatsApp ওয়েবহুক আপনার URL-এ পৌঁছায়?
Meta একটি বিকল্প কলব্যাক URL যে ফিল্ডগুলো বহন করতে দেয়: messages, যা গ্রাহকরা পাঠান এবং আপনার পাঠানো বার্তার স্ট্যাটাস; smb_message_echoes, যা ব্যবসা WhatsApp Business অ্যাপ থেকে পাঠায়; এবং একবারের ইমপোর্টের history ও smb_app_state_sync। Meta কখনো টেমপ্লেট ওয়েবহুক, বা account_update-এর মতো অ্যাকাউন্ট ওয়েবহুক, কোনো ওভাররাইডে পাঠায় না। সেগুলো বরং easyCoexistence-এর কলব্যাকে পৌঁছায়, এ কারণেই টেমপ্লেট রিভিউ পোলিং দিয়ে পড়া হয় এবং ড্রপ হলে তা স্ট্যাটাস ইভেন্ট হিসেবে আপনার কাছে আসে।
- গন্তব্যটি WhatsApp Business Account-এ সেট হয়, তাই একই অ্যাকাউন্টের দুটি নম্বর একটি গন্তব্য ভাগ করে: value.metadata.
phone_number_idদেখে রাউট করুন। - মিডিয়া আসে একটি ID হিসেবে; ক্রেডেনশিয়াল কলের গ্রাহকের টোকেন দিয়ে Meta থেকে ফাইলটি আনুন।
- পেলোড 3 MB পর্যন্ত হতে পারে, তাই 3 MB-র নিচে সেট করা যেকোনো বডি-সাইজ সীমা বাড়ান।
একটি ফরওয়ার্ড করা সোশ্যাল ইভেন্ট কেমন দেখায়?
Content-Type application/json এবং একটি X-EC-Signature হেডার সহ একটি POST, যাতে চারটি কী থাকে: platform; account_id, Partner API যে চ্যানেল ID ব্যবহার করে; external_id, নেটওয়ার্কে অ্যাকাউন্টের ID; এবং entry। Instagram ও Facebook-এর ক্ষেত্রে entry হলো Meta-র ওয়েবহুক entry অপরিবর্তিত, কমেন্ট ও মেনশনের জন্য changes এবং DM-এর জন্য messaging সহ। TikTok-এর ক্ষেত্রে এতে থাকে comment.update ইভেন্ট, তার কন্টেন্ট পার্স করা অবস্থায়, এবং comment_id, video_id ও parent_comment_id স্ট্রিং হিসেবে, যাতে 64-bit ID রাউন্ড না হয়।
- Instagram অ্যাকাউন্ট কমেন্ট, মেসেজ ও মেনশনে সাবস্ক্রাইব করা; Facebook Pages-এ feed, messages ও mention; TikTok পাঠায় comment.update।
- easyCoexistence YouTube বা LinkedIn থেকে কোনো কমেন্ট ইভেন্ট পায় না: তাদের PUT 400
not_supportedফেরত দেয়, এবং তাদের কমেন্ট প্রতিটি নেটওয়ার্কের API দিয়ে ক্রেডেনশিয়াল সহ পড়া হয়। - ফরওয়ার্ডে X-EC-Event বা X-EC-Delivery হেডার থাকে না, তাই নেটওয়ার্কের নিজস্ব ID দিয়ে ডুপ্লিকেট বাদ দিন, যেমন কমেন্ট ID বা মেসেজের mid।
{
"platform": "instagram",
"account_id": "<CHANNEL_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793440800,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}X-EC-Signature ধাপে ধাপে কীভাবে যাচাই করবেন?
PUT /channels/{id}/webhook যে signing_secret ফেরত দেয় তা দিয়ে, যা একবারই দেখানো হয় এবং সেই অ্যাকাউন্টের জন্য অনন্য। হেডারটি পড়তে হবে t=<unix>,v1=<hex> আকারে। তারপর প্রতিটি ডেলিভারির জন্য:
- JSON পার্স করার আগে কাঁচা রিকোয়েস্ট বডি বাইট হিসেবে পড়ুন।
- হেডারকে কমা দিয়ে ভাগ করুন: t, সেকেন্ডে Unix সময়, এবং v1, hex ডাইজেস্ট।
- t আপনার ঘড়ি থেকে 5 মিনিটের বেশি দূরে হলে ডেলিভারি প্রত্যাখ্যান করুন।
- সেই অ্যাকাউন্টের গোপন কী দিয়ে, t, একটি ডট ও কাঁচা বডির উপর HMAC-SHA256 গণনা করুন, hex হিসেবে।
- constant time-এ v1-এর সাথে তুলনা করুন, তারপর 2xx দিন এবং কাজটি সারিতে রাখুন।
import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";
const app = express();
const secrets = new Map(); // channel id -> signing_secret, kept in your database
app.post("/hooks/social", express.raw({ type: "application/json" }), (req, res) => {
const sig = Object.fromEntries(
(req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("=", 2)),
);
if (!/^\d+$/.test(sig.t ?? "") || Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) {
return res.sendStatus(401); // missing or stale timestamp
}
let event;
try {
event = JSON.parse(req.body.toString("utf8")); // platform, account_id, external_id, entry
} catch {
return res.sendStatus(400);
}
const secret = secrets.get(event.account_id);
if (!secret || !sig.v1) return res.sendStatus(401);
const expected = createHmac("sha256", secret)
.update(sig.t + ".")
.update(req.body) // the raw bytes, exactly as they arrived
.digest("hex");
if (expected.length !== sig.v1.length ||
!timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1))) {
return res.sendStatus(401);
}
res.sendStatus(204); // one attempt and no retries: acknowledge, then work
enqueue(event);
});কোনো গন্তব্য সেট না থাকলে কী হয়?
কিছুই আপনার কাছে পৌঁছায় না, এবং পরে পাঠানোর জন্যও কিছু অপেক্ষা করে না। webhook_url নেই এমন নম্বর easyCoexistence-এর কলব্যাকে ফিরে যায়, যেখানে তার মেসেজ সংরক্ষণ ছাড়াই বাদ পড়ে, এবং সে চ্যাট ইতিহাস ইমপোর্টও পায় না, কারণ সেটি কেবল একটি গন্তব্য থাকলেই অনুরোধ করা হয়। গন্তব্যহীন সোশ্যাল অ্যাকাউন্ট ফরওয়ার্ড হয় না: তার ইভেন্টগুলো easyCoexistence-এর অ্যাপে পৌঁছায়, কিন্তু আপনার জন্য কোনোটিই জমা থাকে না। ট্রাফিক দরকার হওয়ার আগেই প্রতিটি গন্তব্য সেট করুন।
সংযোগ বিচ্ছিন্ন বা মুছে গেলে গন্তব্যের কী হয়?
একটি নম্বর তার গন্তব্য রেকর্ডে ধরে রাখে। বিচ্ছিন্ন নম্বর আবার সংযুক্ত হলে easyCoexistence Meta-র সাথে আপনার URL আবার সেট করে, স্থগিত নম্বর ফিরে এলেও একই ঘটে। সোশ্যাল অ্যাকাউন্ট মুছে ফেলা হলে তার গন্তব্য ও গোপন কী মুছে যায়, তাই পুনরায় সংযুক্ত হওয়ার পরে PUT /channels/{id}/webhook আবার কল করুন এবং নতুন গোপন কীটি সংরক্ষণ করুন। URL সহ কল করা হলে PUT প্রতিবার একটি নতুন গোপন কী ইস্যু করে, এবং পুরনোটি তৎক্ষণাৎ স্বাক্ষর করা বন্ধ করে।
কীভাবে সেট আপ করবেন
- Put a secret in the URLChoose an HTTPS URL whose path holds a long random string, 200 characters or fewer in all, and make its GET answer Meta's hub.challenge.
- Route the number's messagesSend webhook_url and webhook_verify_token on the connect session, or PUT /connections/{id}/webhook once the number is connected.
- Turn on each social accountCall PUT /channels/{id}/webhook with your URL and store the signing_secret it returns against that channel.
- Verify, then acknowledgeCheck the path secret on WhatsApp deliveries and X-EC-Signature on forwarded ones, answer 2xx at once, then process from a queue.
সাধারণ ভুলগুলো
- আপনার গ্রাহকদের WhatsApp ডেলিভারিতে X-Hub-Signature-256 যাচাই করা। Meta সেটি easyCoexistence-এর অ্যাপের গোপন কী দিয়ে গণনা করে, যা কখনো শেয়ার করা হয় না, তাই যাচাই কখনো পাস করবে না; URL-এর পথে থাকা গোপন কী দিয়ে যাচাই করুন।
- পার্স করা JSON-এর উপর X-EC-Signature যাচাই করা। HMAC কাঁচা বডির প্রতিটি বাইটের উপর গণনা হয়, এবং পুনরায় সিরিয়ালাইজ করলে বাইট বদলে যায়, তাই পার্স করার আগে যাচাই করুন।
- প্রতিটি চ্যানেলের জন্য একটি গোপন কী ব্যবহার করা। প্রতিটি সোশ্যাল অ্যাকাউন্ট নিজের গোপন কী দিয়ে স্বাক্ষর করে, এবং স্ট্যাটাস ইভেন্ট আরেকটি দিয়ে, তাই account_id দিয়ে গোপন কীটি খুঁজুন।
- ফরওয়ার্ড করা ইভেন্টের উত্তর দেওয়ার আগে ধীর কাজ করা। এটি একবারই পাঠানো হয়, আপনার উত্তরের জন্য 8 সেকেন্ড অপেক্ষা করে এবং কখনো আবার চেষ্টা করা হয় না, তাই আগে 2xx দিন, পরে প্রক্রিয়া করুন।
easyCoexistence প্রতিটি গ্রাহক নম্বরের মেসেজ Meta থেকে সরাসরি আপনার সার্ভারে পাঠায়, এবং Instagram ও Facebook-এর কমেন্ট ও DM, আর TikTok-এর কমেন্ট, আসামাত্র আপনার এন্ডপয়েন্টে ফরওয়ার্ড করে, প্রতিটি অ্যাকাউন্টের জন্য আলাদা স্বাক্ষরসহ, কোনো কপি না রেখে এবং প্রতিটি সংযোগ 24/7 পর্যবেক্ষণ করে। প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সাথে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
আমার গ্রাহকদের WhatsApp মেসেজে Meta-র স্বাক্ষর কি যাচাই করা যায়?
না। Meta সেগুলো easyCoexistence-এর Tech Provider অ্যাপের গোপন কী দিয়ে স্বাক্ষর করে, যা কখনো শেয়ার করা হয় না। আপনার URL-এর পথে থাকা দীর্ঘ, এলোমেলো গোপন কী দিয়ে যাচাই করুন, এবং চাইলে Meta-র IP পরিসরও ব্যবহার করুন।
YouTube ও LinkedIn সংযোগ কি কমেন্ট ইভেন্ট ফরওয়ার্ড করে?
না। easyCoexistence এ দুটির কোনোটি থেকেই কমেন্ট ইভেন্ট পায় না, তাই PUT /channels/{id}/webhook 400 not_supported ফেরত দেয়। তাদের কমেন্ট প্রতিটি নেটওয়ার্কের API দিয়ে চ্যানেলের ক্রেডেনশিয়াল সহ পড়ুন।
আমার সার্ভার বন্ধ থাকলে কি ফরওয়ার্ড করা সোশ্যাল ইভেন্ট আবার চেষ্টা করা হয়?
না। প্রতিটি একবারই পাঠানো হয় এবং কোনো কপি রাখা হয় না। WhatsApp ডেলিভারি আলাদা, কারণ Meta নিজেই সেগুলো 7 দিন পর্যন্ত আবার চেষ্টা করে।
মেসেজ কি easyCoexistence-এর মধ্য দিয়ে যায়?
WhatsApp-এ নয়: Meta একটি নম্বরের মেসেজ আপনার সেট করা ওয়েবহুকে সরাসরি পাঠায়। সোশ্যাল নেটওয়ার্কের কমেন্ট ও DM আসামাত্র আপনার এন্ডপয়েন্টে ফরওয়ার্ড হয়, প্রতিটি অ্যাকাউন্টের জন্য আলাদা স্বাক্ষরসহ, কোনো কপি না রেখে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে