Instagram messaging_postbacks ওয়েবহুক: আইস ব্রেকার ও বাটন
Instagram-এর messaging_postbacks ওয়েবহুক ফিল্ড অ্যাপকে জানায় যখন কোনো ব্যক্তি প্রফেশনাল অ্যাকাউন্টের কথোপকথনে আইস ব্রেকার প্রশ্ন, টেমপ্লেটের পোস্টব্যাক বাটন বা স্থায়ী মেনুর আইটেমে ট্যাপ করে। ইভেন্টের postback অবজেক্টে থাকে title, অর্থাৎ ব্যক্তির ট্যাপ করা লেখা; পেলোড, অর্থাৎ অ্যাপ সেই অপশনের জন্য যে স্ট্রিং সেট করেছে; এবং mid, অর্থাৎ মেসেজ আইডি, Graph API v11.0 থেকে।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে comments, messages ও mentions-এ সাবস্ক্রাইব করে এবং সেই ইভেন্টগুলো, কুইক রিপ্লাই ট্যাপসহ, আসার সঙ্গে সঙ্গে আপনার HTTPS এন্ডপয়েন্টে পাঠায়; সেগুলো সেই অ্যাকাউন্টের সিক্রেট দিয়ে স্বাক্ষরিত থাকে এবং কোনো কপি রাখা হয় না।
একটি অ্যাকাউন্ট Meta-র Ice Breaker API দিয়ে সর্বোচ্চ যে সংখ্যক আইস ব্রেকার প্রশ্ন সেট করতে পারে।
যে Graph API সংস্করণ থেকে postback ইভেন্টে mid অন্তর্ভুক্ত থাকে; ফিল্ডটির জন্য v8.0 বা তার পরের সংস্করণ দরকার।
বাটন টেমপ্লেট মেসেজে সর্বোচ্চ 3টি বাটন থাকতে পারে, প্রতিটি postback বা web_url বাটন।
স্থায়ী মেনুর আইটেমে ব্যক্তির ট্যাপের পর উত্তর দেওয়ার সময়, যা স্ট্যান্ডার্ড মেসেজিং উইন্ডো খোলে।
একটি মেসেজ সর্বোচ্চ যতগুলো কুইক রিপ্লাই দিতে পারে; ট্যাপ করা কুইক রিপ্লাই messaging_postbacks-এ নয়, messages-এ আসে।
messaging_postbacks কখন ট্রিগার হয়?
কোনো ব্যক্তি কথোপকথনে অ্যাকাউন্টের কাঠামোবদ্ধ কোনো অপশনে ট্যাপ করলে, অ্যাপ ও অ্যাকাউন্ট এই ফিল্ডে সাবস্ক্রাইব থাকলে। Meta-র গাইড এই উৎসগুলো তালিকাভুক্ত করেছে:
- একটি আইস ব্রেকার প্রশ্ন, যা কথোপকথন শুরুতে অ্যাকাউন্ট সর্বোচ্চ 4টি দিতে পারে। ডেস্কটপে এটি পাওয়া যায় না।
- একটি বাটন টেমপ্লেটের postback বাটন, একটি মেসেজে সর্বোচ্চ 3টি, অথবা একটি জেনেরিক টেমপ্লেটে প্রতিটি এলিমেন্টে সর্বোচ্চ 3টি।
- অ্যাকাউন্টের স্থায়ী মেনুর একটি postback আইটেম।
- একটি ig.me লিংকের ref প্যারামিটার দিয়ে খোলা নতুন থ্রেডে ট্যাপ করা আইস ব্রেকার: তখন postback-এ referral-ও থাকে।
- একটি নিজেকে মেসেজ পাঠানোর টেস্ট, যেখানে অ্যাকাউন্ট নিজের বাটনে ট্যাপ করে: ইভেন্টে
is_selftrue হিসেবে যোগ হয়।
postback নোটিফিকেশন কেমন দেখায়?
যেখানে একটি DM-এর মেসেজ থাকত, সেখানে postback অবজেক্ট নিয়ে একটি মেসেজিং ইভেন্ট থাকে। Instagram Login-এর জন্য Meta-র উদাহরণে mid, title ও পেলোড থাকে, আর তাদের আইস ব্রেকার গাইডে একই অবজেক্ট mid ছাড়া দেখানো হয়েছে। একটি নোটিফিকেশন এরকম দেখায়:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"postback": {
"mid": "<MESSAGE_ID>",
"title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
"payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
}
}
]
}
]
}প্রতিটি ফিল্ডের মানে কী?
বাইরে থেকে ভেতরের দিকে, Meta যে ফিল্ডগুলো postback-এর জন্য নথিভুক্ত করেছে:
- sender.id: যে ব্যক্তি ট্যাপ করেছে তার Instagram-scoped আইডি, যার কাছে উত্তর পাঠাতে হবে। recipient.id ও entry[].id: প্রফেশনাল অ্যাকাউন্ট।
- timestamp: ব্যক্তি কখন ট্যাপ করেছে, Meta-র আইস ব্রেকার গাইড অনুযায়ী।
- postback.title: আইস ব্রেকার প্রশ্ন বা বাটনের সেই টাইটেল, যা ব্যক্তি দেখেছিল।
- postback.payload: অপশনটি তৈরির সময় অ্যাপের বেছে নেওয়া স্ট্রিং।
- postback.mid: যে মেসেজ ট্যাপটি অ্যাকাউন্টে পাঠিয়েছে তার আইডি, Graph API v11.0 থেকে।
- postback.referral: ref, source ও type, যখন থ্রেডটি ref প্যারামিটারসহ ig.me লিংক থেকে খোলা হয়েছে।
is_self: postback-এর পাশে true সেট, যখন নিজেকে মেসেজ পাঠানোর টেস্টে অ্যাকাউন্ট নিজের বাটনে ট্যাপ করে।
আইস ব্রেকার কীভাবে সেট করা হয়?
graph.instagram.com-এ POST /<IG_ID>/messenger_profile দিয়ে, যেখানে platform হয় instagram এবং একটি ice_breakers অ্যারে থাকে। তার call_to_actions-এ সর্বোচ্চ 4টি প্রশ্ন ও পেলোড জোড়া থাকে, এবং অনুবাদিত প্রতিটি সেটের জন্য একটি locale। GET /me/messenger_profile?fields=ice_breakers দিয়ে সেগুলো দেখা যায়, আর fields-এ ice_breakers দিয়ে DELETE করলে সেগুলো মুছে যায়। এখানে বেছে নেওয়া পেলোডই সেই মান, যা প্রশ্নে ট্যাপ করলে messaging_postbacks ফেরত দেয়।
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"platform": "instagram",
"ice_breakers": [
{
"call_to_actions": [
{ "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
{ "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
]
}
]
}postback বাটন কীভাবে পাঠানো হয়?
অ্যাকাউন্ট POST /<IG_ID>/messages দিয়ে যে মেসেজ পাঠায়, তার ভেতরে। একটি বাটন টেমপ্লেটে 640 অক্ষর পর্যন্ত text থাকতে পারে এবং 1 থেকে 3টি বাটন; একটি জেনেরিক টেমপ্লেটে সর্বোচ্চ 10টি এলিমেন্ট, প্রতিটিতে সর্বোচ্চ 3টি বাটন। postback টাইপের বাটনে ট্যাপ করলে তার পেলোড messaging_postbacks-এ ফেরত আসে, আর web_url বাটন বরং ইন-অ্যাপ ব্রাউজারে একটি পেজ খোলে। স্থায়ী মেনু, যা messenger_profile-এ সেট হয়, একই দুই ধরনের বাটন নেয়।
কুইক রিপ্লাই কি messaging_postbacks ব্যবহার করে?
না: সেগুলো আসে messages-এ। ট্যাপ করা একটি কুইক রিপ্লাই তার টাইটেলটি মেসেজ হিসেবে কথোপকথনে পোস্ট করে, এবং messages ইভেন্টে text সেই টাইটেল হয় এবং quick_reply.payload হয় অপশনের পেলোড। একটি মেসেজে সর্বোচ্চ 13টি কুইক রিপ্লাই থাকতে পারে, প্রতিটি সর্বোচ্চ 20 অক্ষরের, শুধু প্লেইন টেক্সট। Meta-র Instagram Messaging গাইড আইস ব্রেকার ও জেনেরিক টেমপ্লেটের নির্বাচনকেও messages যা রিপোর্ট করে তার মধ্যে তালিকাভুক্ত করেছে, তবে কোনো নমুনা পেলোড ছাড়া।
একটি ট্যাপ কি মেসেজিং উইন্ডো খোলে?
স্থায়ী মেনুর ক্ষেত্রে Meta তা বলেছে: মেনুর আইটেমে ট্যাপ স্ট্যান্ডার্ড মেসেজিং উইন্ডো খোলে, এবং অ্যাকাউন্টের উত্তর দেওয়ার জন্য থাকে 24 ঘণ্টা। recipient.id-তে postback-এর sender.id সেট করে POST /<IG_ID>/messages দিয়ে উত্তর দিন। অ্যাকাউন্টের উত্তর messages-এ echo হিসেবে ফিরে আসে, যেখানে is_echo true সেট থাকে।
easyCoexistence কি postback ফরওয়ার্ড করে?
শুধু কুইক রিপ্লাই ট্যাপ। এগুলো messages-এ আসে, যেখানে easyCoexistence-এর অ্যাপ ও প্রতিটি সংযুক্ত অ্যাকাউন্ট সাবস্ক্রাইব করা, তাই quick_reply.payload সহ আপনার এন্ডপয়েন্টে পৌঁছায়। আইস ব্রেকার, বাটন ও মেনু ট্যাপ আসে messaging_postbacks-এ, যেখানে easyCoexistence সাবস্ক্রাইব করে না, তাই সেগুলো ফরওয়ার্ড হয় না।
সাধারণ ভুলগুলো
- কুইক রিপ্লাইয়ের জন্য messaging_postbacks-এর অপেক্ষা করা। কুইক রিপ্লাই আসে messages-এ, ট্যাপ করা অপশনের লেখার পাশে quick_reply.payload থাকে।
- postback.title-এর ওপর রাউট করা। title হলো ব্যক্তি যা দেখেছে, এবং লোকেল অনুযায়ী আলাদা হতে পারে; রাউট করুন পেলোডের ওপর, যা অ্যাপ সেট করে।
- পুরোনো API সংস্করণে mid আশা করা। Meta postback.mid দেয় শুধু Graph API v11.0 থেকে।
- 4টির বেশি আইস ব্রেকার সেট করা, অথবা ডেস্কটপে সেগুলো টেস্ট করা। Meta-র Ice Breaker API সর্বোচ্চ 4টি প্রশ্ন নেয়, এবং ফিচারটি ডেস্কটপে পাওয়া যায় না।
send_social_dm 24 ঘণ্টার উইন্ডোর মধ্যে ব্যক্তিকে উত্তর দেয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, সংযোগ বাড়ানোর সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন ওয়েবহুক ফিল্ড Instagram-এর আইস ব্রেকার ট্যাপ রিপোর্ট করে?
messaging_postbacks। postback অবজেক্টে প্রশ্নটি থাকে title হিসেবে, আর তার জন্য সেট করা পেলোড, সঙ্গে Graph API v11.0 থেকে mid।
একটি Instagram অ্যাকাউন্টে কতগুলো আইস ব্রেকার থাকতে পারে?
সর্বোচ্চ 4টি প্রশ্ন, POST /<IG_ID>/messenger_profile দিয়ে সেট করা, এবং platform হবে instagram; ইচ্ছা হলে প্রতি লোকেল অনুযায়ী।
Instagram postback-এর উত্তর কীভাবে দেব?
POST /<IG_ID>/messages দিয়ে, recipient.id-তে postback-এর sender.id সেট করে; sender.id হলো যে ব্যক্তি ট্যাপ করেছে তার Instagram-scoped আইডি। স্থায়ী মেনু ট্যাপের পর Meta অ্যাকাউন্টকে উত্তর দেওয়ার জন্য 24 ঘণ্টা দেয়।
Instagram postback-এ title নাকি পেলোড দেখে রাউট করব?
পেলোডের ওপর, যা অ্যাপ অপশনের জন্য সেট করে। title হলো ব্যক্তি যা দেখেছে, যা লোকেল অনুযায়ী আলাদা হতে পারে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে