ওয়েবহুকে Instagram Story-র মেনশন ও রিপ্লাই
Instagram Story-র মেনশন ও রিপ্লাই messages ফিল্ডে DM হিসেবে আসে। মেনশন আসে একটি মেসেজ হিসেবে, যার attachments-এ থাকে story_mention টাইপের একটি আইটেম, এবং payload.url-এ থাকে Story-র CDN URL। রিপ্লাইয়ে থাকে ব্যক্তির লেখা টেক্সট এবং reply_to.story, যার সঙ্গে আছে Story-র url ও id, আর লিংক স্টিকারওয়ালা Story-র ক্ষেত্রে link_sticker_url।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে messages-এ সাবস্ক্রাইব করে, তাই Story-মেনশন ও Story-রিপ্লাই আসামাত্র অন্য DM-এর সঙ্গে আপনার HTTPS এন্ডপয়েন্টে পৌঁছায়।
মেসেজ ইভেন্টের সেই অ্যাটাচমেন্ট টাইপ, যা Meta পাঠায় কেউ তার Story-তে অ্যাকাউন্টকে মেনশন করলে।
reply_to.story-তে Meta-র যোগ করা ফিল্ড, 12 ডিসেম্বর 2025 থেকে; এতে থাকে যে Story-তে উত্তর দেওয়া হয়েছে তার লিংক স্টিকারের URL।
Story কতক্ষণ থাকে; মেয়াদ শেষ হলে বা মুছে ফেললে তার মেনশন URL আর রেন্ডার হয় না।
কোন অ্যাকাউন্টের Story-মেনশন আসে; প্রাইভেট অ্যাকাউন্টের মেনশন আসে শুধু তখনই, যদি সে প্রফেশনাল অ্যাকাউন্ট ফলো করে।
Meta-র Instagram Messaging গাইড অনুযায়ী যেসব Story রিপ্লাই ওয়েবহুক সমর্থন করে না।
একটি Story মেনশন কীভাবে আসে?
DM হিসেবে। কেউ তার Story-তে প্রফেশনাল অ্যাকাউন্টকে মেনশন করলে Instagram সেই Story-র উল্লেখসহ একটি মেসেজ অ্যাকাউন্টের ইনবক্সে রাখে, এবং Meta তার জন্য একটি messages ইভেন্ট পাঠায়। sender.id হলো ব্যক্তির Instagram-scoped ID, আর message.attachments-এ থাকে story_mention টাইপের একটি আইটেম, যার payload.url হলো Story-র CDN URL। Meta-র নমুনায় কোনো টেক্সট থাকে না, তাই অ্যাটাচমেন্টটি পড়তে হবে:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}একটি Story রিপ্লাই কীভাবে আসে?
এটিও DM হিসেবে, ব্যক্তির মেসেজ এবং একটি reply_to অবজেক্টসহ, যা অ্যাকাউন্টের Story-র দিকে নির্দেশ করে। reply_to.story-তে থাকে Story-র CDN url ও তার id। Meta-র ওয়েবহুক রেফারেন্সে সেখানে link_sticker_url-ও তালিকাভুক্ত, যা ডিসেম্বর 2025-এ যোগ হয়েছে লিংক স্টিকারওয়ালা Story-র রিপ্লাইয়ের জন্য; Meta লিংক অনুযায়ী অটোমেশন রাউট করতে এটি ব্যবহারের পরামর্শ দেয়। পুরনো কোনো মেসেজের ইনলাইন রিপ্লাই হলে তার বদলে reply_to.mid ব্যবহৃত হয়।
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}প্রতিটি ফিল্ডের মানে কী?
Meta এই দুই ইভেন্টের জন্য যেসব ফিল্ড নথিভুক্ত করেছে, বাইরে থেকে ভেতরের দিকে:
- entry[].id ও recipient.id: প্রফেশনাল অ্যাকাউন্ট। sender.id: ব্যক্তির Instagram-scoped ID, যার কাছে রিপ্লাই যায়।
- timestamp: মেসেজ পাঠানোর সময়, Meta-র নমুনায় মিলিসেকেন্ডে; entry[].time হলো যখন Meta নোটিফিকেশনটি পাঠিয়েছে।
- message.mid: মেসেজ ID, পুনরায় চেষ্টার ডুপ্লিকেট বাদ দিতে এবং
reply_to.mid দিয়ে উত্তর দিতে। - attachments[].type
story_mentionও payload.url: একটি মেনশন, এবং যে Story-তে সেটি হয়েছে তার CDN URL। reply_to.story.url ওreply_to.story.id: অ্যাকাউন্টের যে Story-তে ব্যক্তি উত্তর দিয়েছে।reply_to.story.link_sticker_url: সেই Story-র লিংক স্টিকারের URL।- message.text: রিপ্লাইয়ের কথা, মেসেজে টেক্সট থাকলে তা।
Story URL কতক্ষণ কাজ করে?
Story যতক্ষণ থাকে ততক্ষণ। Story 24 ঘণ্টা পর মিলিয়ে যায়, বা লেখক মুছে ফেললে আগেই; Meta-র story mention গাইড বলে তখন URL আর রেন্ডার হয় না। এর ওভারভিউ জানায়, Instagram-এর CDN URL গোপনীয়তা-সচেতন, এবং মুছে ফেলা বা মেয়াদ শেষ কনটেন্টের জন্য কিছুই ফেরত দেয় না। একই গাইড CDN URL রাখার অনুমতি দেয়, কিন্তু মিডিয়া নয়: অ্যাপ Story-র কনটেন্ট নিজের সার্ভারে সংরক্ষণ বা ক্যাশ করতে পারবে না, এবং Story চলে গেলে একটি প্লেসহোল্ডার দেখাতে হবে।
কখন কোনো ইভেন্টই ফায়ার হয় না?
Meta-র গাইডে এই ক্ষেত্রগুলো উল্লেখ আছে, যেখানে Story ইভেন্টের অপেক্ষায় থাকা হ্যান্ডলার কিছুই পায় না:
- এমন প্রাইভেট অ্যাকাউন্টের Story-মেনশন, যে প্রফেশনাল অ্যাকাউন্ট ফলো করে না।
- সাধারণ পোস্টে ট্যাগ: Meta বলে শুধু Story-মেনশনই messages ওয়েবহুক ট্রিগার করে, পোস্টে ট্যাগ নয়।
- GIF বা স্টিকার দিয়ে করা Story রিপ্লাই, যা ওয়েবহুক সমর্থন করে না।
- mentions API-র মাধ্যমে Story: GET /<
IG_ID>/tags ও POST /<IG_ID>/mentions এগুলো সমর্থন করে না, তাই Story-মেনশন আসে DM হিসেবে।
Story-মেনশন ও রিপ্লাই কি মেসেজিং উইন্ডো খোলে?
রিপ্লাই হলো ব্যক্তির পাঠানো মেসেজ, এবং Meta Story-মেনশনকেও সেই চ্যানেলগুলোর মধ্যে রাখে যার মাধ্যমে ব্যক্তি কথোপকথন শুরু করে। তাদের কাজে যে উইন্ডো খোলে, তা বেশিরভাগ কাজের জন্য 24 ঘণ্টা স্থায়ী হয়; এই সময়ে অ্যাকাউন্ট ইভেন্টের sender.id-কে recipient.id বসিয়ে POST /<IG_ID>/messages দিয়ে উত্তর দিতে পারে। অ্যাকাউন্টের উত্তর messages-এ ফিরে আসে একটি echo হিসেবে, যেখানে is_echo true সেট থাকে।
easyCoexistence এগুলো কীভাবে ফরওয়ার্ড করে?
messages ফিল্ডে, যাতে প্রতিটি সংযুক্ত অ্যাকাউন্ট সাবস্ক্রাইব করা থাকে, তাই Story-মেনশন ও Story-রিপ্লাই অ্যাকাউন্টের অন্য DM-এর সঙ্গে আপনার এন্ডপয়েন্টে পৌঁছায়: প্রতিটি এন্ট্রি একটি এনভেলাপের ভেতরে, যাতে থাকে platform, account_id, external_id ও entry; অ্যাকাউন্টের সিক্রেট দিয়ে X-EC-Signature-এ সাইন করা, একবারই পাঠানো, এবং কোনো কপি না রেখে। send_social_dm ব্যক্তিকে উত্তর দেয়, recipient_id হিসেবে ইভেন্টের sender.id ব্যবহার করে, 24 ঘণ্টার উইন্ডোর ভেতরে।
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}সাধারণ ভুলগুলো
- Story-র মিডিয়া সংরক্ষণ। Meta-র story mention গাইড CDN URL রাখার অনুমতি দেয়, কনটেন্ট নয়; কনটেন্ট আপনার সার্ভারে সংরক্ষণ বা ক্যাশ করা যাবে না।
- শুধু message.text পড়া। Story-মেনশনে story_mention টাইপের অ্যাটাচমেন্ট থাকে, এবং Meta-র নমুনায় টেক্সট থাকে না, তাই শুধু টেক্সট পড়া হ্যান্ডলার একটি খালি মেসেজ দেখে।
- কয়েক দিন পরে Story URL রেন্ডার করা। Story 24 ঘণ্টা পর মেয়াদ শেষ হলে বা মুছে গেলে URL কাজ করা বন্ধ করে, তাই তখন থেকে প্লেসহোল্ডার দেখান।
- Story-মেনশন খোঁজা comments ফিল্ডে বা mentions API-তে। Meta এগুলো messages-এ DM হিসেবে পাঠায়।
সেগুলো অ্যাকাউন্টের সিক্রেট দিয়ে সাইন করা, এবং কোনো কপি রাখা হয় না। send_social_dm 24 ঘণ্টার উইন্ডোর ভেতরে ব্যক্তিকে উত্তর দেয়, Claude, ChatGPT বা আপনার নিজের কোড থেকে। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, যত সংযোগ যোগ করবেন তত কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Instagram Story-র মেনশন ইভেন্টে কি টেক্সট থাকে?
Meta-র নমুনায় থাকে না। Story-মেনশনে story_mention টাইপের একটি অ্যাটাচমেন্ট থাকে, যাতে Story-র CDN URL থাকে, তাই শুধু message.text পড়া হ্যান্ডলার একটি খালি মেসেজ দেখে।
Instagram Story রিপ্লাইয়ে link_sticker_url কী?
এটি reply_to.story.link_sticker_url-এ থাকা URL, যে Story-তে ব্যক্তি উত্তর দিয়েছে তার লিংক স্টিকারের। Meta এটি ডিসেম্বর 2025-এ যোগ করেছে এবং লিংক অনুযায়ী অটোমেশন রাউট করতে এটি ব্যবহারের পরামর্শ দেয়।
Story-র GIF বা স্টিকার রিপ্লাই কি ওয়েবহুক ট্রিগার করে?
না। Meta-র Instagram Messaging গাইড বলে, GIF বা স্টিকার দিয়ে করা Story রিপ্লাই ওয়েবহুক সমর্থন করে না।
প্রাইভেট অ্যাকাউন্ট কি Story-মেনশন ওয়েবহুক ট্রিগার করে?
শুধু যখন প্রাইভেট অ্যাকাউন্ট প্রফেশনাল অ্যাকাউন্ট ফলো করে। পাবলিক অ্যাকাউন্টের মেনশন ঘটামাত্র পৌঁছায়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে