Messenger Send API: Facebook Page থেকে মেসেজ পাঠানো
একটি Facebook Page POST /{page-id}/messages এন্ডপয়েন্টে একটি Page অ্যাক্সেস টোকেন দিয়ে Messenger মেসেজ পাঠায়: recipient-এ থাকে ব্যক্তির Page-ভিত্তিক ID বা PSID। স্ট্যান্ডার্ড মেসেজিং উইন্ডোর ভেতরে messaging_type হয় RESPONSE বা UPDATE, আর উইন্ডোর পরে হয় MESSAGE_TAG। message ফিল্ডে থাকে টেক্সট, অথবা একটি অ্যাটাচমেন্ট, যেমন ছবি, অডিও, ভিডিও বা ফাইল। Meta recipient_id ও message_id দিয়ে উত্তর দেয়।
easyCoexistence Claude, ChatGPT বা নিজের কোড থেকে 24 ঘণ্টার উইন্ডোর ভেতরে send_social_dm দিয়ে Messenger-এ DM-এর উত্তর দেয়, টেক্সট হিসেবে; মিডিয়া, কুইক রিপ্লাই ও টেমপ্লেট এর আওতায় পড়ে না।
টেক্সট, লিংক, রিঅ্যাকশন ও স্টিকারযুক্ত মেসেজের জন্য একটি অ্যাপ প্রতি Page-এ কতগুলো Send API কল করতে পারে।
অডিও বা ভিডিওযুক্ত মেসেজের জন্য একটি অ্যাপ প্রতি Page-এ কতগুলো Send API কল করতে পারে।
Messenger Platform পুনর্ব্যবহারের জন্য যে সবচেয়ে বড় অ্যাসেট সংরক্ষণ করে; URL থেকে আপলোড করা ছবির সীমা 8 MB।
একটি মেসেজ তার attachments অ্যারেতে সর্বোচ্চ কতগুলো ছবি বহন করতে পারে; এটিই সেখানে অনুমোদিত একমাত্র মিডিয়া ধরন।
একটি সংরক্ষিত attachment_id কতদিন বৈধ থাকে, এরপর মিডিয়া আবার আপলোড করতে হয়।
Send API রিকোয়েস্টে কী থাকে?
Meta তালিকা দেয় একটি পাঠানোয় অবশ্যই যে ছয়টি উপাদান থাকতে হবে: যে Page পাঠাচ্ছে তার ID, গ্রহণকারী ব্যক্তির ID, সেই Page-এর একটি অ্যাক্সেস টোকেন, ব্যক্তির অনুমতি, মেসেজের ধরন এবং কনটেন্ট। রিকোয়েস্টটি /{page-id}/messages-এ JSON-এর একটি POST, আর যে কাউকে সদ্য মেসেজ করেছে তার উত্তরের রিকোয়েস্ট দেখতে এ রকম:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient-এ কোন ID যায়?
সাধারণত এটি Page-ভিত্তিক ID বা PSID, যা Meta কোনো ব্যক্তি প্রথমবার Page-কে মেসেজ করলে তাকে দেয়। এটি messages ওয়েবহুকে sender.id হিসেবে আসে। recipient অবজেক্ট কিছু বিশেষ ক্ষেত্রে অন্য ধরনের ID গ্রহণ করে:
- id: PSID, যা সেই ব্যক্তি ও সেই Page-এর জন্য অনন্য।
user_ref: যে ব্যক্তি কোনো প্লাগইন বা পোস্টব্যাক বাটন ব্যবহার করে Page-কে মেসেজ করেছে তার জন্য।comment_idবাpost_id: কোনো কমেন্ট বা ভিজিটরের পোস্টের প্রাইভেট রিপ্লাইয়ের জন্য।- Facebook Login-এর ID অ্যাপ-ভিত্তিক, তাই এগুলো Messenger Platform-এ কাজ করে না।
কোন messaging_type ব্যবহার করা উচিত?
এই ধরন Meta-কে জানায় মেসেজটি কেন পাঠানো হচ্ছে, এবং তা কখন পাঠানো অনুমোদিত তা ঠিক করে। Meta-র Page messages রেফারেন্স চারটি মান তালিকাভুক্ত করে:
- RESPONSE: Page যে মেসেজ পেয়েছে তার উত্তর, প্রচারমূলক হোক বা না হোক, স্ট্যান্ডার্ড মেসেজিং উইন্ডোর ভেতরে।
- UPDATE: Page নিজের উদ্যোগে যে মেসেজ পাঠায়, প্রচারমূলক হোক বা না হোক, এটিও উইন্ডোর ভেতরে।
MESSAGE_TAG: উইন্ডোর পরে পাঠানো অ-প্রচারমূলক মেসেজ, যার ট্যাগ একটি অনুমোদিত ব্যবহারের ক্ষেত্রের সঙ্গে মেলে।- UTILITY: অনুমোদিত টেমপ্লেট থেকে তৈরি একটি ইউটিলিটি মেসেজ, যেমন অর্ডার বা অ্যাপয়েন্টমেন্টের আপডেট।
একটি মেসেজে কী থাকতে পারে?
টেক্সট, অথবা একটি অ্যাটাচমেন্ট অবজেক্ট, যার একটি type ও একটি পেলোড আছে: ছবি, অডিও, ভিডিও ও ফাইল অ্যাটাচমেন্ট একটি URL বা সংরক্ষিত attachment_id-কে নির্দেশ করে, আর টেমপ্লেট অ্যাটাচমেন্ট বোতামসহ কাঠামোবদ্ধ মেসেজ বহন করে। একই এন্ডপয়েন্টও এগুলো নেয়:
- attachments: একটি একক মেসেজ হিসেবে পাঠানো সর্বোচ্চ 30টি ছবির অ্যারে।
reply_to, mid সহ: নির্দিষ্ট একটি আগের মেসেজের উত্তর, সেটি ব্যক্তির বা Page-এর যেটিই হোক।quick_replies: কম্পোজারের ওপরে সর্বোচ্চ 13টি বোতাম, প্রতিটির শিরোনাম সর্বোচ্চ 20 অক্ষর।sender_action: টাইপিং ইন্ডিকেটর, সিন মার্ক বা রিঅ্যাকশন, যা মেসেজ থেকে আলাদা একটি রিকোয়েস্টে পাঠানো হয়।notification_type: ডিফল্টভাবে REGULAR, অথবাSILENT_PUSHবাNO_PUSH।
অ্যাটাচমেন্ট কত বড় হতে পারে?
Meta-র অ্যাসেট সংরক্ষণের গাইড Messenger Platform যে মিডিয়া আনে ও ধরে রাখে, তার সীমা ঠিক করে: অ্যাসেট 25 MB পর্যন্ত, URL থেকে আপলোড করা ছবি 8 MB পর্যন্ত, audio Content-Type দিয়ে পাঠানো অডিও, এবং 75 সেকেন্ডের মধ্যে আনা ভিডিও। is_reusable-কে true সেট করলে একটি attachment_id ফেরত আসে, যা শুধু যে Page পাঠিয়েছে সে 90 দিন পুনরায় ব্যবহার করতে পারে, এবং POST /{page-id}/message_attachments আগে থেকে মিডিয়া আপলোড করে।
Send API-এর রেট লিমিট কী?
Meta এগুলো Page অনুযায়ী ও কনটেন্ট অনুযায়ী গোনে। Page messages রেফারেন্সে পাঠানো সংক্রান্ত ত্রুটিগুলোর মধ্যে 613 আছে, যার বার্তা “Calls to this api have exceeded the rate limit”। এটি দেখা দিলে সঙ্গে সঙ্গে আবার চেষ্টা না করে গতি কমান:
- প্রতি Page-এ টেক্সট, লিংক, রিঅ্যাকশন ও স্টিকারের মেসেজের জন্য প্রতি সেকেন্ডে 300 কল।
- প্রতি Page-এ অডিও বা ভিডিওর মেসেজের জন্য প্রতি সেকেন্ডে 10 কল।
- একটিমাত্র থ্রেডে অনেক মেসেজ পাঠালে সেটি আলাদাভাবেও রেট লিমিটেড হতে পারে।
- সব মিলিয়ে Messenger API কল: সক্রিয় ব্যবহারকারীর সংখ্যার 200 গুণ, চলমান 24 ঘণ্টায়।
- প্রতি সেকেন্ডে 40টির বেশি মেসেজ হলে Page-এর ইনবক্সে নতুন মেসেজ দেখানো বন্ধ হয়, এবং ভলিউম না কমা পর্যন্ত Page পাঠাতে পারে না।
Send API কোন ত্রুটি ফেরত দেয়?
Meta-র Messenger ত্রুটির টেবিলে প্রতিটি কোডের সঙ্গে একটি সাবকোড যুক্ত থাকে, যা কারণটি নির্দিষ্ট করে। Page পাঠানোর সময় যেগুলো সবচেয়ে বেশি পায়, সেগুলো এই:
- 10, সাবকোড 2018278 বা 2534022: এই মেসেজ অনুমোদিত উইন্ডোর বাইরে পাঠানো হয়েছে।
- 10, সাবকোড 2018300: অন্য একটি অ্যাপ কথোপকথন নিয়ন্ত্রণ করে।
- 100: অবৈধ প্যারামিটার, যেমন ভুল recipient ID; সাবকোড 2018001 বলে “No matching user found”।
- 551: ব্যক্তি পাওয়া যাচ্ছে না, হয়তো Page ব্লক করেছে বা অ্যাকাউন্ট নিষ্ক্রিয় করেছে; 200, সাবকোড 1545041 বলে “This person isn't available right now”।
- 200, সাবকোড 2018028:
pages_messagingপর্যালোচিত ও অ্যাপ লাইভ না হওয়া পর্যন্ত অ্যাপ নিজের ভূমিকার বাইরের ব্যক্তিদের মেসেজ করতে পারে না। - 10904: Page-এর সেটিংসে মেসেজ বন্ধ রয়েছে।
easyCoexistence কীভাবে এর মাধ্যমে পাঠায়?
send_social_dm নেয় account_id, ব্যক্তির recipient_id, যা একটি ফরওয়ার্ড করা messages ইভেন্টে sender.id, এবং টেক্সট, তারপর এগুলো messaging_type RESPONSE সহ /{page-id}/messages-এ পাঠায়। ফলাফল হলো message_id-সহ Meta-র উত্তর, আর পাঠানো প্রত্যাখ্যাত হলে Meta-র ত্রুটি কোড ও বার্তা ফেরত আসে। মিডিয়া, কুইক রিপ্লাই, টেমপ্লেট ও সেন্ডার অ্যাকশন টুলগুলোর মধ্যে নেই: send_social_dm টেক্সট পাঠায়।
সাধারণ ভুলগুলো
- মেসেজের সঙ্গে একটি টাইপিং ইন্ডিকেটর পাঠানো। Meta চায় sender_action আলাদাভাবে, শুধু recipient-সহ, আর টেক্সট বা টেমপ্লেট একটি আলাদা রিকোয়েস্টে।
- একজন ব্যক্তিকে একসঙ্গে একগাদা মেসেজ পাঠানো। Meta Page-এর প্রতি সেকেন্ডে 300 কলের সীমা ছাড়াও একটিমাত্র থ্রেডকে আলাদাভাবে রেট লিমিট করতে পারে।
- টেক্সটের হারে অডিও বা ভিডিও পাঠানো। অডিও বা ভিডিওযুক্ত মেসেজ প্রতি সেকেন্ডে Page-প্রতি 10 কলের মধ্যে সীমাবদ্ধ।
- 90 দিনের পুরোনো attachment_id পুনরায় ব্যবহার করা। সংরক্ষিত attachment ID-এর মেয়াদ শেষ হয়, তাই নতুন একটির জন্য মিডিয়াটি আবার আপলোড করুন।
অটোমেশন নতুন মেসেজের উত্তর নিজে থেকে দেয়, একটি নির্দিষ্ট টেক্সট বা AI-এর উত্তর দিয়ে। প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ানোর সঙ্গে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Messenger Send API কি বিনামূল্যে?
হ্যাঁ, স্ট্যান্ডার্ড মেসেজের জন্য। Meta-র ওভারভিউ Messenger Platform-কে ব্যবহারে বিনামূল্যে বলে, তাই যে Page তাকে মেসেজকারী মানুষের উত্তর দেয়, তার প্রতি মেসেজে কোনো খরচ হয় না; মার্কেটিং মেসেজের জন্য প্রতি মেসেজে চার্জ হয়।
মেসেজ পাঠাতে কোন Page টাস্ক লাগে?
Meta-র Messenger ওভারভিউ একজন ব্যক্তির কাছ থেকে Page টোকেন চায়, যিনি MESSAGING ও MODERATE টাস্ক সম্পাদন করতে পারেন, এবং pages_messaging অনুমতি দেওয়া থাকতে হবে।
easyCoexistence কি Messenger-এ ছবি দিয়ে উত্তর দিতে পারে?
এখনো নয়। send_social_dm টেক্সট পাঠায়, আর কোনো টুল অ্যাটাচমেন্ট পাঠায় না।
একটি Facebook Page-এর জন্য easyCoexistence-এর খরচ কত?
আপনি যে প্রতিটি Page যুক্ত করেন, তা একটি সংযোগ, এবং কতগুলো আছে তার ওপর নির্ভর করে প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75 হারে বিল হয়, আর প্রথম 3 দিন ফ্রি।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে