Messenger profile API: অভিবাদন, Get Started বোতাম, আইস ব্রেকার ও স্থায়ী মেনু
একটি Facebook Page-এর Messenger profile সেট করা হয় /{page-id}/messenger_profile-এর মাধ্যমে, একটি Page অ্যাক্সেস টোকেন ও pages_messaging অনুমতি সহ: POST দিয়ে get_started, greeting, ice_breakers, persistent_menu ও commands-এর মতো প্রপার্টি লেখা হয়, GET দিয়ে fields ব্যবহার করে সেগুলো পড়া হয়, আর DELETE দিয়ে fields অ্যারেতে নাম দেওয়া প্রপার্টিগুলো মুছে ফেলা হয়। Meta প্রতি Page-এ প্রতি 10 মিনিটে 10টি কল অনুমোদন করে, এবং শুধু পাঠানো প্রপার্টিগুলোই ওভাররাইট হয়।
easyCoexistence 24 ঘণ্টার উইন্ডোর ভেতরে send_social_dm দিয়ে একটি Page-এর Messenger কথোপকথনে উত্তর দেয়, Claude, ChatGPT বা আপনার নিজের কোড থেকে; নতুন মেসেজ আসামাত্র আপনার এন্ডপয়েন্টে ফরওয়ার্ড হয়।
প্রতি 10 মিনিটের ব্যবধানে প্রতি Page-এ অনুমোদিত Messenger Profile API কলের সংখ্যা।
API সর্বোচ্চ কতগুলো আইস ব্রেকার সেট করতে পারে; দুটো সেট থাকলে API-এর আইস ব্রেকার Get Started বোতামের চেয়ে অগ্রাধিকার পায়।
স্থায়ী মেনুতে শীর্ষস্তরের সর্বোচ্চ আইটেম সংখ্যা; প্রতিটি আইটেমের শিরোনাম সর্বোচ্চ 30 অক্ষরে সীমিত।
Page-স্তরের স্থায়ী মেনু আপডেট হতে কতটা সময় লাগতে পারে; একজন ব্যক্তির জন্য সেট করা মেনু রিয়েল টাইমে আপডেট হয়।
অভিবাদনের টেক্সট, যা Meta-র অভিবাদন রেফারেন্স অনুযায়ী Messenger-এর Android ও iOS-এ আর কাজ করে না।
Messenger profile-এ কী থাকে?
এমন সেটিংস যেখান থেকে কোনো Page-এর Messenger অভিজ্ঞতা শুরু হয়। Meta-র Messenger Profile API এই প্রপার্টিগুলোর তালিকা দেয়, প্রতিটি একই এন্ডপয়েন্টে সেট ও পড়া যায়; Development Mode-এ থাকা অ্যাপের ক্ষেত্রে সেটিংসগুলো শুধু সেইসব মানুষ দেখতে পায় যাদের অ্যাপে রোল আছে:
প্রপার্টি কীভাবে পড়া, সেট ও মুছে ফেলা হয়?
একই এন্ডপয়েন্টের তিনটি মেথড দিয়ে, Page-এর টোকেন দিয়ে কল করে। POST একটি JSON বডি নেয় যেখানে প্রপার্টি থাকে এবং শুধু যেগুলোর নাম দেওয়া হয়েছে সেগুলো ওভাররাইট করে, GET fields কমা-বিভক্ত তালিকা হিসেবে নেয়, আর DELETE একটি JSON বডি নেয় যার fields অ্যারেতে মুছে ফেলার জিনিসের নাম থাকে; POST ও DELETE উত্তর দেয় result success। এক কলে একটি Get Started বোতাম ও একটি মেনু সেট করার উদাহরণ:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Get Started বোতাম কীভাবে কাজ করে?
এটি ওয়েলকাম স্ক্রিনে থাকে, যেখানে Page-এর নাম, প্রোফাইল ছবি, কভার ছবি এবং ব্যবসাটির সাধারণত উত্তর দিতে কতক্ষণ লাগে তা দেখানো হয়। ট্যাপ করলে কথোপকথনে Get Started পাঠানো হয়, get_started.payload অ্যাপে messaging_postbacks ইভেন্ট হিসেবে যায় এবং স্ট্যান্ডার্ড মেসেজিং উইন্ডো খোলে। Meta উল্লেখ করেছে যে Messenger Facebook অ্যাপের ইন-অ্যাপ ব্রাউজারে চললে এই বোতাম সমর্থিত নয়, আর স্থায়ী মেনুর আগে এটি সেট করতে হয়।
অভিবাদনের টেক্সট কি এখনও কাজ করে?
ফোনে আর কাজ করে না। Meta-র রেফারেন্সের শিরোনাম এখন [Deprecated] Greeting Text: এই ফিচার Messenger-এর Android ও iOS-এ আর কাজ করে না, এবং API অভিবাদন প্রপার্টি গ্রহণ করলেও গ্রাহকরা তা দেখবেন না, তাই Meta ডেভেলপারদের এটি এড়িয়ে চলতে বলে। নথি অনুযায়ী greeting প্রতি লোকেলে একটি টেক্সট রাখে, default বাধ্যতামূলক, সর্বোচ্চ 160 অক্ষর, এবং {{user_first_name}}, {{user_last_name}} বা {{user_full_name}} দিয়ে ব্যক্তিগতকৃত করা যায়; এটি সেট করতে Page-এর Administrator রোল লাগে।
আইস ব্রেকার কীভাবে কাজ করে?
এগুলো সর্বোচ্চ 4টি প্রশ্নের তালিকা, যেগুলো মানুষ ট্যাপ করে কথোপকথন শুরু করতে পারে; প্রশ্নটি থ্রেডে এমনভাবে পাঠানো হয় যেন ব্যক্তিটিই জিজ্ঞেস করেছে, এবং এর পেলোড পোস্টব্যাক ইভেন্ট হয়ে ফেরত আসে। 2022 সালের এপ্রিল থেকে এগুলো লোকালাইজড: ice_breakers-এর প্রতিটি অবজেক্টে call_to_actions ও একটি locale থাকে, default লোকেল বাধ্যতামূলক, এবং ice_breakers-এ DELETE করলে সবগুলো মুছে যায়। Meta নতুন কথোপকথনের জন্য প্রতিযোগী উপাদানগুলোর ক্রম ঠিক করে:
- দুটোই সেট থাকলে API-এর আইস ব্রেকার Get Started বোতামের আগে অগ্রাধিকার পায়।
- দুটোই Page inbox-এ সেট করা কাস্টম প্রশ্নের আগে আসে, যার সম্পাদনা API-এর আইস ব্রেকার সেট থাকা অবস্থায় বন্ধ থাকে।
স্থায়ী মেনু কীভাবে তৈরি হয়?
মেনুর একটি অ্যারে হিসেবে, প্রতি লোকেলে একটি করে, default বাধ্যতামূলক; প্রতিটিতে সর্বোচ্চ 20টি call_to_actions থাকে যার ধরন web_url বা postback। শিরোনাম সর্বোচ্চ 30 অক্ষর এবং পোস্টব্যাক পেলোড সর্বোচ্চ 1,000 অক্ষর পর্যন্ত হতে পারে, আর composer_input_disabled true করলে মেনু, বোতাম ও ওয়েবভিউই শুধু মিথস্ক্রিয়ার উপায় থাকে। দেখা যাওয়ার আগে Meta-র শর্তাবলী:
- আগে থেকে সেট করা একটি Get Started বোতাম এবং
pages_messagingঅনুমতি। - একটি প্রকাশিত Page, এবং অ্যাপটি পাবলিক সেট করা।
- যিনি সেট করবেন তার Page-এ Administrator রোল।
- Messenger v106 বা তার পরের সংস্করণ iOS বা Android-এ, Facebook অ্যাপের ইন-অ্যাপ ব্রাউজারের বাইরে।
- Page-স্তরের পরিবর্তন 24 ঘণ্টা পর্যন্ত লাগতে পারে; একজন ব্যক্তির জন্য মেনু, যা PSID সহ
custom_user_settingsদিয়ে সেট করা হয়, রিয়েল টাইমে আপডেট হয়।
কমান্ড কী?
কীওয়ার্ড যা মানুষ যেকোনো সময় কম্পোজারের পাশের কমান্ড মেনু থেকে, স্ল্যাশ বা অ্যাট চিহ্ন টাইপ করে, বা মিল আছে এমন শব্দ টাইপ করলে পপওভার থেকে চালাতে পারে। প্রতি লোকেলে 1 থেকে 100টি কমান্ড থাকে, নাম 1 থেকে 32 অক্ষরের এবং শুরুতে স্ল্যাশ ছাড়া, বর্ণনা 1 থেকে 64 অক্ষরের; কমান্ড সেট থাকলে এগুলো স্থায়ী মেনুর আগে অগ্রাধিকার পায়। চালানো কমান্ড message.commands-এর ভেতরে messages ইভেন্টের মাধ্যমে অ্যাপে পৌঁছায়।
whitelisted_domains ও account_linking_url কী করে?
দুটোই কথোপকথনের বাইরের অভিজ্ঞতার জন্য। whitelisted_domains সর্বোচ্চ 50টি ডোমেইনের তালিকা দেয় যা Messenger ওয়েবভিউ Messenger Extensions SDK ও চেকবক্স প্লাগইনের জন্য খুলতে পারে; প্রতিটি সম্পূর্ণ যোগ্য ডোমেইন নামের অধীনে HTTPS-এ পরিবেশিত হতে হয়, কখনো IP ঠিকানা বা localhost নয়, এবং এটি সেট করতে Page-এর Administrator রোল লাগে। account_linking_url হলো HTTPS কলব্যাক, যা কোনো ব্যক্তির Messenger অ্যাকাউন্টকে ব্যবসার সঙ্গে তার নিজের অ্যাকাউন্টের সঙ্গে যুক্ত করে।
easyCoexistence কীভাবে Page-এর Messenger profile সেট করে?
না: কোনো টুল {page-id}/messenger_profile কল করে না, এবং Page টোকেন হস্তান্তর করা হয় না, তাই প্রোফাইল সেট করা এই সংযোগের বাইরে। মানুষ যেসব কমান্ড চালায় সেগুলো messages ইভেন্টে পৌঁছায়, যা easyCoexistence ফরওয়ার্ড করে এবং অটোমেশন পড়ে; Meta যেসব ট্যাপকে messaging_postbacks ইভেন্ট হিসেবে জানায়, অর্থাৎ Get Started, পোস্টব্যাক মেনু আইটেম ও আইস ব্রেকার থেকে আসা ট্যাপ, সেগুলো ফরওয়ার্ড হয় না, কারণ Page-গুলো feed, messages ও mention-এ সাবস্ক্রাইব করা আছে।
সাধারণ ভুলগুলো
- Get Started-এর আগে স্থায়ী মেনু সেট করা। Meta-র শর্তে একটি Get Started বোতাম লাগে, তাই আগে get_started সেট করুন।
- ডিফল্ট লোকেল বাদ দেওয়া। আইস ব্রেকার, মেনু ও কমান্ডের প্রতিটির জন্য locale default সেট করা একটি অবজেক্ট লাগে, ফলব্যাক হিসেবে।
- লুপে profile API কল করা। Meta প্রতি Page-এ প্রতি 10 মিনিটে 10টি কল অনুমোদন করে, তাই একটি POST-এ একাধিক প্রপার্টি রাখুন।
- মেনু পরিবর্তন তাৎক্ষণিক আশা করা। Page-স্তরের মেনু আপডেট মানুষের কাছে পৌঁছাতে 24 ঘণ্টা পর্যন্ত লাগতে পারে।
Messenger profile সেট করা এর টুলের মধ্যে নেই। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, সংযোগ বাড়ার সঙ্গে দাম কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
স্থায়ী মেনু কি প্রতিজনের জন্য আলাদা হতে পারে?
হ্যাঁ। ব্যক্তির PSID-সহ custom_user_settings সেই ব্যক্তির জন্য Page-এর মেনু ওভাররাইট করে, রিয়েল টাইমে আপডেট হয় এবং প্রতি 10 মিনিটে প্রতি ব্যক্তির জন্য 10টি কল অনুমোদন করে।
Messenger profile কোন লোকেল সমর্থন করে?
Meta-র সমর্থিত লোকেলের তালিকায় থাকা লোকেলগুলো, যেমন en_GB, pt_BR বা ja_JP, এবং default, যা তখন ফলব্যাক হিসেবে ব্যবহৃত হয় যখন কোনো লোকেল ব্যক্তির সঙ্গে মেলে না।
কে কোনো Page-এর Messenger profile বদলাতে পারে?
pages_messaging সহ Page টোকেনধারী একটি অ্যাপ। স্থায়ী মেনু, অভিবাদন ও ডোমেইন তালিকার জন্য Page-এর Administrator রোলও লাগে।
একটি Facebook Page-এর জন্য easyCoexistence-এর দাম কত?
প্রতিটি Page একটি সংযোগ: প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, সংযোগের সংখ্যা বাড়ার সঙ্গে দাম কমে, এবং প্রথম 3 দিন ফ্রি।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে