TikTok API for Business-এর ওয়েবহুক সেটআপ করা
TikTok-এর API for Business প্রতি ডেভেলপার অ্যাপ ও ইভেন্ট টাইপের জন্য একটি কলব্যাক URL-এ ওয়েবহুক পাঠায়, যা POST /business/webhook/update/ দিয়ে অ্যাপের app_id ও secret ব্যবহার করে সেট করা হয়। event_type VIDEO প্রকাশের চারটি পোস্ট ইভেন্টে সাবস্ক্রাইব করে, আর COMMENT সাবস্ক্রাইব করে comment.update-এ। প্রতিটি ডেলিভারি একটি HTTPS POST, যা Tiktok-Signature হেডারে সাইন করা থাকে, HMAC-SHA256 এবং অ্যাপের secret কী ব্যবহার করে।
easyCoexistence আপনার অ্যাপের জন্য TikTok-এর মন্তব্যের ওয়েবহুক সাবস্ক্রাইব করে রাখে, TikTok-এর সাইনেচার যাচাই করে এবং আপনার অ্যাকাউন্টের প্রতিটি মন্তব্যের ইভেন্ট নিজস্ব একটি সিক্রেট দিয়ে সাইন করে আপনার HTTPS এন্ডপয়েন্টে পাঠায়।
যে ডেলিভারির উত্তরে HTTP 200 আসেনি, TikTok সেটি কতক্ষণ পর্যন্ত এক্সপোনেনশিয়াল ব্যাকঅফে আবার পাঠায় এবং তারপর বাতিল করে।
একটি item_list-এ সর্বোচ্চ কতগুলো পোস্ট ID দেওয়া যায়, যাতে comment.update ইভেন্ট নির্দিষ্ট পোস্টে সীমাবদ্ধ থাকে।
TikTok প্রতিটি ডেলিভারির সঙ্গে webhook-schema-version হেডারে যে মান পাঠায়, তার বর্তমান মান।
TikTok-এর রেফারেন্সে ওয়েবহুক কনফিগারেশন এন্ডপয়েন্টগুলোর জন্য কী কী তালিকাভুক্ত আছে, যেগুলো app ID ও secret দিয়ে যাচাই করে।
Tiktok-Signature-এর অ্যালগরিদম: টাইমস্ট্যাম্প, একটি ডট ও বডি, যা অ্যাপের secret কী দিয়ে এবং hex-এ এনকোড করে তৈরি হয়।
TikTok Accounts-এর অধীনে comment.update-এর জন্য কোন অ্যাপ পারমিশন লাগে; প্রকাশের ইভেন্টে Business Content লাগে।
কোন ওয়েবহুক ইভেন্ট একটি TikTok অ্যাকাউন্ট অ্যাপ পেতে পারে?
দুই ধরনের ইভেন্ট, প্রতিটি আলাদা event_type হিসেবে সাবস্ক্রাইব করা হয়। VIDEO কভার করে /business/video/publish/ বা /business/photo/publish/ দিয়ে প্রকাশিত পোস্ট, আর COMMENT কভার করে অ্যাকাউন্টের ফটো পোস্ট ও পাবলিক ভিডিও পোস্টের মন্তব্য, তা API দিয়ে প্রকাশিত হোক বা TikTok অ্যাপে:
সাবস্ক্রাইব করার আগে অ্যাপের কী লাগে?
API for Business-এ অ্যাক্সেস, একটি ডেভেলপার অ্যাপ এবং এমন TikTok অ্যাকাউন্ট যারা এটি অনুমোদন করেছে। TikTok-এর সাবস্ক্রিপশন গাইড প্রতিটি ধরনের জন্য একটি পারমিশন যোগ করে, আর মন্তব্যের ইভেন্টে প্রতিটি মালিকের কাছ থেকে একটি স্কোপ লাগে:
- পোস্ট প্রকাশের ইভেন্ট: অ্যাপে TikTok Accounts, Business Content পারমিশন।
- মন্তব্যের ইভেন্ট: অ্যাপে TikTok Accounts, Business Comment পারমিশন।
- comment.update: comment.list স্কোপ, যা মালিক দেবেন এবং বৈধ রাখতে হবে।
- HTTPS-এর একটি কলব্যাক URL, যা সঙ্গে সঙ্গে HTTP 200 উত্তর দেয়।
কীভাবে সাবস্ক্রাইব করা হয়?
/business/webhook/update/-এ একটি POST দিয়ে, প্রতি event_type-এর জন্য একবার। বডিতে থাকে app_id ও secret, event_type (VIDEO বা COMMENT) ও callback_url; COMMENT-এর জন্য চাইলে item_list-ও দেওয়া যায়। উত্তরে app_id, event_type, callback_url এবং, কনফিগার করা থাকলে, item_list ফিরে আসে। একই event_type-এর জন্য আবার কল করলে কলব্যাক URL বদলে যায়।
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/webhook/update/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "<APP_ID>",
"secret": "<APP_SECRET>",
"event_type": "COMMENT",
"callback_url": "https://hooks.example.com/tiktok/"
}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": { "app_id": "<APP_ID>", "callback_url": "https://hooks.example.com/tiktok/", "event_type": "COMMENT" }
}item_list কীভাবে COMMENT ইভেন্ট সীমাবদ্ধ করে?
এটি comment.update-কে যে পোস্টগুলোর নাম দেওয়া হয়, শুধু সেগুলোতে সীমাবদ্ধ করে; /business/video/list/ থেকে সর্বোচ্চ 100টি ID দেওয়া যায়। প্রথম তালিকাই অ্যাপের জন্য তখন থেকে মোড ঠিক করে:
item_listসহ প্রথম COMMENT কল: শুধু তালিকাভুক্ত পোস্টের ইভেন্ট আসে।- পরের
item_listসহ কল: নতুন পোস্টগুলো আগে থেকে তালিকায় থাকা পোস্টের সাথে যোগ হয়। item_listছাড়া COMMENT কল, আগে কিছু সেট না থাকলে: যে অ্যাকাউন্টগুলো অ্যাপ অনুমোদন করেছে, তাদের পোস্টের ইভেন্ট আসে।item_listছাড়া COMMENT কল, একবার তালিকা থাকলে: কনফিগার করা পোস্টগুলো যেমন আছে তেমনই থাকে।
সাবস্ক্রিপশন কীভাবে দেখা বা সরানো যায়?
app_id, secret ও event_type দিয়ে GET /business/webhook/list/ কনফিগারেশন ফেরত দেয়: callback_url শুধু তখনই আসে যখন ওই ইভেন্ট টাইপের জন্য একটি থাকে, আর item_list শুধু তখনই যখন সেট করা হয়েছিল। একই তিনটি মান দিয়ে POST /business/webhook/delete/ সেটি মুছে ফেলে; COMMENT-এর জন্য delete কলে item_list থাকলে শুধু সেই পোস্টগুলো বাদ যায়, আর না থাকলে সব পোস্টের মন্তব্যের ইভেন্ট বন্ধ হয়ে যায়।
কলব্যাক URL কী করবে?
সঙ্গে সঙ্গে উত্তর দিতে হবে। TikTok HTTPS-এর উপর JSON POST করে এবং HTTP 200 ছাড়া যা-ই আসুক সেটিকে ব্যর্থ ডেলিভারি ধরে, 72 ঘণ্টা পর্যন্ত এক্সপোনেনশিয়াল ব্যাকঅফে আবার চেষ্টা করে, তারপর ইভেন্ট বাতিল করে। ডেলিভারি অন্তত একবার হয়, তাই একই ইভেন্ট দুবার আসতে পারে এবং প্রসেসিং ইডেমপোটেন্ট হতে হবে। প্রতিটি রিকোয়েস্টে লগ করার মতো তিনটি হেডার থাকে: tiktok-signature, webhook-schema-version ও x-tt-logid, আর বডিতে থাকে client_key, event, create_time (সেকেন্ডে), user_openid, যা অ্যাকাউন্টের business_id, এবং content, একটি serialize করা JSON স্ট্রিং।
Tiktok-Signature কীভাবে যাচাই করবেন?
হেডারটি কমা দিয়ে ভাগ করুন, t=<unix>,s=<hex>, তারপর সমান চিহ্ন দিয়ে। t-এর মান, একটি ডট ও রিকোয়েস্ট বডি দিয়ে সাইন করা বার্তা বানান, অ্যাপের secret কী হিসেবে ব্যবহার করে সেটির HMAC-SHA256 হিসাব করুন, hex-এ এনকোড করুন এবং s-এর সাথে তুলনা করুন। এরপর t কত পুরনো তা দেখুন: TikTok পুরনো ডেলিভারি পুনরায় পাঠানো ঠেকাতে ডেলিভারির সময় সাইন করে, আর তাদের নমুনায় 5 সেকেন্ড বিলম্ব গ্রহণযোগ্য। গ্রহণ করা কাঁচা বডি থেকে কাজ করলে JSON ভিন্নভাবে পুনরায় serialize হওয়ার সমস্যা এড়ানো যায়।
import hashlib, hmac, time
def verify_tiktok(raw_body: bytes, header: str, app_secret: str, max_age: int = 300) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, s = parts.get("t", ""), parts.get("s", "")
if not t.isdigit():
return False
expected = hmac.new(app_secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_ageeasyCoexistence-এর মাধ্যমে TikTok ইভেন্ট কীভাবে পাবেন?
অ্যাকাউন্টের জন্য একটি গন্তব্য দিয়ে। easyCoexistence তার নিজের অ্যাপ COMMENT-এ সাবস্ক্রাইব করে রাখে, TikTok-এর সাইনেচার যাচাই করে, সঙ্গে সঙ্গে TikTok-কে উত্তর দেয় এবং সংযুক্ত অ্যাকাউন্টের প্রতিটি comment.update সেই অ্যাকাউন্টের জন্য সেট করা HTTPS এন্ডপয়েন্টে POST করে। Claude বা ChatGPT থেকে set_social_webhook_destination নেয় account_id ও একটি url, থামাতে null দেয়, এবং একটি সাইনিং সিক্রেট ফেরত দেয় যা একবারই দেখানো হয়; আবার কল করলে নতুন একটি সিক্রেট ইস্যু হয়। প্রকাশের ইভেন্ট ফরওয়ার্ড করা হয় না: সেটির জন্য get_tiktok_publish_status পোস্ট অনুসরণ করে।
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }
=> {
"url": "https://hooks.example.com/tiktok/",
"signing_secret": "whsec_<SECRET>",
"note": "Shown once: store it as a secret. ..."
}Partner API দিয়ে কীভাবে সেট করা যায়?
https://easycoexistence.com/api/v1-এ PUT /channels/{id}/webhook দিয়ে, বেয়ারার টোকেন হিসেবে আপনার ec_live_ কী এবং বডিতে {"url": "https://..."}। উত্তরে থাকে webhook_url, signing_secret ও একটি note, আর {"url": null} ফরওয়ার্ডিং বন্ধ করে। URL-কে সর্বজনীন হোস্টে HTTPS ব্যবহার করতে হবে; অজানা চ্যানেল 404 not_found, সরানো হলে 409 removed, আর স্থগিত হলে 402 suspended ফেরত দেয়।
curl -X PUT "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/webhook" \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://hooks.example.com/tiktok/"}'
{ "webhook_url": "https://hooks.example.com/tiktok/", "signing_secret": "whsec_<SECRET>", "note": "..." }দুটি ডেলিভারি কীভাবে আলাদা?
easyCoexistence-এর ফরওয়ার্ড TikTok-এর নিজের ডেলিভারির চেয়ে আলাদাভাবে সাইন ও গঠিত হয়, তাই একটির জন্য লেখা রিসিভারে অন্যটির জন্য পরিবর্তন লাগবে। ফরওয়ার্ড করা পেলোডে TikTok-এর মন্তব্যের ফিল্ডগুলো থাকে, content পার্স করা এবং ID-গুলো স্ট্রিং হিসেবে; বদলায় কীভাবে প্রতিটি ডেলিভারি সাইন, স্কোপ ও পুনরায় চেষ্টা করা হয়:
| TikTok to your app | easyCoexistence to your endpoint | |
|---|---|---|
| Header | Tiktok-Signature: t=<unix>,s=<hex> | X-EC-Signature: t=<unix>,v1=<hex> |
| Key | The developer app's secret | The account's signing secret, shown once |
| Events | VIDEO and COMMENT, per app | comment.update, per connected account |
| Body | client_key, event, create_time, user_openid, content as a string | platform, account_id, external_id, entry with content parsed |
| Retries | Up to 72 hours | None: one attempt, 8 seconds, no redirects |
কীভাবে সেট আপ করবেন
- Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
- Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
- Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
- Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
- Handle repeatsKey each event on its content, such as comment_id with comment_action, or publish_id with the event name, before acting on it.
সাধারণ ভুলগুলো
- উত্তর দেওয়ার আগে ইভেন্ট প্রসেস করা। TikTok সঙ্গে সঙ্গে 200 চায় এবং যে ডেলিভারির স্বীকৃতি দেখে না সেগুলো আবার পাঠায়, তাই কাজটি সারিতে রাখুন এবং আগে উত্তর দিন।
- প্রথম COMMENT সাবস্ক্রিপশনে ভুলে item_list পাঠানো। এরপর থেকে TikTok শুধু তালিকাভুক্ত পোস্টের মন্তব্যের ইভেন্ট জানায়।
- অ্যাক্সেস টোকেন দিয়ে যাচাই করা। TikTok ওয়েবহুকে অ্যাপের secret দিয়ে সাইন করে, যেটি /business/webhook/update/ নেয়।
- দুটি পরিবেশ একটি অ্যাপে যুক্ত করা। প্রতি অ্যাপে প্রতি ইভেন্ট টাইপের একটি callback_url থাকে, এবং নতুন /business/webhook/update/ কল সেটি বদলে দেয়।
Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা PUT /channels/{id}/webhook দিয়ে সেট করুন। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন হেডারগুলো একটি TikTok ওয়েবহুক ডেলিভারি বহন করে?
tiktok-signature, webhook-schema-version, বর্তমানে v1.0, এবং x-tt-logid, যা ডেলিভারির ID। JSON বডিতে থাকে client_key, event, create_time, user_openid ও content।
একটি ভিডিও প্রকাশ হলে কি TikTok ওয়েবহুক পাঠায়?
হ্যাঁ, event_type VIDEO দিয়ে: TikTok ফাইলটি ডাউনলোড ও যাচাই করার পর post.publish.complete, তারপর পোস্ট পাবলিক হলে post_id সহ post.publish.publicly_available।
TikTok কতক্ষণ একটি ব্যর্থ ওয়েবহুক আবার পাঠায়?
72 ঘণ্টা পর্যন্ত এক্সপোনেনশিয়াল ব্যাকঅফে, তারপর ইভেন্টটি বাতিল হয়। ডেলিভারি অন্তত একবার হয়, তাই একই ইভেন্ট দুবার আসতে পারে।
easyCoexistence-এর TikTok অ্যাপে কি আমি নিজের কলব্যাক যোগ করতে পারি?
না। অ্যাপের ওয়েবহুক সেটিংস easyCoexistence-এর কাছে থাকে। set_social_webhook_destination বরং অ্যাকাউন্টের মন্তব্যের ইভেন্ট আপনার কাছে পাঠায়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে