API দিয়ে Messenger কথোপকথনের ইতিহাস পড়া
Facebook Page-এর Messenger ইতিহাস পড়া হয় GET /{page-id}/conversations?platform=messenger দিয়ে, যা শেষ আপডেটের সময়সহ কথোপকথনের আইডির তালিকা দেয়। এরপর GET /{conversation-id}?fields=messages দিয়ে মেসেজের আইডি এবং GET /{message-id} দিয়ে প্রতিটি মেসেজের প্রেরক, প্রাপক, টেক্সট ও অ্যাটাচমেন্ট নেওয়া হয়। Meta একটি কথোপকথনের সর্বশেষ 20টি মেসেজের বিস্তারিত দেয়, এবং এই কলগুলোর জন্য pages_messaging সহ একটি Page টোকেন লাগে।
easyCoexistence একটি Page-এর নতুন Messenger মেসেজ আসামাত্র আপনার এন্ডপয়েন্টে ফরওয়ার্ড করে, আর send_social_dm 24 ঘণ্টার উইন্ডোর ভেতরে উত্তর পাঠায়, Claude, ChatGPT বা আপনার নিজের কোড থেকে।
শুধু কথোপকথনের সর্বশেষ 20টি মেসেজের বিস্তারিত পাওয়া যায়; পুরনোগুলোর জন্য মেসেজটি মুছে ফেলা হয়েছে বলে ত্রুটি ফেরত আসে।
প্রতি Facebook Page-এর জন্য একটি অ্যাপ যতগুলো Conversations API কল করতে পারে।
Requests ফোল্ডারের যেসব কথোপকথন এতদিন সক্রিয় ছিল না, সেগুলো API ফলাফলে বাদ যায়।
টোকেনের পেছনের ব্যক্তিকে কথোপকথন পড়তে যে Page টাস্ক করতে সক্ষম হতে হবে।
Facebook Page অ্যাকাউন্টে Messenger API কল বেশি হয়ে গেলে ত্রুটি আসে; Meta কিছুক্ষণ অপেক্ষা করে আবার চেষ্টা করতে বলে।
একটি Page-এর কথোপকথন কীভাবে তালিকা করবেন?
GET /{page-id}/conversations-এ platform-কে messenger সেট করে। ফলাফলে data অ্যারে থাকে, যেখানে প্রতিটি কথোপকথনের আইডি থাকে, সঙ্গে updated_time, অর্থাৎ সর্বশেষ মেসেজ যোগ হওয়ার সময়, এবং একটি paging অবজেক্ট থাকে। Meta-র রেফারেন্স বলে এই এন্ডপয়েন্টে সময়-ভিত্তিক পেজিনেশন নেই, তাই তালিকায় এগোতে paging অবজেক্ট অনুসরণ করুন।
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}একজন ব্যক্তির কথোপকথন কীভাবে খুঁজবেন?
একই রিকোয়েস্টে user_id যোগ করুন, যার মান ব্যক্তির Page-scoped ID। Meta Page ও সেই ব্যক্তির মধ্যকার কথোপকথনের আইডি ফেরত দেয়। এটি messages ওয়েবহুক থেকে ইতিহাস পর্যন্ত পৌঁছানোর সবচেয়ে সংক্ষিপ্ত পথ, যেখানে PSID আসে sender.id হিসেবে:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }কথোপকথনের মেসেজগুলো কীভাবে পড়বেন?
দুই ধাপে। GET /{conversation-id} এবং fields=messages দিলে কথোপকথনের মেসেজ আইডিগুলো ফেরত আসে, প্রতিটির সঙ্গে created_time, সবচেয়ে নতুনটি আগে। এরপর GET /{message-id} দিয়ে প্রয়োজনীয় ফিল্ড চাইলে, যেমন id, created_time, from, to, message ও reply_to, একটি মেসেজের বিষয়বস্তু ফেরত আসে। ডিফল্ট ফিল্ড হলো id ও created_time, আর যে ফিল্ডে ডেটা নেই সেটি উত্তর থেকে বাদ যায়।
কোন ফিল্ডগুলো পড়া যায়?
কথোপকথন ও মেসেজে আলাদা ফিল্ড থাকে। Page মেসেজিংয়ের জন্য Meta-র রেফারেন্সে যেগুলো তালিকাভুক্ত, সেগুলো এখানে:
- কথোপকথন: id,
updated_time, participants (যার আইডি, নাম ও ইমেইল), messages, এবং Conversation Routing চালু হলেis_owner। - মেসেজ: id,
created_time, from ও to, যার প্রতিটিতে আইডি, নাম ও ইমেইল থাকে, এবং message, অর্থাৎ টেক্সট; না থাকলে খালি। - attachments: files, images ও videos, সঙ্গে তাদের CDN URL, এবং
is_unsupported, যা শুধু মেসেজে অসমর্থিত কনটেন্ট থাকলে ফেরত আসে। - reactions,
reply_toযার মাধ্যমে কোন mid-এর উত্তর দেওয়া হয়েছে তা জানায়,is_self_reply, এবং শেয়ার করা পোস্ট ও রিলসের জন্য shares। - tags: মেসেজের ফোল্ডার ও উৎস, যেমন inbox, read বা source:chat।
কতদূর পেছনে পড়া যায়?
আইডির ক্ষেত্রে কথোপকথনের শুরু পর্যন্ত, তবে বিষয়বস্তুর ক্ষেত্রে তা নয়। Meta-র গাইড বলে কথোপকথনের এন্ডপয়েন্ট একটি কথোপকথনের সব মেসেজ আইডি দেয়, কিন্তু বিস্তারিত আসে শুধু সর্বশেষ 20টি মেসেজের; পুরনো কোনোটি চাইলে মেসেজটি মুছে ফেলা হয়েছে বলে ত্রুটি আসে। Requests ফোল্ডারে 30 দিন সক্রিয় না থাকা কথোপকথন একেবারেই ফেরত আসে না।
কোন অনুমতি ও টাস্ক লাগে?
Page-এ MESSAGING বা MODERATE টাস্ক করতে পারেন এমন কারও থেকে একটি Page access টোকেন, সঙ্গে pages_manage_metadata, pages_read_engagement ও pages_messaging অনুমতি। যাদের অ্যাপ, Page বা ব্যবসায় কোনো ভূমিকা নেই, তাদের সঙ্গে কথোপকথন পড়তে Advanced Access লাগে, যা Meta App Review-এর মাধ্যমে দেয়।
কলের ওপর কী সীমা প্রযোজ্য?
Meta-র রেট লিমিট অনুযায়ী প্রতি Page-এ Conversations API-তে প্রতি সেকেন্ডে 2টি কল। সীমা ছাড়ালে 613 বা 80006 ত্রুটি কোড ফেরত আসে, যার বার্তা There have been too many messenger api calls to this Page account. এমন একটি Page, যা Meta-র উচ্চ-ভলিউমের সীমায় পৌঁছায়, যেমন সেকেন্ডে 40টির বেশি মেসেজ পাঠানো, ভলিউম না কমা পর্যন্ত তার কথোপকথনের তালিকা করতে পারে না, তবে একটি কথোপকথনের নতুন মেসেজ এখনও পড়া যায়।
ওয়েবহুকের বদলে কখন API ব্যবহার করবেন?
অতীতের জন্য। ওয়েবহুক নতুন মেসেজ আসার সঙ্গে সঙ্গে পাঠায়, এবং Meta বলে পুরনো নোটিফিকেশন পরে আর কোয়েরি করা যায় না। তাই Conversations API দিয়েই একটি ইন্টিগ্রেশন শোনা শুরুর আগের মেসেজ পড়ে, অথবা ডাউনটাইমের পর বাকিটা ধরে নেয়। Conversation Routing চালু থাকলে is_owner ফিল্ড তালিকাকে শুধু সেই কথোপকথনে সীমিত করে, যেগুলোর উত্তর দেওয়ার দায়িত্ব অ্যাপের; ডাউনটাইমের পর পুনরুদ্ধারের জন্য Meta এটিই সুপারিশ করে।
easyCoexistence কীভাবে Messenger ইতিহাস পড়ে?
এটি ইতিহাস পড়ে না। Page সংযুক্ত হয় pages_messaging, pages_manage_metadata ও pages_read_engagement অনুমতি নিয়ে, কিন্তু কোনো টুল Conversations API কল করে না, এবং Page টোকেন হস্তান্তর করা হয় না। নতুন মেসেজ আসার সঙ্গে সঙ্গে set_social_webhook_destination দিয়ে আপনার এন্ডপয়েন্টে পৌঁছায়, কোনো কপি না রেখে এগিয়ে দেওয়া হয়, যাতে আপনার নিজস্ব সিস্টেম তার প্রয়োজনীয় ইতিহাস রাখতে পারে।
সাধারণ ভুলগুলো
- তালিকা কলে মেসেজের বিষয়বস্তু আশা করা। কথোপকথনের এন্ডপয়েন্ট মেসেজ আইডি দেয়; প্রতিটি মেসেজের ফিল্ড /{message-id} থেকে পড়ুন।
- পুরো ইতিহাসের ওপর ভরসা করা। বিস্তারিত সর্বশেষ 20টি মেসেজেই থেমে যায়, তাই মেসেজ আসার সঙ্গে সঙ্গে ওয়েবহুক থেকে যা লাগবে তা সংরক্ষণ করুন।
- নতুন মেসেজের জন্য পোল করা। প্রতি Page-এ প্রতি সেকেন্ডে 2 কল হলে পোল লুপ শিগগিরই রেট লিমিটে পৌঁছায়, অথচ messages ওয়েবহুক মেসেজগুলো আসার সঙ্গে সঙ্গেই পাঠায়।
- since ও until দিয়ে তারিখ অনুযায়ী কথোপকথন পেজ করা। কথোপকথনের এন্ডপয়েন্টে সময়-ভিত্তিক পেজিনেশন নেই; পরিবর্তে paging অবজেক্ট অনুসরণ করুন।
Conversations API-র জন্য এর কোনো টুল নেই, তাই আগের ইতিহাস Page ইনবক্সে পড়তে হয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Conversations API কি Page-এর নিজের মেসেজও অন্তর্ভুক্ত করে?
হ্যাঁ। মেসেজের from ও to ফিল্ড ব্যক্তি বা Page, দুটোরই নাম দেয়, তাই কথোপকথনের মেসেজে দুই পক্ষই থাকে।
App Review ছাড়া কি Messenger কথোপকথন পড়া যায়?
অ্যাপ বা Page-এ ভূমিকা থাকা ব্যক্তিদের জন্য Standard Access যথেষ্ট। অন্য যে কারও সঙ্গে কথোপকথনের জন্য Advanced Access লাগে, যা App Review-এর মাধ্যমে মেলে।
Conversations API কি উত্তর পাঠাতে পারে?
না। Meta-র কথোপকথন রেফারেন্স বলে এই edge প্রকাশ করতে পারে না; উত্তর যায় /{page-id}/messages-এ Send API দিয়ে।
easyCoexistence কি আমার Messenger কথোপকথন সংরক্ষণ করে?
ডিফল্টভাবে না। ফরওয়ার্ড করা ইভেন্ট কপি না রেখে এগিয়ে দেওয়া হয়; কোনো অটোমেশন চালু থাকলে মেসেজের টেক্সট 7 দিন ও অটোমেশন রানের লগ 30 দিন রাখা হয়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে