Instagram message_reactions ওয়েবহুক: react ও unreact পেলোড
Instagram-এর message_reactions ওয়েবহুক ফিল্ড অ্যাপকে জানায় যখন কোনো ব্যক্তি প্রফেশনাল অ্যাকাউন্টের সঙ্গে তাঁর কথোপকথনের কোনো মেসেজে রিঅ্যাকশন দেন, বা সেই রিঅ্যাকশন সরিয়ে দেন। ইভেন্টটি messaging অ্যারেতে একটি reaction অবজেক্টসহ থাকে: mid, যে মেসেজে রিঅ্যাকশন দেওয়া হয়েছে তার ID; action, react বা unreact; এবং শুধু react-এর ক্ষেত্রে reaction, যেমন love, এবং emoji, ইমোজিটি নিজে।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে comments, messages ও mentions-এ সাবস্ক্রাইব করে এবং ইভেন্টগুলো আসার সঙ্গে সঙ্গেই সেগুলো আপনার HTTPS এন্ডপয়েন্ট-এ পাঠায়, সেই অ্যাকাউন্টের secret দিয়ে স্বাক্ষরিত, প্রতিটি মেসেজের mid-সহ।
reaction.action-এর দুটি মান: একটি রিঅ্যাকশন যোগ হয়েছে, অথবা একটি রিঅ্যাকশন সরানো হয়েছে।
যে Graph API সংস্করণ থেকে Meta এই ওয়েবহুকে angry, sad, wow, love, like, laugh ও অন্যান্য রিঅ্যাকশন সমর্থন করে।
অ্যাকাউন্ট নিজে কারো মেসেজে react বা unreact করলে Meta কোনো বিজ্ঞপ্তি পাঠায় না।
message_reactions সেই ফিল্ডগুলোর একটি, যেগুলোতে App Dashboard-এর নতুন Instagram প্রোডাক্ট ডিফল্টভাবে সাবস্ক্রাইব থাকে।
Send API কল প্রতি সেকেন্ডে প্রতি অ্যাকাউন্টে, টেক্সট, লিংক, রিঅ্যাকশন ও স্টিকারের জন্য।
message_reactions কখন ট্রিগার হয়?
যখন কোনো ব্যক্তি প্রফেশনাল অ্যাকাউন্টের সঙ্গে তাঁর কথোপকথনের কোনো মেসেজে রিঅ্যাকশন দেন, এবং পরে সেই রিঅ্যাকশন সরিয়ে দেন, অ্যাপ ও অ্যাকাউন্ট ফিল্ডটিতে সাবস্ক্রাইব থাকলে। Meta-র Instagram Messaging গাইড বিপরীত দিকটি স্পষ্ট করে: অ্যাকাউন্ট নিজে react বা unreact করলে কোনো বিজ্ঞপ্তি পাঠানো হয় না, এবং messages-ও তার জন্য কোনো echo দেয় না।
একটি রিঅ্যাকশন বিজ্ঞপ্তি দেখতে কেমন?
একটি POST, যার object হলো instagram এবং entry-তে একটি messaging অ্যারে থাকে। DM-এর মতো নয়, এই ইভেন্টে কোনো message অবজেক্ট থাকে না: রিঅ্যাকশনটি sender, recipient ও timestamp-এর পাশে নিজের reaction অবজেক্টে থাকে। Instagram Login-এর জন্য Meta-র উদাহরণ:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}প্রতিটি ফিল্ডের মানে কী?
বাইরে থেকে ভেতরের দিকে, Meta একটি রিঅ্যাকশন ইভেন্টের যে ফিল্ডগুলো নথিভুক্ত করেছে:
- entry[].id এবং recipient.id: প্রফেশনাল অ্যাকাউন্ট। sender.id: যিনি রিঅ্যাকশন দিয়েছেন তাঁর Instagram-scoped ID।
- timestamp: ইভেন্টটি কখন ট্রিগার হয়েছিল, Meta-র নমুনায় মিলিসেকেন্ডে; entry[].time হলো Meta কখন বিজ্ঞপ্তিটি পাঠিয়েছে।
- reaction.mid: যে মেসেজে রিঅ্যাকশন দেওয়া হয়েছে তার ID, যা সেই মেসেজের messages ইভেন্টে যে mid ছিল, সেই একই।
- reaction.action: রিঅ্যাকশন যোগ হলে react, সরিয়ে দিলে unreact।
- reaction.reaction: রিঅ্যাকশনের নাম, যেমন love; Meta তালিকায় দেয় angry, sad, wow, love, like, laugh এবং other।
- reaction.emoji: ইমোজিটি Unicode স্ট্রিং হিসেবে, যেমন love-এর জন্য \u{2764}\u{FE0F}।
- unreact-এ reaction ও emoji বাদ দেওয়া হয়।
একটি unreact দেখতে কেমন?
একই ইভেন্ট, action হলো unreact এবং সেখানে reaction বা emoji কোনোটিই থাকে না, কারণ নামকরণের মতো কিছু অবশিষ্ট থাকে না। reaction.mid ও sender.id দিয়ে এটিকে যে রিঅ্যাকশনটি সরিয়ে দিল তার সঙ্গে মেলান, এবং আপনার রেকর্ড থেকে সেই ব্যক্তির রিঅ্যাকশনটি সেই মেসেজ থেকে বাদ দিন।
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}mid কোন মেসেজের দিকে ইঙ্গিত করে?
যে মেসেজে ব্যক্তিটি রিঅ্যাকশন দিয়েছেন, সেটির দিকে, যে mid সেটি তার messages ইভেন্টে বহন করেছিল, অ্যাকাউন্টের নিজের মেসেজের echo-সহ। যে হ্যান্ডলার mid সংরক্ষণ করে, সে রিঅ্যাকশনটিকে কথোপকথনের সঠিক লাইনের সঙ্গে সংযুক্ত করতে পারে। Meta একটি ফাঁক উল্লেখ করেছে: কোনো carousel পোস্টের একটি ছবিতে রিঅ্যাকশন দিলে সেটি carousel-এর প্রথম ছবি হিসেবে রিপোর্ট হয়, যা হয়তো সেই ছবিটি নয় যেটি বেছে নেওয়া হয়েছিল।
একটি অ্যাকাউন্ট কীভাবে কোনো মেসেজে রিঅ্যাকশন দেয়?
POST /<IG_ID>/messages দিয়ে: recipient.id সেট করা হয় ব্যক্তির Instagram-scoped ID-তে, sender_action সেট হয় react-এ, এবং একটি পেলোড থাকে যাতে message_id ও reaction থাকে, একটি emoji বা তার UTF-8 রূপ। অন্য ইমোজি দিয়ে কলটি পুনরাবৃত্তি করলে রিঅ্যাকশন বদলে যায়, আর শুধু message_id-সহ sender_action সেট হয় unreact-এ, এতে রিঅ্যাকশনটি সরে যায়। কোনো কলই ওয়েবহুক তৈরি করে না।
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}message_reactions-এর কী দরকার?
Instagram Login-এর সঙ্গে instagram_business_basic ও instagram_business_manage_messages, এবং যে অ্যাকাউন্টের মালিক বা পরিচালক ডেভেলপার নন তার জন্য Advanced Access। App Dashboard-এ নতুন একটি Instagram প্রোডাক্ট ডিফল্টভাবে message_reactions-এ সাবস্ক্রাইব থাকে, এবং প্রতিটি অ্যাকাউন্ট POST /<IG_ID>/subscribed_apps দিয়ে সাবস্ক্রাইব হয়। Meta-র Send Messages গাইড এটিকে messaging_reactions বলে তালিকাভুক্ত করেছে, কিন্তু তার fields টেবিল, ড্যাশবোর্ড ডিফল্ট ও ওয়েবহুক রেফারেন্স বলে message_reactions।
easyCoexistence কি রিঅ্যাকশন ফরোয়ার্ড করে?
না। easyCoexistence-এর অ্যাপ ও প্রতিটি সংযুক্ত অ্যাকাউন্ট শুধু comments, messages ও mentions-এ সাবস্ক্রাইব করা, তাই message_reactions ইভেন্ট আপনার এন্ডপয়েন্টে ফরওয়ার্ড হয় না। যে DM ও echo-গুলোর mid দিয়ে রিঅ্যাকশন নির্দেশ করা হয়, সেগুলো অ্যাকাউন্টের সিক্রেট দিয়ে স্বাক্ষরিত হয়ে আপনার এন্ডপয়েন্টে পৌঁছায়।
সাধারণ ভুলগুলো
- message-এর ভেতরে রিঅ্যাকশন খোঁজা। রিঅ্যাকশন ইভেন্টে কোনো message অবজেক্ট থাকে না; sender ও recipient-এর পাশের reaction অবজেক্টটি পড়ুন।
- action না দেখে reaction বা emoji পড়া। unreact-এ দুটোই বাদ যায়, তাই যে কোড ধরে নেয় সেগুলো থাকবেই, রিঅ্যাকশন সরানো হলে তা ভেঙে পড়ে।
- অ্যাকাউন্ট রিঅ্যাকশন দেওয়ার পর ওয়েবহুকের জন্য অপেক্ষা করা। অ্যাকাউন্টের নিজের রিঅ্যাকশনের জন্য Meta কোনো ওয়েবহুক পাঠায় না, এমনকি echo-ও না, তাই আপনার অ্যাপ যখন সেগুলো পাঠায় তখন সেগুলো রেকর্ড করুন।
- Meta-র Send Messages গাইড থেকে messaging_reactions নামটি কপি করা। তার fields টেবিল, ড্যাশবোর্ড ডিফল্ট ও ওয়েবহুক রেফারেন্সে ফিল্ডটি হলো message_reactions।
আপনার এজেন্ট 24-ঘণ্টার উইন্ডোর মধ্যে send_social_dm দিয়ে কোনো ব্যক্তিকে উত্তর দেয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, আরও সংযোগ যোগ করলে কমে যায়, প্রথম 3 দিন বিনামূল্যে।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কেন carousel পোস্টের রিঅ্যাকশন প্রথম ছবির দিকে ইঙ্গিত করে?
কেউ carousel-এর কোনো ছবিতে রিঅ্যাকশন দিলে Meta carousel-এর প্রথম ছবিটি রিপোর্ট করে, যা হয়তো ব্যক্তিটির বেছে নেওয়া ছবি নাও হতে পারে।
ব্যবসা রিঅ্যাকশন দিলে কি Instagram একটি ওয়েবহুক পাঠায়?
না। অ্যাকাউন্ট কোনো মেসেজে react বা unreact করলে Meta কোনো message_reactions বিজ্ঞপ্তি বা echo পাঠায় না।
Instagram ওয়েবহুক কোন রিঅ্যাকশনগুলো রিপোর্ট করতে পারে?
Meta-র Instagram Messaging গাইড Graph API v12.0 থেকে angry, sad, wow, love, like, laugh এবং other তালিকাভুক্ত করে, ইমোজি নিজে reaction.emoji-তে থাকে।
ওয়েবহুক ফিল্ডটি কি message_reactions নাকি messaging_reactions?
message_reactions। Meta-র Send Messages গাইড লেখে messaging_reactions, কিন্তু তার fields টেবিল, App Dashboard ডিফল্ট ও ওয়েবহুক রেফারেন্স সবই message_reactions ব্যবহার করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে