লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

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 এন্ডপয়েন্টে পাঠায়।

72 hours

যে ডেলিভারির উত্তরে HTTP 200 আসেনি, TikTok সেটি কতক্ষণ পর্যন্ত এক্সপোনেনশিয়াল ব্যাকঅফে আবার পাঠায় এবং তারপর বাতিল করে।

100

একটি item_list-এ সর্বোচ্চ কতগুলো পোস্ট ID দেওয়া যায়, যাতে comment.update ইভেন্ট নির্দিষ্ট পোস্টে সীমাবদ্ধ থাকে।

v1.0

TikTok প্রতিটি ডেলিভারির সঙ্গে webhook-schema-version হেডারে যে মান পাঠায়, তার বর্তমান মান।

No permission

TikTok-এর রেফারেন্সে ওয়েবহুক কনফিগারেশন এন্ডপয়েন্টগুলোর জন্য কী কী তালিকাভুক্ত আছে, যেগুলো app ID ও secret দিয়ে যাচাই করে।

HMAC-SHA256

Tiktok-Signature-এর অ্যালগরিদম: টাইমস্ট্যাম্প, একটি ডট ও বডি, যা অ্যাপের secret কী দিয়ে এবং hex-এ এনকোড করে তৈরি হয়।

Business Comment

TikTok Accounts-এর অধীনে comment.update-এর জন্য কোন অ্যাপ পারমিশন লাগে; প্রকাশের ইভেন্টে Business Content লাগে।

কোন ওয়েবহুক ইভেন্ট একটি TikTok অ্যাকাউন্ট অ্যাপ পেতে পারে?

দুই ধরনের ইভেন্ট, প্রতিটি আলাদা event_type হিসেবে সাবস্ক্রাইব করা হয়। VIDEO কভার করে /business/video/publish/ বা /business/photo/publish/ দিয়ে প্রকাশিত পোস্ট, আর COMMENT কভার করে অ্যাকাউন্টের ফটো পোস্ট ও পাবলিক ভিডিও পোস্টের মন্তব্য, তা API দিয়ে প্রকাশিত হোক বা TikTok অ্যাপে:

post.publish.failedVIDEO: the post broke a format rule or its URL was blocked before the download finished
post.publish.completeVIDEO: the file met the format rules and downloaded without problems
post.publish.publicly_availableVIDEO: moderation passed and the post is public, with its post_id
post.publish.no_longer_publicly_availableVIDEO: later moderation, or the owner, took the post out of public view
comment.updateCOMMENT: a comment or reply created, deleted, hidden, set to friends only or made public

সাবস্ক্রাইব করার আগে অ্যাপের কী লাগে?

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 বদলে যায়।

Subscribe the app to comment events
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 হওয়ার সমস্যা এড়ানো যায়।

Verify a TikTok webhook in Python
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_age

easyCoexistence-এর মাধ্যমে TikTok ইভেন্ট কীভাবে পাবেন?

অ্যাকাউন্টের জন্য একটি গন্তব্য দিয়ে। easyCoexistence তার নিজের অ্যাপ COMMENT-এ সাবস্ক্রাইব করে রাখে, TikTok-এর সাইনেচার যাচাই করে, সঙ্গে সঙ্গে TikTok-কে উত্তর দেয় এবং সংযুক্ত অ্যাকাউন্টের প্রতিটি comment.update সেই অ্যাকাউন্টের জন্য সেট করা HTTPS এন্ডপয়েন্টে POST করে। Claude বা ChatGPT থেকে set_social_webhook_destination নেয় account_id ও একটি url, থামাতে null দেয়, এবং একটি সাইনিং সিক্রেট ফেরত দেয় যা একবারই দেখানো হয়; আবার কল করলে নতুন একটি সিক্রেট ইস্যু হয়। প্রকাশের ইভেন্ট ফরওয়ার্ড করা হয় না: সেটির জন্য get_tiktok_publish_status পোস্ট অনুসরণ করে।

Set a destination through MCP
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 ফেরত দেয়।

Set a destination with the Partner API
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 appeasyCoexistence to your endpoint
HeaderTiktok-Signature: t=<unix>,s=<hex>X-EC-Signature: t=<unix>,v1=<hex>
KeyThe developer app's secretThe account's signing secret, shown once
EventsVIDEO and COMMENT, per appcomment.update, per connected account
Bodyclient_key, event, create_time, user_openid, content as a stringplatform, account_id, external_id, entry with content parsed
RetriesUp to 72 hoursNone: one attempt, 8 seconds, no redirects

কীভাবে সেট আপ করবেন

  1. Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
  2. Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
  3. Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
  4. Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
  5. 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/ কল সেটি বদলে দেয়।
EasyCoexistence দিয়ে এটি করা

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 বরং অ্যাকাউন্টের মন্তব্যের ইভেন্ট আপনার কাছে পাঠায়।

আরও পড়ুন

TikTok কমেন্টের ওয়েবহুক ইভেন্টTikTok-এর comment.update ওয়েবহুক কমেন্ট ও রিপ্লাই কীভাবে জানায়, প্রতিটি ইভেন্টে কী থাকে এবং সেগুলো কীভাবে আপনার এন্ডপয়েন্টে পৌঁছায়।TikTok API for Business-এর অ্যাক্সেস টোকেন: 24 ঘণ্টা, রিফ্রেশ ও প্রত্যাহারTikTok API for Business কীভাবে অ্যাকাউন্ট টোকেন দেয়: auth_code বিনিময়, 24 ঘণ্টার অ্যাক্সেস টোকেন, এক বছরের রিফ্রেশ টোকেন, নবায়ন ও প্রত্যাহার।TikTok API for Business-এর স্কোপ: প্রতিটি অনুমতি কী খুলে দেয়TikTok Accounts API-এর অনুমতি, TikTok-এর নিজের নামে: প্রতিটি কী খুলে দেয়, প্রতি ফিল্ডের টোকেন স্কোপ এবং টোকেন যাচাইয়ের উপায়।কীভাবে API-এর মাধ্যমে TikTok-এ ভিডিও পোস্ট করবেনAPI for Business দিয়ে TikTok-এ ভিডিও পোস্ট করুন: প্রকাশ এন্ডপয়েন্ট, JSON বডি, share_id এবং স্ট্যাটাস কল, curl ও Python-এ।API-এর মাধ্যমে TikTok মন্তব্যের উত্তর ও মডারেশনTikTok API for Business-এ মন্তব্য পড়া, উত্তর দেওয়া, লুকানো ও মুছে ফেলা যায়, এবং কীওয়ার্ড নিয়ম ও অটোমেশন নতুন মন্তব্যে নিজে থেকে উত্তর দেয়।কীভাবে API-র মাধ্যমে একটি TikTok পোস্টের প্রকাশের স্ট্যাটাস দেখবেনAPI-র মাধ্যমে প্রকাশিত TikTok পোস্ট অনুসরণ করুন: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE ও FAILED স্ট্যাটাস, পোস্ট ID ও ব্যর্থতার কারণ।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে