Facebook-এর মেনশন ওয়েবহুক: কেউ আপনার Page-কে মেনশন করলে
Facebook-এর Page ওয়েবহুকের মেনশন ফিল্ড কেউ কোনো পোস্ট বা কমেন্টে Page-কে মেনশন করলে একটি অ্যাপকে জানায়। Meta এমন একটি পরিবর্তন পাঠায় যার field-এর মান mention, এবং যার value-তে থাকতে পারে post_id, কমেন্টের ক্ষেত্রে comment_id, message-এর টেক্সট, সংযুক্ত লিংক ও মিডিয়া, এবং item ও verb। এটি একটি POST রিকোয়েস্টে আসে, যা X-Hub-Signature-256 দিয়ে সাইন করা থাকে।
easyCoexistence আপনার সংযুক্ত প্রতিটি Page-কে feed ও messages-এর পাশাপাশি mention ফিল্ডে সাবস্ক্রাইব করে, এবং মেনশন ইভেন্টগুলো আসামাত্র আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে।
নতুন মেনশনের জন্য Page ওয়েবহুকের ফিল্ড, যার মধ্যে কমেন্ট ও পোস্টে মেনশনও রয়েছে।
Page ওয়েবহুক কোনো অ্যাপের কলব্যাক URL-এ পৌঁছানোর আগে MODERATE অধিকারসম্পন্ন একজন Page অ্যাডমিনকে যে অনুমতি দিতে হয়।
একটি পোস্ট বা কমেন্টে কীভাবে কেউ Page-কে মেনশন করে: @ টাইপ করে Page-এর নাম লিখুন, তারপর সেটি বেছে নিন।
Meta ব্যর্থ একটি Page নোটিফিকেশন বাতিল করার আগে কতক্ষণ ধরে কমতে থাকা ফ্রিকোয়েন্সিতে আবার চেষ্টা করে।
/{page-id}/tagged এজ প্রতিটি পাবলিক পোস্টে যে ফিল্ড যোগ করে, যেখানে Page-কে ট্যাগ করা হয়েছে।
মেনশন ওয়েবহুক কী ঘটালে সেটি চালু হয়?
কেউ কোনো পোস্ট বা কমেন্টে Page-কে মেনশন করলে। Facebook-এ @ টাইপ করে Page-এর নাম লিখে পরামর্শের তালিকা থেকে সেটি বেছে নিলে মেনশন হয়, এবং Meta-র রেফারেন্স এই ফিল্ডকে Page-এর নতুন মেনশন হিসেবে বর্ণনা করে, যার মধ্যে কমেন্ট ও পোস্টে মেনশনও রয়েছে। Facebook-এর হেল্প সেন্টার জানায়, Page-এর সেটিংস মানুষকে সেটি মেনশন করা থেকে বিরত রাখতে পারে।
মেনশনের নোটিফিকেশন কেমন দেখায়?
একটি POST, যার object হলো page, এবং মেনশন হওয়া Page-এর জন্য একটি এন্ট্রি: তার ID, একটি সময় এবং একটি changes অ্যারে যার field হলো mention। Meta-র রেফারেন্স value-এর ফিল্ডগুলো তালিকাভুক্ত করে কিন্তু কোনো নমুনা দেয় না, তাই পোস্টে এই মেনশনের আকৃতি ওই তালিকা থেকে এভাবে ধরা হয়েছে:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
]
}মেনশনের প্রতিটি ফিল্ডের অর্থ কী?
এগুলো Meta-র রেফারেন্সে value-এর ফিল্ড; কোনটি একটি নোটিফিকেশনে আসবে তা পোস্ট বা কমেন্টের ওপর নির্ভর করে:
post_id: যে পোস্ট Page-কে মেনশন করেছে তার ID।comment_id: কমেন্টের ID, যখন মেনশনটি কমেন্টে থাকে;parent_id: এর প্যারেন্টের ID।- message: যে টেক্সটে মেনশনটি আছে।
- link, photo, photos ও video: পোস্ট বা কমেন্টে সংযুক্ত জিনিসের লিংক।
- item ও verb: অবজেক্টের ধরন এবং তার সঙ্গে যা ঘটেছে, feed ফিল্ডে ব্যবহৃত একই তালিকা থেকে।
created_time: পোস্ট বা কমেন্ট কখন তৈরি হয়েছিল।- from ও
message_tags: লেখক এবং টেক্সটে ট্যাগ করা প্রোফাইল, দুটোই শুধু Workplace-এর জন্য চিহ্নিত। - এছাড়াও তালিকাভুক্ত: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_idওopen_graph_story_id।
মেনশন ফিল্डের জন্য কোন অনুমতি লাগে?
pages_manage_metadata, যা Page ওয়েবহুক অ্যাপে পৌঁছানোর আগে MODERATE অধিকারসম্পন্ন একজন Page অ্যাডমিনের দেওয়া প্রয়োজন বলে Meta জানায়। Page সাবস্ক্রাইব করা হয় POST /{page-id}/subscribed_apps দিয়ে, যেখানে subscribed_fields-এর মধ্যে mention থাকে; এজন্য এমন একটি Page টোকেন লাগে যা CREATE_CONTENT, MANAGE বা MODERATE টাস্কের অধিকারী কারও থেকে এসেছে, সঙ্গে pages_manage_metadata ও pages_show_list। অ্যাপকেও mention-এ সাবস্ক্রাইব করতে হয়, কারণ দুই স্তরেই সাবস্ক্রাইব করা ফিল্ডই কেবল পাঠানো হয়; আর যাদের অ্যাপে কোনো ভূমিকা নেই এমন লোকজনের Page-এর জন্য Advanced Access-এ ওই অনুমতিগুলো লাগে।
মেনশন করা পোস্ট বা কমেন্ট কীভাবে পড়বেন?
এর ID দিয়ে, যেখানে Meta অনুমতি দেয় সেখানে Page-এর টোকেন দিয়ে। Page টোকেন দিয়ে Page-এ বা Page-এর দ্বারা প্রকাশিত পোস্ট পড়া যায়; অন্য Page-এর পাবলিকভাবে শেয়ার করা পোস্টের জন্য একজন Page অ্যাডমিনের টোকেনে pages_manage_posts ও Page Public Content Access ফিচার লাগে; আর কোনো ব্যক্তির নিজের পোস্ট পড়াকে Meta সেই ব্যক্তির user_posts অনুমতির সঙ্গে যুক্ত করে।
GET https://graph.facebook.com/<POST_ID>
?fields=message,permalink_url,created_time
&access_token=<PAGE_ACCESS_TOKEN>
GET https://graph.facebook.com/<COMMENT_ID>
?fields=message,from,created_time
&access_token=<PAGE_ACCESS_TOKEN>Page তার মেনশনগুলো আর কোথায় খুঁজে পেতে পারে?
tagged এজে। GET /{page-id}/tagged সেই পাবলিক পোস্টগুলোর তালিকা দেয় যেখানে Page-কে ট্যাগ করা হয়েছে, প্রতিটির সঙ্গে একটি tagged_time থাকে; ওয়েবহুক সেট আপ করার আগের পোস্টও এর আওতায় পড়ে। এর জন্য CREATE_CONTENT, MANAGE বা MODERATE টাস্কের অধিকারী কারও Page টোকেন লাগে, সঙ্গে pages_read_user_content ও pages_show_list, এবং Meta বলে Page Public Content Access ফিচারও লাগতে পারে। কোনো ব্যক্তির পোস্টে Meta from শুধু যিনি লিখেছেন তাকেই ফেরত দেয়।
easyCoexistence মেনশন ইভেন্ট কীভাবে পাঠায়?
প্রতিটি Page যখন সংযুক্ত হয়, তখন এটি feed ও messages-এর পাশাপাশি mention-এ সাবস্ক্রাইব করে। এর অ্যাপ প্রতিটি ডেলিভারিতে X-Hub-Signature-256 যাচাই করে, Meta-কে সঙ্গে সঙ্গে উত্তর দেয় এবং Page-এর প্রতিটি এন্ট্রি অপরিবর্তিত অবস্থায় Partner API-তে set_social_webhook_destination বা PUT /channels/:id/webhook দিয়ে আপনার সেট করা HTTPS এন্ডপয়েন্টে POST করে:
- X-EC-Signature-এ থাকে t=<unix>,v1=<hex>: টাইমস্ট্যাম্প, একটি ডট এবং কাঁচা বডির HMAC-SHA256, যার চাবি Page-এর সাইনিং সিক্রেট।
- সিক্রেট শুরু হয় whsec_ দিয়ে এবং একবারই দেখানো হয়; URL আবার সেট করলে নতুন সিক্রেট তৈরি হয়, আর URL null করলে ফরওয়ার্ড করা বন্ধ হয়।
- প্রতিটি এন্ট্রি একবারই যায়, সর্বোচ্চ 8 সেকেন্ড অপেক্ষা করে, এমন একটি HTTPS ঠিকানায় যা একটি পাবলিক IP-তে সমাধান হয়; কোনো রিডাইরেক্ট অনুসরণ করা হয় না এবং কোনো কপি রাখা হয় না।
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
}সাধারণ ভুলগুলো
- entry.time-কে মেনশনের মুহূর্ত ধরা। Meta এটি নোটিফিকেশন পাঠানোর সময়ে সেট করে; value-এর created_time পোস্ট বা কমেন্ট কখন তৈরি হয়েছিল তার তারিখ দেয়।
- কোনো লুকআপ ব্যর্থ হলে সেটিকে ভাঙা ইভেন্ট মনে করা। Meta সতর্ক করে যে মেনশন নোটিফিকেশনের কিছু post_id ও comment_id অনুমতির অভাবে বা গোপনীয়তার কারণে কোয়েরি করা যায় না, তাই মেসেজের টেক্সট ইভেন্ট থেকেই সংরক্ষণ করুন।
- ফরওয়ার্ড উত্তর দেওয়ার আগে পোস্ট আনা। ফরওয়ার্ড পুনরায় চেষ্টা করা হয় না, তাই সঙ্গে সঙ্গে একটি 2xx ফেরত দিন এবং পোস্টটি পরে খুঁজুন।
প্রতিটি Page-এর জন্য আলাদা সিক্রেটে সাইন করা থাকে এবং কোনো কপি রাখা হয় না, যাতে আপনার এজেন্ট প্রতিটি মেনশন ঘটার সঙ্গে সঙ্গে জানতে পারে। প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন বিনামূল্যে।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
মেনশন ওয়েবহুক কি জানায় কে Page-কে মেনশন করেছে?
Page-এর ক্ষেত্রে না: Meta-র রেফারেন্স from-কে শুধু Workplace-এর জন্য চিহ্নিত করে। পোস্ট বা কমেন্টের ID দিয়ে খুঁজলে, Meta-র অনুমতি অনুমোদন করলে, সেটি লেখককে ফেরত দিতে পারে।
Page সাবস্ক্রাইব হওয়ার আগের মেনশন কি পাওয়া যায়?
ওয়েবহুক থেকে নয়, কারণ Meta কোয়েরি করার জন্য কোনো নোটিফিকেশনের ইতিহাস রাখে না। tagged এজ সেইসব পাবলিক পোস্টের তালিকা দেয় যেখানে Page-কে ট্যাগ করা হয়েছে।
মেনশন ফিল্ড feed থেকে কীভাবে আলাদা?
feed জানায় Page-এর নিজের ফিডে পরিবর্তন, যেমন পোস্ট, কমেন্ট ও সেখানে রিঅ্যাকশন; mention জানায় একটি পোস্ট বা কমেন্টে Page-কে মেনশন করা হয়েছে। প্রতিটি ফিল্ড আলাদাভাবে সাবস্ক্রাইব করা হয়।
easyCoexistence-এর কমেন্টের নিয়মগুলো কি মেনশনে কাজ করে?
না। নিয়ম ও অটোমেশন কাজ করে feed ফিল্ডের কমেন্ট এবং Messenger-এর মেসেজের ওপর; মেনশনের পরিবর্তনগুলো Meta যেভাবে পাঠিয়েছে ঠিক সেভাবেই আপনার এন্ডপয়েন্টে ফরওয়ার্ড করা হয়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে