Facebook Page-এর জন্য Messenger ওয়েবহুক: মেসেজ ও মেনশন ইভেন্ট
Facebook-এর Page ওয়েবহুকের messages ফিল্মটি কোনো ব্যক্তি Page-কে Messenger মেসেজ পাঠালে সক্রিয় হয় এবং একটি messaging অ্যারে পাঠায়, যেখানে থাকে প্রেরকের Page-scoped ID, Page-এর আইডি, টাইমস্ট্যাম্প এবং মেসেজের mid, সঙ্গে তার টেক্সট বা অ্যাটাচমেন্ট। mention ফিল্ড Page-এর পোস্ট ও কমেন্টে নতুন মেনশন জানায়, এবং Meta দুটিকেই X-Hub-Signature-256 দিয়ে সই করে।
easyCoexistence সংযুক্ত প্রতিটি Page-এর Messenger মেসেজ ও মেনশন আসার সাথে সাথেই আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে, সেই Page-এর জন্য একটি সিক্রেট দিয়ে সই করে এবং কোনো কপি না রেখে।
Meta কত দ্রুত Messenger ওয়েবহুক এন্ডপয়েন্টকে প্রতিটি নোটিফিকেশনের উত্তরে 200 OK দিতে বলে।
এতক্ষণ ডেলিভারি ব্যর্থ হলে Meta অ্যাপটিকে আবার সাবস্ক্রাইব না করা পর্যন্ত Page-এর ওয়েবহুক থেকে আনসাবস্ক্রাইব করে দেয়।
messages ইভেন্টে প্রেরকের Page-scoped ID, যা প্রতিটি ব্যক্তি ও Page-এর জোড়ার জন্য আলাদা।
Meta-র রেফারেন্সে mention ইভেন্টের sender ফিল্ডটি কীভাবে চিহ্নিত করা আছে।
অতীতের ওয়েবহুক নোটিফিকেশন পরে জিজ্ঞেস করা যায় না, তাই রিসিভারকে যা দরকার তা নিজে সংরক্ষণ করতে হয়।
messages ফিল্ড কী পাঠায়?
কোনো ব্যক্তি Page-কে Messenger মেসেজ পাঠালে একটি নোটিফিকেশন আসে। Meta টেক্সট মেসেজ বা অ্যাটাচমেন্টসহ মেসেজ পাঠায়; অ্যাটাচমেন্ট হতে পারে ছবি, অডিও, ভিডিও, ফাইল বা স্টিকারসহ আরও কিছু ধরনের, এবং শেয়ার করা লিংক ফলব্যাক অ্যাটাচমেন্ট হিসেবে আসতে পারে। আগের মেসেজের উত্তর হলে তাতে reply_to থাকে সেই মেসেজের mid সহ, আর কুইক রিপ্লাই হলে তাতে থাকে তার পেলোড।
messages ইভেন্ট কেমন দেখায়?
ফিড পরিবর্তনের মতো নয়, মেসেজ আসে Page-এর entry-র ভেতরে একটি messaging অ্যারেতে। প্রতিটি ইভেন্টে থাকে sender, অর্থাৎ ব্যক্তির Page-scoped ID; recipient, অর্থাৎ Page; একটি timestamp; এবং message, যার মধ্যে থাকে mid ও টেক্সট, অথবা অ্যাটাচমেন্ট যার সাথে থাকে type ও পেলোড URL:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1458692752478,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1458692752478,
"message": {
"mid": "<MESSAGE_ID>",
"text": "hello, world!"
}
}
]
}
]
}mention ফিল্ড কী পাঠায়?
Page যখন কোনো পোস্ট বা কমেন্টে মেনশন হয়, তখন field mention সহ একটি change আসে, যাতে থাকে post_id বা comment_id, মেসেজ, কোনো লিংক, ছবি বা ভিডিও, এবং item ও verb। Meta সতর্ক করে যে কিছু পোস্ট ও কমেন্ট ID অনুমতির অভাবে বা গোপনীয়তার কারণে কোয়েরি করা যায় না। তাদের রেফারেন্স sender ফিল্ডটিকে শুধু Workplace-এর জন্য চিহ্নিত করে, তাই একটি মেনশন তার লেখককে ছাড়াই আসতে পারে।
কোন Messenger ফিল্ড ফরওয়ার্ড হয় না?
easyCoexistence Page-কে শুধু messages-এ সাবস্ক্রাইব করে, message_echoes, messaging_postbacks, message_reads বা message_deliveries-এ নয়। তাই Page-এর পাঠানো মেসেজ, বাটন ট্যাপ এবং রিড বা ডেলিভারির রসিদ ফরওয়ার্ড হয় না। send_social_dm দিয়ে পাঠানো উত্তর তার নিজের মেসেজ ID ফেরত দেয়।
ইভেন্ট আপনার এন্ডপয়েন্টে কীভাবে পৌঁছায়?
Meta Page-এর ওয়েবহুক পাঠায় সেই অ্যাপে, যা Page ইনস্টল করেছে, পুরো অ্যাপের জন্য একটি কলব্যাক URL দিয়ে। easyCoexistence প্রতিটি ডেলিভারিতে Meta-র X-Hub-Signature-256 যাচাই করে, সাথে সাথেই Meta-কে উত্তর দেয়, এবং সংযুক্ত প্রতিটি Page-এর entry আপনার সেট করা HTTPS এন্ডপয়েন্টে পাঠায়, সেই Page-এর নিজস্ব সিক্রেট দিয়ে সই করে। Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা Partner API-তে PUT /channels/:id/webhook দিয়ে এটি সেট করুন। সিক্রেট একবারই দেখানো হয়, আবার সেট করলে নতুন একটি সিক্রেট তৈরি হয়, এবং URL null হলে ফরওয়ার্ডিং বন্ধ হয়।
ফরওয়ার্ড করা ইভেন্ট কেমন দেখায়?
এটি একটি POST, যাতে থাকে platform, list_social_accounts Page-এর সংযোগের জন্য যে account_id দেয় সেটি, Page-এর আইডি external_id হিসেবে, এবং entry: Page-এর জন্য Meta-র entry, অপরিবর্তিত। sender.id হলো recipient_id, যা 24 ঘণ্টার উইন্ডোর ভেতরে উত্তরের জন্য send_social_dm নেয়:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400000,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399000,
"message": { "mid": "<MESSAGE_ID>", "text": "<MESSAGE_TEXT>" }
}
]
}
}ফরওয়ার্ড করা ইভেন্ট কীভাবে যাচাই করবেন?
প্রতিটি ফরওয়ার্ড করা POST-এ থাকে X-EC-Signature হেডার, t=<unix>,v1=<hex> আকারে। এখানে v1 হলো টাইমস্ট্যাম্প, একটি ডট এবং কাঁচা বডির HMAC-SHA256, Page-এর সই সিক্রেট দিয়ে। বডির উপর ঠিক যেভাবে এসেছে সেভাবেই হিসাব করুন, constant time-এ তুলনা করুন, এবং 5 মিনিটের বেশি পুরনো টাইমস্ট্যাম্প বাতিল করুন।
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}ডেলিভারি কি আবার চেষ্টা করা হয়?
easyCoexistence করে না। প্রতিটি এন্ট্রি একবারই ফরওয়ার্ড হয়, মেমোরিতে, পুনরায় চেষ্টার জন্য কোনো কপি না রেখে। ফরওয়ার্ড উত্তরের জন্য 8 সেকেন্ড অপেক্ষা করে, রিডাইরেক্ট অনুসরণ করে না, এবং শুধু এমন HTTPS ঠিকানায় যায় যা পাবলিক IP-তে রেজল্ভ হয়। Meta উল্লেখ করে যে অতীতের নোটিফিকেশন পরে কোয়েরি করা যায় না, তাই যা দরকার তা আসার সাথে সাথেই সংরক্ষণ করুন। উজানে Meta একটি ব্যর্থ ডেলিভারি কয়েকবার তাৎক্ষণিকভাবে আবার চেষ্টা করে, তাই একই মেসেজ মাঝে মাঝে দুবার পৌঁছাতে পারে: তার mid দিয়ে ডুপ্লিকেট বাদ দিন।
সাধারণ ভুলগুলো
- উত্তর দেওয়ার আগেই কাজ করা। ফরওয়ার্ডিং আবার চেষ্টা করে না, তাই তাৎক্ষণিকভাবে 2xx ফেরত দিন এবং ইভেন্টটি পরে প্রক্রিয়া করুন।
- পার্স করা JSON-এর উপর সই যাচাই করা। HMAC হিসাব করুন কাঁচা বডির উপর, ঠিক যেভাবে এসেছে সেভাবে।
- ধরে নেওয়া যে মেসেজে সবসময় টেক্সট থাকে। স্টিকার, ছবি বা শেয়ার করা লিংক আসে অ্যাটাচমেন্ট হিসেবে, টেক্সট ফিল্ড ছাড়া।
- ডুপ্লিকেট বাদ না দেওয়া। ব্যর্থতার পর Meta একটি ইভেন্ট আবার পাঠাতে পারে, তাই কাজ করার আগে মেসেজের mid-কে চিহ্নিতকারী হিসেবে ব্যবহার করুন।
send_social_dm 24 ঘণ্টার উইন্ডোর ভেতরে উত্তর দেয়। set_social_webhook_destination বা Partner API দিয়ে ফরওয়ার্ডিং চালু করুন। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত বাড়ে তত কমে, প্রথম 3 দিনের ফ্রি ট্রায়াল সহ।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
easyCoexistence কোন ওয়েবহুক ফিল্ডে Page-কে সাবস্ক্রাইব করে?
Messenger-এর জন্য messages এবং মেনশনের জন্য mention, পাশাপাশি Page-এর পোস্ট ও কমেন্টের জন্য feed।
Messenger স্টিকার বা ছবির সাথে কি টেক্সট আসে?
না। স্টিকার, ছবি বা শেয়ার করা লিংক আসে অ্যাটাচমেন্টে, প্রতিটির সাথে type ও পেলোড URL থাকে, এবং মেসেজে কোনো টেক্সট ফিল্ড থাকে না।
Messenger ওয়েবহুক এন্ডপয়েন্টকে কত দ্রুত উত্তর দিতে হবে?
5 সেকেন্ডের মধ্যে 200 OK দিয়ে। ব্যর্থ ডেলিভারির 1 ঘণ্টা পর Meta অ্যাপটিকে Page-এর ওয়েবহুক থেকে আনসাবস্ক্রাইব করে দেয়।
ফরওয়ার্ড করা মেসেজের উত্তর কীভাবে দেব?
ইভেন্টের sender.id-কে recipient_id হিসেবে দিয়ে send_social_dm কল করুন, ব্যক্তির মেসেজের 24 ঘণ্টার মধ্যে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে