কীভাবে API-র মাধ্যমে একটি TikTok পোস্টের প্রকাশের স্ট্যাটাস দেখবেন
TikTok API পোস্ট অ্যাসিঙ্ক্রোনাসভাবে প্রকাশ করে: প্রকাশের কল একটি share_id ফেরত দেয়, এবং সেই ID-কে publish_id হিসেবে দিয়ে GET /business/publish/status/ কল করলে পোস্টটি কোন অবস্থায় আছে তা জানা যায়। TikTok ফাইল ডাউনলোড করার সময় স্ট্যাটাস থাকে PROCESSING_DOWNLOAD, মডারেশন পেরিয়ে প্রকাশিত হলে PUBLISH_COMPLETE, আর ব্যর্থ হলে FAILED, সঙ্গে frame_rate_check_failed-এর মতো একটি কারণ।
easyCoexistence publish_tiktok_post দিয়ে TikTok-এ প্রকাশ করে এবং get_tiktok_publish_status দিয়ে প্রতিটি পোস্ট অনুসরণ করে, Claude, ChatGPT বা আপনার নিজের কোড থেকে, যাতে আপনার AI TikTok-এর স্ট্যাটাস ও যেকোনো ব্যর্থতার কারণ যেমন আছে তেমনই দেখতে পায়।
পোস্ট ID কখন PUBLISH_COMPLETE-এর পরে পাওয়া যেতে পারে; সেটি না পাওয়া গেলে TikTok তিন মিনিট পরে আবার চেষ্টা করতে বলে।
1 GB পোস্ট ফাইল ডাউনলোড করতে TikTok-এর সাধারণ অনুমান; আসল সময় ফাইলের আকার ও নেটওয়ার্কের উপর নির্ভর করে।
আপলোড সম্পূর্ণ হওয়ার পর পোস্ট সর্বজনীন হতে সাধারণত সবচেয়ে বেশি যত সময় লাগে; ম্যানুয়াল মডারেশনে আরও বেশি সময় লাগতে পারে।
ডাউনলোড টাইমআউট, যার পর TikTok video_pull_failed বা photo_pull_failed সহ পোস্ট ব্যর্থ করে।
কেন একটি TikTok পোস্ট অনুসরণ করতে হয়?
কারণ TikTok পোস্টটি পটভূমিতে প্রকাশ করে। প্রকাশের কল একটি টাস্ক শুরু করে এবং সঙ্গে সঙ্গে একটি share_id ফেরত দেয়; এরপর TikTok তার URL থেকে ফাইলটি ডাউনলোড করে, ফরম্যাট যাচাই করে, মডারেশন চালায় এবং পোস্টটি সর্বজনীন করে। কলটি সফল হওয়ার পরও পোস্ট ব্যর্থ হতে পারে।
কোন কোন স্ট্যাটাস আছে?
GET /business/publish/status/ অ্যাকাউন্টের business_id এবং publish_id হিসেবে share_id নেয়, এবং চারটির একটি স্ট্যাটাস ফেরত দেয়:
PROCESSING_DOWNLOAD: TikTok তার URL থেকে কনটেন্ট ডাউনলোড করছে।PUBLISH_COMPLETE: পোস্টটি মডারেশন পেরিয়ে প্রকাশিত হয়েছে; সর্বজনীনভাবে দেখা যাওয়ার পরpost_ids-এ এটি তালিকাভুক্ত হয়।- FAILED: প্রকাশ থেমে গেছে, এবং reason-এ কারণ বলা থাকে।
SEND_TO_USER_INBOX: একটি ড্রাফট আপলোড হয়েছে এবং TikTok ক্রিয়েটরের ইনবক্সে জানিয়েছে; এটি শুধু ড্রাফটের ক্ষেত্রে প্রযোজ্য।
প্রকাশে কত সময় লাগে?
TikTok কোনো নির্দিষ্ট সময় দেয় না। ডাউনলোড ফাইলের আকার ও নেটওয়ার্কের উপর নির্ভর করে; TikTok-এর সাধারণ অনুমান হলো 1 GB ফাইলের জন্য 30 মিনিট যথেষ্ট, এবং এক ঘণ্টা সর্বোচ্চ সীমা। এরপর পোস্ট সাধারণত 2 মিনিটের মধ্যে সর্বজনীন হয়, অথবা ম্যানুয়াল মডারেশন লাগলে তার পরে, এবং স্ট্যাটাসে এর পোস্ট ID দেখাতে আরও তিন মিনিট পর্যন্ত লাগতে পারে।
ব্যর্থতার কারণগুলোর মানে কী?
reason বলে দেয় কী পোস্টটি থামিয়েছে। কিছু কারণে ফাইল বদলাতে হয়, আবার কিছু কারণে পুনরায় চেষ্টা কাজ করতে পারে:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: ফাইল কোনো ফরম্যাটের নিয়ম ভাঙে, এবং TikTok এগুলোকে পুনরায় চেষ্টা করার অযোগ্য হিসেবে চিহ্নিত করে।video_pull_failed,photo_pull_failed: TikTok ফাইলটি ডাউনলোড করতে পারেনি, অথবা এক ঘণ্টার মধ্যে পারেনি; URL সর্বজনীনভাবে পৌঁছানোর যোগ্য হলে আবার চেষ্টা করুন।- internal: TikTok-এর সার্ভিসের কোনো অংশ অনুপলব্ধ ছিল, এবং আবার চেষ্টা করা ঠিক আছে।
spam_risk_too_many_posts,spam_risk,spam_risk_text: পরিমাণ, আচরণ বা ক্যাপশনের কনটেন্টের কারণে TikTok পোস্টটি থামিয়েছে।auth_removed: প্রক্রিয়াকরণের সময় অ্যাকাউন্ট অ্যাপের অ্যাক্সেস প্রত্যাহার করেছে, এবং TikTok আবার চেষ্টা না করতে বলে।spam_risk_user_banned_from_posting: অ্যাকাউন্টটি নতুন পোস্ট করা থেকে নিষিদ্ধ।
পোস্ট ID কীসের জন্য?
পরে পোস্টটি খুঁজে পাওয়ার জন্য। TikTok-এর রেফারেন্স অনুযায়ী পোস্টের মেট্রিক পড়তে পোস্ট ID filters.video_ids-এ দিয়ে /business/video/list/-এ পাঠানো হয়। কমেন্ট কলের ক্ষেত্রে অ্যাকাউন্টের ভিডিও তালিকা থেকে পোস্টের item_id নিয়ে video_id হিসেবে দেওয়া হয়, যা easyCoexistence-এর কমেন্ট টুলও post_id হিসেবে নেয়।
easyCoexistence কীভাবে একটি পোস্ট অনুসরণ করে?
publish_tiktok_post TikTok-এর share_id ফেরত দেয়, সঙ্গে একটি নোট যে TikTok পোস্টটি প্রক্রিয়া করছে; আর get_tiktok_publish_status সেই share_id নিয়ে TikTok-এর বর্তমান স্ট্যাটাস ফেরত দেয়, কারণ থাকলে সেটিসহ। সঙ্গে সঙ্গে না করে কয়েক মিনিট পর আপনার AI-কে আবার যাচাই করতে বলুন।
সাধারণ ভুলগুলো
- কিছু দেখা যায়নি বলে আবার প্রকাশ করা। প্রথম কলটি শুধু টাস্ক শুরু করেছিল, তাই পোস্টটি দ্বিতীয়বার পাঠানোর আগে তার স্ট্যাটাস দেখুন।
- post_ids ছাড়া PUBLISH_COMPLETE-কে ত্রুটি ভাবা। ID আসতে আরও তিন মিনিট লাগতে পারে, তাই তখন আবার দেখুন।
- ফরম্যাট ব্যর্থতায় একই ফাইল দিয়ে আবার চেষ্টা করা। file_format_check_failed ও অন্য যাচাই-ব্যর্থতার জন্য সংশোধিত ফাইল দরকার।
- ডাউনলোডের সময় URL অফলাইন করা। ফাইল আনতে না পারলে TikTok video_pull_failed বা photo_pull_failed সহ পোস্ট ব্যর্থ করে।
প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ালে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
TikTok-এ share_id কী?
এটি একটি প্রকাশনা টাস্কের ID, যা ভিডিও ও ফটো প্রকাশের এন্ডপয়েন্ট ফেরত দেয়। স্ট্যাটাস কলে এটি publish_id হিসেবে যায়।
TikTok প্রকাশের স্ট্যাটাসের জন্য কোনো ওয়েবহুক আছে কি?
হ্যাঁ। /business/webhook/update/-এর মাধ্যমে event_type VIDEO দিয়ে সাবস্ক্রাইব করা একটি অ্যাপ TikTok-এর পোস্ট প্রকাশের ইভেন্ট পায়, যেমন post.publish.failed, যার সঙ্গে কারণ ও publish_id থাকে; বারবার স্ট্যাটাস যাচাইয়ের বদলে এটি ব্যবহার করা যায়।
কেন প্রকাশিত পোস্টের এখনও পোস্ট ID নেই?
PUBLISH_COMPLETE-এর পর post_ids ফেরত দিতে TikTok তিন মিনিট পর্যন্ত সময় নিতে পারে, এবং শুধু সর্বজনীনভাবে দেখা যাওয়া পোস্টের জন্যই তা ফেরত দেয়।
ব্যর্থ TikTok পোস্ট কি আবার চেষ্টা করা যায়?
কারণের উপর নির্ভর করে। ডাউনলোড ও internal ব্যর্থতায় আবার চেষ্টা করা যায়; ফরম্যাট, duration, frame rate ও picture size ব্যর্থতায় সংশোধিত ফাইল লাগে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে