Facebook Reels API: Page-এ Reel প্রকাশ করা
Facebook Reels API তিন ধাপে একটি Reel একটি Page-এ প্রকাশ করে: POST /{page-id}/video_reels-এ upload_phase start দিলে video_id ফেরত আসে, ভিডিও যায় rupload.facebook.com-এ, এবং POST /{page-id}/video_reels-এ upload_phase finish ও video_state PUBLISHED দিয়ে সেটি পোস্ট হয়। Meta-র স্পেসিফিকেশন হলো 9:16 অনুপাতের, 3 থেকে 90 সেকেন্ডের ভিডিও, এবং একটি Page 24 ঘণ্টায় API-র মাধ্যমে 30টি Reel প্রকাশ করতে পারে।
easyCoexistence Claude, ChatGPT বা আপনার নিজের কোড থেকে publish_facebook_post দিয়ে Facebook Page-এ সাধারণ ভিডিও পোস্ট হিসেবে ভিডিও পোস্ট করে, টেক্সট, লিংক ও ছবির পাশাপাশি।
API-তে প্রকাশিত Reel প্রতি Page-এ চলমান 24 ঘণ্টার সময়সীমায়, POST /{page_id}/video_reels-এ কার্যকর।
Meta গৃহীত Reel-এর সময়কাল; Page-এ story হিসেবে প্রকাশিত Reel 60 সেকেন্ডের বেশি হতে পারে না।
ন্যূনতম Reel রেজোলিউশন; Meta সুপারিশ করে 9 x 16 অনুপাতে 1080 x 1920 পিক্সেল।
Reel নির্ধারণ করা যায় এমন সবচেয়ে দূরের scheduled_publish_time, কমপক্ষে 10 মিনিট পরের, video_state SCHEDULED সহ।
যে Reel-এর সময়কাল Facebook সমর্থন করে না, তার ত্রুটির কোড; Reel-এর সময়কাল 3 থেকে 90 সেকেন্ড হতে হবে।
Reels API কীভাবে একটি Reel প্রকাশ করে?
দুটি হোস্টে তিন ধাপে। শুরু ও শেষ কল যায় graph.facebook.com-এ Page-এর video_reels এজে, আর ভিডিওটি যায় rupload.facebook.com-এ, যে upload_url শুরু কল ফেরত দেয় সেখানে। আপলোড ও শেষ কলের মাঝখানে ভিডিওর ID-তে একটি স্ট্যাটাস পরীক্ষা দেখায় Meta পুরো ফাইলটি পেয়েছে ও প্রক্রিয়া করেছে কি না।
একটি Reel-এর কী ধরনের ভিডিও লাগে?
Meta তার Reels স্পেসিফিকেশন Reels Publishing গাইডে প্রকাশ করে; অনুপাত, রেজোলিউশন, সময়কাল বা ফ্রেম রেটের কোনোটি না মিললে আপলোড নিজস্ব ত্রুটির কোড সহ প্রত্যাখ্যাত হয়। Page-এর story-র জন্য নির্ধারিত Reel-কেও 60 সেকেন্ডের মধ্যে থাকতে হবে।
ভিডিও কীভাবে আপলোড হয়?
rupload.facebook.com-এর upload_url-এ একটি POST দিয়ে, যাতে Authorization: OAuth হেডারে Page টোকেন থাকে। আপনার মেশিনের ফাইল যায় রিকোয়েস্ট বডি হিসেবে, offset হেডার 0 এবং file_size হেডার বাইটে আকার সহ। ইতিমধ্যে অনলাইনে থাকা ফাইল যায় file_url হেডার হিসেবে, এবং Meta সেটি নিজে আনে; সফল আপলোড success true ফেরত দেয়।
file_urlhttp বা https ঠিকানা নেয়; প্রমাণীকরণ লাগে এমন URL সমর্থিত নয়।- হোস্টকে facebookexternalhit/1.1 ইউজার এজেন্টকে ফাইল আনতে দিতে হবে, কারণ robots.txt-এ যে সাইট এটি ব্লক করে, Meta সেখানকার ফাইল প্রত্যাখ্যান করে।
- Meta-র নিজস্ব CDN-এর ফাইল, যেমন fbcdn URL, প্রত্যাখ্যাত হয়; অন্য Page-এ ভিডিও ব্যবহারের জন্য Meta crossposting-এর দিকে নির্দেশ করে।
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"একটি Reel-এর স্ট্যাটাস কীভাবে দেখবেন?
graph.facebook.com-এ GET /{video-id}?fields=status দিয়ে। উত্তরে থাকে video_status, যার মান uploading, upload_complete, processing, ready, upload_failed, expired বা error, এবং প্রতিটি ধাপের একটি করে অবজেক্ট: uploading_phase যাতে bytes_transfered, processing_phase যাতে যেকোনো ত্রুটির মেসেজ, এবং publishing_phase যাতে publish_status (draft, scheduled, published বা error) ও publish_time। প্রতিটি ধাপের নিজস্ব স্ট্যাটাস not_started, in_progress, completed বা error।
আংশিক আপলোড কীভাবে আবার শুরু হয়?
স্ট্যাটাস পরীক্ষা থেকে uploading_phase.bytes_transfered-এর মান offset হেডারে বসিয়ে আপলোড POST আবার পাঠিয়ে, অর্থাৎ Meta ইতিমধ্যে যে বাইট পেয়েছে সেখান থেকে। Meta যে offset গ্রহণ করে না তার জন্য OffsetInvalidError আসে, ফাইলের দৈর্ঘ্যের সঙ্গে না মেলা বডির জন্য PartialRequestError আসে, এবং আবার আপলোড কাজ না করলে Meta-র পরামর্শ প্রথম ধাপ থেকে নতুন করে শুরু করা।
শেষ কল কী নেয়?
শুরু কল থেকে video_id, upload_phase finish, এবং video_state PUBLISHED, DRAFT বা SCHEDULED। description-এ থাকে টেক্সট ও হ্যাশট্যাগ সমর্থন। title, place (লোকেশন Page-এর জন্য) এবং is_ai_generated, যা জানায় Reel AI দিয়ে তৈরি বা সম্পাদিত হয়েছে, ঐচ্ছিক। নির্ধারিত Reel-এ scheduled_publish_time যোগ হয়, একটি UNIX টাইমস্ট্যাম্প যা এখন থেকে 10 মিনিটের বেশি এবং 29 দিনের মধ্যে হতে হবে। Meta উত্তর দেয় success true দিয়ে।
একটি Page API-র মাধ্যমে কতগুলো Reel প্রকাশ করতে পারে?
24 ঘণ্টার চলমান সময়সীমায় 30টি। Reel প্রকাশের সময় Meta POST /{page_id}/video_reels-এ সীমাটি কার্যকর করে, এবং অ্যাপগুলোকে নিজেরাও তা কার্যকর করার সুপারিশ করে, বিশেষ করে যেসব অ্যাপ মানুষকে পরে শিডিউল করতে দেয়। কোলাবোরেটর আমন্ত্রণের নিজস্ব সীমা আছে, প্রতি Page প্রতি 24 ঘণ্টায় 10টি, এবং video_reels রেফারেন্সে ত্রুটি 613 তালিকাভুক্ত: এই API-তে কলগুলো রেট লিমিট ছাড়িয়েছে।
কোন অনুমতি ও Page টাস্ক লাগে?
এমন একজনের Page অ্যাক্সেস টোকেন যিনি Page-এ CREATE_CONTENT কাজটি করতে পারেন, সঙ্গে Facebook Login-এর মাধ্যমে pages_show_list, pages_read_engagement ও pages_manage_posts অনুমতি। Meta অ্যাপগুলোকে আরও বলে মানুষকে দেখাতে যে তাদের Reel Facebook-এ কীভাবে ব্যবহার হবে তার একটি বিজ্ঞপ্তি, সেটি নিয়ন্ত্রণের বিকল্পসহ, এবং শুধু Public দর্শক দিতে, কারণ Page-এ প্রকাশের ক্ষেত্রে পরিধি আগে থেকেই ধরে নেওয়া হয় Public।
Reels API কোন ত্রুটি ফেরত দেয়?
কোড 100 মানে একটি প্রয়োজনীয় প্যারামিটার নেই, যেমন upload_phase, এবং Meta-র মেসেজে অনুপস্থিতগুলোর তালিকা থাকে। আরও চারটি কোড সেই ভিডিও প্রত্যাখ্যান করে যা স্পেসিফিকেশনের বাইরে পড়ে:
- 1363040: অনুপাত সমর্থিত নয়; ভিডিও 16x9 থেকে 9x16-এর মধ্যে হতে হবে।
- 1363127: রেজোলিউশন সমর্থিত নয়; ন্যূনতম 540 x 960 পিক্সেল।
- 1363128: সময়কাল সমর্থিত নয়; Reel-এর সময়কাল 3 থেকে 90 সেকেন্ড।
- 1363129: গড় ফ্রেম রেট সমর্থিত নয়; Reel-এর প্রয়োজন প্রতি সেকেন্ডে 24 থেকে 60 ফ্রেম।
Page-এর Reel কীভাবে তালিকাভুক্ত করবেন?
GET /{page-id}/video_reels দিয়ে, যা Page-এর প্রকাশিত Reel-গুলো তাদের ID, আপডেটের সময় ও বর্ণনাসহ ফেরত দেয়। since ও until তালিকাকে তারিখে সীমাবদ্ধ করে, যা দেওয়া যায় today, yesterday, UNIX টাইমস্ট্যাম্প বা yyyy-mm-dd হিসেবে, এবং until হতে হবে since-এর পরের। Meta-র feed রেফারেন্স Page-এ প্রকাশিত Reel-এর জন্য এই এজের দিকে নির্দেশ করে।
easyCoexistence-এর মাধ্যমে কীভাবে Reel প্রকাশ করবেন?
আজকের দিনে Reel হিসেবে নয়। publish_facebook_post ভিডিওগুলো Page-এর videos এজে পাঠায়, সাধারণ ভিডিও পোস্ট হিসেবে, এবং video_reels কলের জন্য easyCoexistence-এর কোনো টুল নেই; Page টোকেন দেওয়া হয় না, তাই এর সংযোগে আপনার নিজের কোড থেকেও তিন ধাপ চালানো যায় না। Reel প্রকাশ করুন Facebook বা Meta Business Suite থেকে, অথবা ভিডিওটি সাধারণ ভিডিও পোস্ট হিসেবে দিন।
সাধারণ ভুলগুলো
- আপলোড graph.facebook.com-এ পাঠানো। ভিডিও যায় rupload.facebook.com-এ Authorization: OAuth হেডার সহ; শুধু শুরু, শেষ ও স্ট্যাটাস কল graph.facebook.com ব্যবহার করে।
- ফাইল এমন জায়গায় হোস্ট করা যেখানে Meta আনতে পারে না। লগইনের পেছনের, robots.txt-এ facebookexternalhit/1.1 ব্লক করা সাইটের, বা fbcdn-এর file_url প্রত্যাখ্যাত হয়।
- আংশিক আপলোডের পর একেবারে শুরু থেকে করা। আগে স্ট্যাটাস পড়ুন: uploading_phase.bytes_transfered হলো যেখান থেকে আবার শুরু করতে হবে সেই offset, এবং নতুন সেশন শেষ উপায়।
- একদিনে একটি Page-এর জন্য 30টির বেশি Reel সারিতে রাখা। Meta চলমান 24 ঘণ্টার সময়সীমায় API-তে প্রকাশিত Reel গোনে, তাই শিডিউল করা Reel-গুলো ছড়িয়ে দিন।
Reels API-র জন্য এর কোনো টুল নেই, তাই Reel প্রকাশ করা হয় Facebook বা Meta Business Suite থেকে। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
এই API দিয়ে কি কোনো Facebook প্রোফাইল বা গ্রুপে Reel প্রকাশ করা যায়?
না। Meta-র Reels Publishing API Reel শুধু Facebook Page-এ প্রকাশ করে, এবং সেগুলো শুধু Page-এ crosspost করে।
publish_facebook_post কি Reel প্রকাশ করে?
না। এটি Page-এ টেক্সট, লিংক, ছবি ও ভিডিও পোস্ট করে। Reel-এর জন্য video_reels কল দরকার, যা easyCoexistence-এর টুল করে না।
একটি Reel কপিরাইটের মিলের জন্য কীভাবে পরীক্ষা করব?
pages_read_engagement সহ GET /{video-id}?fields=copyright_check_information পড়ুন। Meta আপলোডের সময় পরীক্ষা চালায়, এটি কয়েক মিনিট নিতে পারে, এবং শুধু মালিক মিলগুলো দেখতে পান।
অন্য একটি Page কি আমার Reel-ও প্রকাশ করতে পারবে?
হ্যাঁ, কোলাবোরেটর হিসেবে। POST /{video-id}/collaborators-এ target_id সেট করে তাদের Page-এর ID দিলে একটি আমন্ত্রণ যায়, এবং তারা গ্রহণ করলে Reel তাদের Page-এও দেখা যায়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে