TikTok API for Business-এর স্কোপ: প্রতিটি অনুমতি কী খুলে দেয়
TikTok-এর API for Business দুই স্তরে অ্যাক্সেস দেয়। ডেভেলপার অ্যাপ TikTok Accounts-এর অধীনে অনুমতি রাখে, যেমন Video Publish ও Manage Account Comment, যা এন্ডপয়েন্ট খুলে দেয়। অ্যাকাউন্ট মালিকের অনুমোদন অ্যাক্সেস টোকেনে user.insights ও video.list-এর মতো স্কোপ দেয়, যা কোন ফিল্ড ফেরত আসবে তা ঠিক করে। /tt_user/token_info/get/ একটি টোকেনে থাকা স্কোপের তালিকা দেখায়।
easyCoexistence TikTok অ্যাকাউন্ট মালিকের কাছ থেকে তার অ্যাপের অনুমতিগুলো একবারের সাইন-ইনে চায়, যাতে Claude, ChatGPT বা আপনার নিজের কোড এর টুলের মাধ্যমে পাবলিশ করতে, কমেন্ট নিয়ে কাজ করতে ও ইনসাইটস পড়তে পারে, এবং get_social_credentials আপনার নিজের কোডকে Accounts API-এর অন্য এন্ডপয়েন্টের জন্য একই টোকেন দেয়।
TikTok Accounts-এর স্কোপ আইডি, যা Accounts API-এর প্রোফাইল, পোস্ট, কমেন্ট ও পাবলিশিং এন্ডপয়েন্টের উপরের প্রথম স্তরের অনুমতি।
অ্যাকাউন্টের প্রোফাইল ডেটায় is_business_account ও has_advanced_access-এর পেছনের স্কোপ।
যে স্কোপ মালিককে দিতে ও সক্রিয় রাখতে হবে, যাতে অ্যাপ comment.update ওয়েবহুক ইভেন্ট পায়।
পোস্ট সরাসরি প্রকাশ না করে ড্রাফট হিসেবে আপলোড করতে যে স্কোপ লাগে।
ডেভেলপার অ্যাপের অনুমতির পরিবর্তনে TikTok-এর রিভিউয়ে যতটি ব্যবসায়িক দিন লাগতে পারে।
TikTok-এর অনুমতির দুই স্তর কী?
অ্যাপের অনুমতি ও টোকেন স্কোপ। অ্যাপের অনুমতি বেছে নেওয়া হয় My Apps-এর অধীনে, অ্যাপের “Scope of permission”-এ, এবং TikTok সেগুলো রিভিউ করে; এগুলো তিন স্তরের হয়, আর প্রথম স্তরের অনুমতি নিচের সব এন্ডপয়েন্ট কভার করে। টোকেন স্কোপ হলো সেই অনুমোদন, যা অ্যাকাউন্ট মালিক অ্যাপকে দেওয়ার সময় দিয়েছেন; প্রতিটি টোকেনের সঙ্গে এগুলো scope হিসেবে ফেরত আসে, কমা দিয়ে আলাদা একটি স্ট্রিংয়ে। একটি কলের জন্য অ্যাপের সেই এন্ডপয়েন্টের অনুমতি লাগে, এবং কিছু প্রতিক্রিয়ার ফিল্ডের জন্য টোকেনেও স্কোপ লাগে।
কোন অ্যাপের অনুমতি কোন এন্ডপয়েন্ট খোলে?
TikTok-এর API reference প্রতিটি Accounts API এন্ডপয়েন্টের জন্য TikTok Accounts-এর অধীনে কোন অনুমতি সেটি খোলে তা তালিকাভুক্ত করে, অথবা কোনোটিই নয়। এর অনুমতির স্কোপ রেফারেন্স ও ওয়েবহুক গাইড একই গোষ্ঠীগুলোকে Business User, Business Media, Business Comment ও Business Content নামে ডাকে, তাই দুই সেট নামই আশা করুন:
কোন টোকেন স্কোপ কোন ফিল্ড খোলে?
/business/get/ ও /business/video/list/-এর জন্য TikTok-এর রেফারেন্স প্রতিটি প্রতিক্রিয়ার ফিল্ডের জন্য প্রয়োজনীয় একটি অনুমতি দেয়, এবং আরও দুটি ফিচার নিজেদের আলাদা একটি স্কোপের নাম দেয়:
- user.info.basic:
display_nameওprofile_image। - user.info.username: username, যা জুন 2023 পর্যন্ত user.info.basic-এর প্রয়োজন ছিল।
- user.info.profile:
profile_deep_link,bio_descriptionওis_verified। - user.info.stats:
following_count,followers_count,total_likesওvideos_count। - user.account.type:
is_business_accountওhas_advanced_access। - user.insights: দৈনিক অ্যাকাউন্ট মেট্রিক্স এবং বয়স, লিঙ্গ, দেশ ও শহর অনুযায়ী ফলোয়ারের বিভাজন।
- video.list: পোস্টের ফিল্ড, যেমন
item_id, caption,share_url, likes, comments, shares, reach ওvideo_views। - video.insights: ওয়াচ টাইম, সম্পূর্ণ দেখার হার, রিটেনশন, ট্র্যাফিকের উৎস, দর্শকের বিভাজন এবং একটি পোস্ট যে ক্লিক চালায়।
- comment.list: comment.update ওয়েবহুক, যা TikTok ইন-অ্যাপ কনটেন্টের কমেন্ট ও রিপ্লাই পড়া বলে বর্ণনা করে।
- video.upload: ভিডিও বা ফটো পোস্ট ড্রাফট হিসেবে আপলোড করা,
upload_to_draftবাis_draftদিয়ে।
কোনো টোকেনে কোন স্কোপ আছে, কীভাবে দেখবেন?
/tt_user/token_info/get/ এন্ডপয়েন্টে কল করুন; এটি app_id ও অ্যাক্সেস টোকেন নেয় এবং টোকেনের scope ও অ্যাকাউন্টের creator_id ফেরত দেয়। TikTok-এর উদাহরণ স্কোপ স্ট্রিংয়ে video.publish ও comment.list.manage-ও আছে, যাদের নাম পাবলিশিং ও কমেন্ট ব্যবস্থাপনার এন্ডপয়েন্টের নামের সঙ্গে মেলে, যদিও TikTok-এর রেফারেন্স এর কোনোটিকেই কোনো ফিল্ডের সঙ্গে যুক্ত করে না।
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}easyCoexistence-এর TikTok সংযোগ কী চায়?
এর ডেভেলপার অ্যাপের সবগুলো অনুমতি, যেগুলো TikTok-এর সম্মতির পাতায় দেখানো হয়। easyCoexistence অ্যাকাউন্ট মালিককে TikTok-এর পোর্টালে তার অ্যাপের জন্য তৈরি হওয়া অনুমোদনের URL-এ পাঠায়; সেই URL-এ অনুমতিগুলোর নাম আগে থেকেই উল্লেখ থাকে, এবং easyCoexistence শুধু নিজের একটি state মান যোগ করে। মালিক TikTok যা দেখায় তাতে অনুমোদন দেন, এবং TikTok যে scope স্ট্রিং ফেরত দেয় তা সংযোগের সঙ্গে সংরক্ষিত হয়। এরপর easyCoexistence অ্যাকাউন্টের জন্য যে এন্ডপয়েন্টগুলো কল করে:
- /business/get/ প্রোফাইল, দৈনিক মেট্রিক্স ও ফলোয়ারের বিভাজনের জন্য।
- /business/video/list/ পোস্ট ও তাদের মেট্রিক্সের জন্য।
- /business/video/publish/, /business/photo/publish/ ও /business/publish/status/ পাবলিশ করার জন্য।
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ ও /business/comment/delete/ কমেন্টের জন্য।
- /business/webhook/update/, অ্যাপ স্তরে, কমেন্ট ওয়েবহুকের জন্য।
পরে কীভাবে একটি অনুমতি যোগ করবেন?
দুই ধাপে, প্রতি স্তরের জন্য একটি। অ্যাপের জন্য My Apps খুলুন, অ্যাপটিতে যান, “Scope of permission”-এ যান, সম্পাদনা করুন, নতুন স্কোপের সঙ্গে মেলে এমন একটি কারণ দিন এবং জমা দিন; TikTok-এর রিভিউয়ে 2 থেকে 3 ব্যবসায়িক দিন লাগতে পারে, এবং 20 মার্চ 2026 থেকে TikTok Accounts অন্তর্ভুক্ত অনুরোধে প্রথমে Accounts API Access Application Form লাগে। টোকেনের জন্য মালিক অ্যাপকে আবার অনুমোদন দেন, কারণ একটি টোকেন তার ইস্যুর সময় অনুমোদিত স্কোপ ধরে রাখে।
কোনো অনুমতি না থাকলে কী হয়?
একটি কলের জন্য TikTok-এর রিটার্ন কোড 40001, যার অর্থ সংশ্লিষ্ট অপারেশনের জন্য কোনো অনুমতি নেই, এবং এর সমাধান অনুমতির স্কোপ রেফারেন্সের দিকে নির্দেশ করে। একটি ফিল্ডের জন্য রেফারেন্সগুলো বলে যে মালিক তার স্কোপ দেওয়ার পরই সেটি পাওয়া যায়, এবং তাদের সমাধান হলো মালিককে সেই স্কোপসহ অ্যাপকে আবার অনুমোদন দিতে বলা। অনুরোধ করার আগে /tt_user/token_info/get/ দিয়ে টোকেনের স্কোপ যাচাই করুন।
সাধারণ ভুলগুলো
- সংযুক্ত অ্যাকাউন্ট নিজে থেকে নতুন অ্যাপ অনুমতি পাবে আশা করা। প্রতিটি মালিক অ্যাপকে আবার অনুমোদন না দেওয়া পর্যন্ত তাদের টোকেন অনুমোদনের সময় অনুমোদিত স্কোপ ধরে রাখে।
- user.account.type ছাড়া is_business_account চাওয়া। TikTok শুধু সেই স্কোপ বহনকারী টোকেনের জন্য এই ফিল্ড ও has_advanced_access উপলব্ধ করে।
- comment.list ছাড়া comment.update-এর অপেক্ষা করা। মালিকের সেই স্কোপসহ অনুমোদন বৈধ থাকলেই TikTok কমেন্ট ইভেন্ট পাঠায়।
- টোকেনে অ্যাপের অনুমতির নাম খোঁজা। স্কোপ স্ট্রিং video.list-এর মতো নাম ব্যবহার করে, আর Get Account Media-র মতো নাম অ্যাপের সেটিংসের।
প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75; সংযোগ বাড়ালে দাম কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
TikTok API for Business কোন স্কোপ ব্যবহার করে?
user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list ও video.upload-এর মতো টোকেন স্কোপ, যা অ্যাপের TikTok Accounts অনুমতির উপরে অ্যাকাউন্ট মালিক দেন।
TikTok-এর কমেন্ট ওয়েবহুকের জন্য কোন অনুমতি লাগে?
অ্যাপের TikTok Accounts ও Business Comment লাগে, এবং মালিককে comment.list দিতে হবে। সেই অনুমোদনের মেয়াদ শেষ হলে বা প্রত্যাহার হলে ইভেন্ট থেমে যায়।
নতুন TikTok স্কোপ কি আগে ইস্যু হওয়া টোকেনে প্রযোজ্য?
না। একটি টোকেন তার ইস্যুর সময় অনুমোদিত স্কোপ ধরে রাখে, তাই নতুন একটি যোগ করতে অ্যাকাউন্ট মালিককে অ্যাপটি আবার অনুমোদন দিতে হয়।
TikTok নতুন অনুমতি অনুমোদন করতে কত সময় নেয়?
TikTok বলে, অনুমতির পরিবর্তনের রিভিউয়ে 2 থেকে 3 ব্যবসায়িক দিন লাগতে পারে, এবং TikTok Accounts প্রথমে যোগ করার অনুরোধে Accounts API Access Application Form লাগে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে