TikTok API সংযোগ কাজ বন্ধ করে কেন, এবং কীভাবে চালু রাখবেন
TikTok API for Business সংযোগ কাজ বন্ধ করে যখন তার 24 ঘণ্টার অ্যাক্সেস টোকেন নবায়ন না হয়, এক বছরের রিফ্রেশ টোকেনের মেয়াদ শেষ হয়, অ্যাকাউন্টের মালিক অ্যাপের অ্যাক্সেস সরিয়ে দেন, অথবা পাঠানো টোকেনটি অনুপস্থিত বা ভুল হয়। TikTok এই টোকেন-সংক্রান্ত ক্ষেত্রগুলো 40102, 40103, 40104 এবং 40105 কোড দিয়ে জানায়। আগে থেকে নবায়ন, একটি সময়সূচি অনুযায়ী প্রতিটি অ্যাকাউন্ট যাচাই, এবং বছর শেষ হওয়ার আগে মালিককে আবার অনুমোদন দিতে বলা, এসব সংযোগ চালু রাখে।
easyCoexistence প্রতিটি TikTok সংযোগ নিজে থেকে সচল রাখে: এটি 24 ঘণ্টার টোকেন আগেভাগে নবায়ন করে, প্রায় প্রতি 6 ঘণ্টায় অ্যাকাউন্ট পরীক্ষা করে, এবং TikTok যখন টোকেন প্রত্যাখ্যান করে তখন চ্যানেলকে Reconnect needed হিসেবে চিহ্নিত করে ও আপনাকে ইমেইল পাঠায়, Claude, ChatGPT বা আপনার নিজের প্ল্যাটফর্মের জন্য।
API for Business থেকে TikTok অ্যাকাউন্ট অ্যাক্সেস টোকেনের মেয়াদ; /tt_user/oauth2/refresh_token/ এটি নবায়ন করে।
রিফ্রেশ টোকেনের মেয়াদ; একবার শেষ হলে অ্যাকাউন্টের মালিককে অ্যাপটি আবার অনুমোদন করতে হয়।
ব্যর্থতার কারণ auth_removed, যখন মালিক TikTok একটি পোস্ট প্রক্রিয়া করার সময় অ্যাপের অ্যাক্সেস সরিয়ে দেন; TikTok পুনরায় চেষ্টা না করতে বলে।
ইভেন্টগুলো, যেগুলো মালিকের অনুমোদনের মেয়াদ শেষ হলে বা বাতিল হলে TikTok একটি অ্যাকাউন্টের জন্য পাঠানো বন্ধ করে।
TikTok for Developers-এর authorization.removed কেন ঘটে: ব্যবহারকারী সংযোগ বিচ্ছিন্ন করেন, অ্যাকাউন্ট মুছে ফেলা হয়, বয়স পরিবর্তন হয়, ব্যান হয়, অথবা ডেভেলপার বাতিল করেন।
easyCoexistence প্রতিটি সংযুক্ত TikTok অ্যাকাউন্ট কত ঘন ঘন পরীক্ষা করে; এটি 24 ঘণ্টার টোকেন নিজে থেকে নবায়ন করে এবং পুনরায় সংযোগ প্রয়োজন হলে আপনাকে ইমেইল পাঠায়।
একটি TikTok API সংযোগ কেন কাজ বন্ধ করে?
বেশ কয়েকটি কারণে, যার বেশিরভাগই অ্যাকাউন্টের টোকেন বা মালিকের সম্মতির সাথে জড়িত। কিছু কারণ সংযোগ পুরোপুরি বন্ধ করে দেয়, আবার কিছু কারণে সংযোগ আংশিকভাবে কাজ করে, কয়েকটি কল প্রত্যাখ্যাত হয় আর বাকিগুলো সাড়া দেয়:
প্রতিটি কারণ কোন ত্রুটি ফেরত দেয়, এবং কীভাবে ঠিক হয়?
TikTok-এর কোড ক্ষেত্রটি এদের বেশিরভাগ নাম দেয়, এবং তা আসে HTTP 200 প্রতিক্রিয়ার ভেতরে, ত্রুটির স্ট্যাটাসে নয়; আর প্রকাশনার স্ট্যাটাস নিজস্ব একটি ব্যর্থতার কারণ যোগ করে। 40100 টেবিলে আছে কারণ একটি সীমিত কল হারিয়ে যাওয়া সংযোগের মতো দেখাতে পারে। প্রতিটির অর্থ এবং সমাধান:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
টোকেনগুলো কতদিন টেকে, এবং কখন নবায়ন করবেন?
API for Business-এ অ্যাক্সেস টোকেন 24 ঘণ্টা টেকে, এবং প্রতিটি প্রতিক্রিয়ায় expires_in বাকি সেকেন্ড দেখায়; রিফ্রেশ টোকেন এক বছর টেকে, তার নিজস্ব কাউন্টডাউন থাকে refresh_token_expires_in-এ। দিন শেষ হওয়ার অনেক আগে নবায়ন করুন, একটি সময়সূচি অনুযায়ী, কোনো ব্যর্থ কলের পরে নয়; এবং প্রতিটি নবায়নে ফেরত আসা রিফ্রেশ টোকেনটি সংরক্ষণ করুন, কারণ এই ক্ষেত্রটির জন্য TikTok-এর নোট বলে এটি ধরে রাখতে হবে। refresh_token_expires_in-কে একটি সময়সীমা হিসেবে ধরুন: TikTok-এর নবায়নের উদাহরণে এটি নতুন বছর শুরু না করে কাউন্টডাউন হয়।
মালিক অ্যাপের অ্যাক্সেস সরিয়ে দিলে কী হয়?
অ্যাপ মালিকের দেওয়া Accounts API অনুমতি হারায়, ফলে সেই টোকেন দিয়ে কল কাজ বন্ধ করে, এবং TikTok API for Business-এর এমন কোনো ইভেন্ট নথিভুক্ত করেনি যা এটি ঘোষণা করে। মালিক যেকোনো সময় TikTok অ্যাপে এটি করতে পারেন, Settings and privacy, Security, Manage app permissions, Remove access এর অধীনে। লক্ষণগুলো অন্যত্র দেখা যায়: TikTok যে পোস্টটি প্রক্রিয়া করছিল সেটি auth_removed দিয়ে ব্যর্থ হয়, যা নিয়ে TikTok পুনরায় চেষ্টা না করতে বলে, এবং অ্যাকাউন্টের জন্য comment.update ইভেন্টগুলো আসা বন্ধ হয়।
অ্যাকাউন্টের ধরন বদলালে সংযোগের কী হয়?
TikTok তাদের নথিতে এর সাথে কোনো টোকেন ত্রুটি যুক্ত করেনি; যা বদলায় তা হলো API যা ফেরত দেয়। unique_video_views, daily_new_followers এবং audience_activity-এর মতো ডেটার জন্য Advanced Access বা Verified Business Account লাগে, Mentions ও Business Messaging API-এর জন্যও একই। একটি প্রাইভেট অ্যাকাউন্টের privacy_level_options থেকে PUBLIC_TO_EVERYONE বাদ থাকে। 16 অক্টোবর, 2026 থেকে is_business_account কেবল Verified Business Account-এর জন্য true দেখায় এবং has_advanced_access Advanced Access জানায়, তাই user.account.type-এর অধীনে দুটোই পড়লে একটি কল ব্যর্থ হওয়ার আগে পরিবর্তনটি ধরা পড়ে।
গ্রাহকের আগে একটি মৃত সংযোগ কীভাবে ধরবেন?
এমন পরীক্ষা দিয়ে যা কেউ পোস্ট করুক বা না করুক চলে:
- প্রতি অ্যাকাউন্টে একটি হালকা কল, সময়সূচি অনুযায়ী, যেমন username ক্ষেত্রসহ /business/get/, যা টোকেন কাজ বন্ধ করলে একটি টোকেন ত্রুটি ফেরত দেয়।
- /
tt_user/token_info/get/, যার কোনো অনুমতির দরকার নেই এবং যা টোকেনের scope ফেরত দেয়, যাতে নিশ্চিত হওয়া যায় যে অনুমতিগুলো এখনো আপনার ফিচারের কলগুলো কভার করে। refresh_token_expires_inপ্রতিটি প্রতিক্রিয়া আসার সময় একটি তারিখে রূপান্তর করা, এবং মালিককে কয়েক সপ্তাহ আগে একটি অনুস্মারক।- কোনো অ্যাকাউন্ট যেটিতে সাধারণত মন্তব্য আসে, তার comment.update-এ নীরবতা, কারণ অনুমোদনের মেয়াদ শেষ হলে বা বাতিল হলে TikTok ওই ইভেন্টগুলো বন্ধ করে।
- প্রতি অ্যাকাউন্টে 40102, 40103, 40104 এবং 40105 গণনা, যাতে অনেকের মধ্যে একটি ব্যর্থ অ্যাকাউন্ট আলাদা করে চোখে পড়ে।
একটি অ্যাকাউন্ট কীভাবে পুনরায় সংযুক্ত করবেন?
একই অ্যাকাউন্টের জন্য অনুমোদনটি আবার চালিয়ে। TikTok account holder authorization URL শেয়ার করুন, একটি state মান সহ যা ফেরত আসাকে অ্যাকাউন্টের সাথে যুক্ত করে, এবং মালিককে অনুমতির পাতা আবার দেখাতে হলে disable_auto_auth=1। নতুন auth_code-কে তার 10 মিনিটের মধ্যে /tt_user/oauth2/token/-এ বিনিময় করুন, তারপর উভয় সংরক্ষিত টোকেন প্রতিস্থাপন করুন। open_id হলো অ্যাকাউন্টের জন্য TikTok-এর অ্যাপ্লিকেশন-নির্দিষ্ট আইডি, তাই দ্বিতীয় রেকর্ড না বানিয়ে নতুন টোকেনগুলো তার মাধ্যমে সংরক্ষিত রেকর্ডের সাথে মেলান।
Content Posting API সংযোগ কি একইভাবে মেয়াদ শেষ হয়?
না। TikTok for Developers, যা Content Posting ও Display API পরিবেশন করে, 2 নভেম্বর, 2026-এ তাদের টোকেন পাতা আপডেট করেছে: ব্যবহারকারীর অ্যাক্সেস টোকেন 2 ঘণ্টার মধ্যে মেয়াদ শেষ হয় এবং রিফ্রেশ টোকেন প্রথম ইস্যুর দিন থেকে 180 দিন টেকে। এর রিফ্রেশ টোকেনগুলো বদলে যায়, তাই প্রতিটি সফল রিফ্রেশ একটি নতুন টোকেন ফেরত দেয় এবং যেটি পাঠানো হয়েছিল সেটিকে সঙ্গে সঙ্গে অবৈধ করে; কোনো সার্ভার বদলে যাওয়া টোকেন ব্যবহার করতে থাকলে পরবর্তী রিফ্রেশগুলো ব্যর্থ হয় এবং ব্যবহারকারীকে আবার অনুমোদন দিতে হয়। খারাপ রিফ্রেশ টোকেন invalid_grant দিয়ে, খারাপ অ্যাক্সেস টোকেন access_token_invalid ও HTTP 401 দিয়ে ব্যর্থ হয়, এবং এর authorization.removed ওয়েবহুক বলে দেয় কেন একজন ব্যবহারকারী চলে গেছেন।
easyCoexistence সংযোগ সচল রাখতে কী করে?
এটি নিজে থেকে নবায়ন ও পরীক্ষা করে, এবং কখন শুধু মালিক ঠিক করতে পারেন তা জানায়:
- নবায়ন: কল করার আগে যখন 15 মিনিটের কম বাকি থাকে, এবং পরীক্ষার সময় যখন 8 ঘণ্টার কম বাকি থাকে, প্রতিবার নতুন রিফ্রেশ টোকেন ও তার মেয়াদ সংরক্ষণ করে।
- প্রতি অ্যাকাউন্টে একবারে একটি নবায়ন, যাতে একসাথে আসা কলগুলো তা ভাগ করে নেয়।
- পরীক্ষা: অ্যাকাউন্টের username-এর জন্য প্রায় প্রতি 6 ঘণ্টায় একটি /business/get/ কল।
- প্রত্যাখ্যাত টোকেন, 40102, 40104 বা 40105: চ্যানেলটি Reconnect needed দেখায়, মালিক একটি ইমেইল পান, এবং একটি প্ল্যাটফর্ম channel.disconnected পায়, যেখানে TikTok-এর মেসেজটি
disconnected_reasonহিসেবে থাকে। - ততক্ষণ টুলগুলো জানায় যে অ্যাকাউন্টটিকে পুনরায় সংযুক্ত করতে হবে, এবং একটি নির্ধারিত পোস্ট reconnect হিসেবে ব্যর্থ হয়, TikTok পর্যন্ত পৌঁছায় না।
- পুনরায় সংযোগ: চ্যানেলের পাতায় Connect TikTok, বা একটি নতুন connect সেশন চালু করুন; আবার সাইন ইন করলে একই
account_idএবং ইভেন্টের গন্তব্য বজায় থাকে।
কীভাবে সেট আপ করবেন
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
সাধারণ ভুলগুলো
- একটি নীরব comment ওয়েবহুককে নীরব অ্যাকাউন্ট ভেবে নেওয়া। অনুমোদনের মেয়াদ শেষ হলে TikTok ওই অ্যাকাউন্টের comment.update বন্ধ করে, তাই ইভেন্টের অপেক্ষা না করে অ্যাকাউন্টটি পরীক্ষা করুন।
- নতুন রেকর্ডে পুনঃসংযোগ করা। open_id দিয়ে নতুন টোকেনগুলো মেলান, যা TikTok-এর অ্যাকাউন্টের অ্যাপ্লিকেশন-নির্দিষ্ট আইডি, এবং সংরক্ষিত রেকর্ডটি সেখানেই আপডেট করুন, তার ইতিহাস ও সেটিংস রেখে দিয়ে।
- একই রিফ্রেশ টোকেন দিয়ে 40103 বা 40107 আবার চেষ্টা করা। কোনোটিই পুনরায় চেষ্টায় দূর হয় না: প্রথমটির জন্য নতুন অনুমোদন দরকার, দ্বিতীয়টির জন্য সর্বশেষ প্রতিক্রিয়ার রিফ্রেশ টোকেন বা নতুন অনুমোদন।
- 40100-কে হারানো সংযোগ ভাবা। এটি একটি সীমিত কল; এন্ডপয়েন্টটি 5 মিনিট বিরতি দিন, বা দৈনিক সীমার পরে 00:00 UTC পর্যন্ত, তাহলে একই টোকেন কাজ করতে থাকে।
প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ালে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
মালিক ছাড়া কি একটি TikTok API সংযোগ চিরকাল টিকতে পারে?
না। নবায়ন সর্বোচ্চ রিফ্রেশ টোকেনের এক বছর পর্যন্ত সংযোগ বহন করে; এরপর TikTok-এর নথিভুক্ত পথ হলো অ্যাকাউন্টের মালিকের নতুন অনুমোদন।
একাধিক অ্যাকাউন্টে একসাথে কেন TikTok সংযোগ ব্যর্থ হলো?
অ্যাকাউন্টের আগে অ্যাপটি দেখুন: 40113 মানে অ্যাপ ব্লক করা হয়েছে বা তার আইডি ও সিক্রেট মেলে না, এবং অপব্যবহারের কারণে TikTok কোনো অ্যাপের Accounts API অ্যাক্সেস বাতিল করতে পারে।
নতুন ফিচারের মানে কি TikTok অ্যাকাউন্ট পুনরায় সংযুক্ত করা?
যখন ফিচারটিতে এমন একটি scope লাগে যা মালিক কখনো মঞ্জুর করেননি, তখন হ্যাঁ। একটি টোকেন অনুমোদনের সময় অনুমোদিত scope রাখে, তাই একটি যোগ করতে মালিককে অ্যাপটি আবার অনুমোদন করতে হয়।
একটি অ্যাকাউন্টের পুনঃসংযোগ প্রয়োজন থাকাকালীন নির্ধারিত TikTok পোস্টের কী হয়?
easyCoexistence-এ সেগুলো নির্ধারিত সময়ে reconnect হিসেবে ব্যর্থ হয়, TikTok পর্যন্ত পৌঁছায় না, মালিককে ইমেইল পাঠানো হয়, এবং অ্যাকাউন্ট আবার সংযুক্ত হলে Retry সেগুলো পাঠিয়ে দেয়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে