TikTok কমেন্টের ওয়েবহুক ইভেন্ট
TikTok-এর ব্যবসার জন্য API পাঁচ মিনিটের মধ্যে comment.update ওয়েবহুক পাঠায়, যখন কোনো অ্যাকাউন্টের ফটো পোস্ট ও পাবলিক ভিডিওতে কমেন্ট বা রিপ্লাই তৈরি, মুছে ফেলা, লুকানো, শুধু বন্ধুদের জন্য সেট বা সবার জন্য প্রকাশ করা হয়। প্রতিটি ইভেন্টে কমেন্ট, পোস্ট, অ্যাকশন, কমেন্টকারীর শনাক্তকারী ও লেখা থাকে এবং Tiktok-Signature হেডার দিয়ে সাইন করা হয়।
easyCoexistence অ্যাকাউন্টের প্রতিটি TikTok কমেন্ট ইভেন্ট আসামাত্র আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে, সেই অ্যাকাউন্টের জন্য আলাদা সিক্রেট দিয়ে সাইন করে এবং কোনো কপি রাখে না।
comment.update কমেন্ট বা রিপ্লাই তৈরি, মুছে ফেলা বা দৃশ্যমানতা বদলানোর কত সময়ের মধ্যে ফায়ার করে।
যে ডেলিভারির কলব্যাক HTTP 200 দিয়ে উত্তর দেয়নি, TikTok সেটি কতক্ষণ ধরে আবার চেষ্টা করে, বিরতি ক্রমশ বাড়তে বাড়তে।
comment.update পাঠানোর জন্য অ্যাকাউন্টকে যে স্কোপ দিতে হয় এবং বৈধ রাখতে হয়।
TikTok-এর ডেলিভারি প্রতিশ্রুতি: একই ইভেন্ট একাধিকবার আসতে পারে, তাই হ্যান্ডলিং ইডেমপোটেন্ট হওয়া উচিত।
comment.update কী জানায়?
অ্যাকাউন্টের ফটো পোস্ট ও পাবলিক ভিডিও পোস্টের কমেন্টে পরিবর্তন, সেগুলো API দিয়ে প্রকাশ হোক বা TikTok অ্যাপে। comment_action বলে কী ঘটেছে:
- insert: একটি কমেন্ট বা রিপ্লাই তৈরি হয়েছে।
- delete: সেটি মুছে ফেলা হয়েছে।
set_to_hidden: সেটি লুকানো হয়েছে, কোনো ব্যবহারকারীর দ্বারা বা মডারেশনের মাধ্যমে।set_to_friends_only: সেটি শুধু বন্ধুদের জন্য দৃশ্যমান করা হয়েছে।set_to_public: সেটি লুকানো বা শুধু বন্ধুদের জন্য থাকা অবস্থা থেকে সবার জন্য দৃশ্যমান হয়েছে।
একটি ইভেন্টে কী থাকে?
TikTok JSON পাঠায়, যাতে থাকে client_key, event, create_time, user_openid (অ্যাকাউন্টের ID) এবং content, যা একটি সিরিয়ালাইজড JSON স্ট্রিং। content-এর ভেতরে থাকে comment_id ও video_id, রিপ্লাই হলে parent_comment_id, comment_type (comment বা reply), comment_action, একটি টাইমস্ট্যাম্প, কমেন্টকারীর unique_identifier এবং লেখা। ID-গুলো এত বড় JSON সংখ্যা যে double টাইপে সঠিকভাবে ধরে না, তাই কাঁচা স্ট্রিং থেকে পড়ুন।
ইভেন্ট আপনার এন্ডপয়েন্টে কীভাবে পৌঁছায়?
TikTok ওয়েবহুক পাঠায় ডেভেলপার অ্যাপে, পুরো অ্যাপের জন্য একটিমাত্র কলব্যাক URL দিয়ে। easyCoexistence এগুলো গ্রহণ করে এবং সংযুক্ত অ্যাকাউন্টের প্রতিটি comment.update সেই অ্যাকাউন্টের নিজস্ব সিক্রেট দিয়ে সাইন করে, আপনার সেট করা HTTPS এন্ডপয়েন্টে একবার পাঠায়, যেমন এসেছে তেমনই। এন্ডপয়েন্ট সেট করুন Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা PUT /channels/:id/webhook-এর মাধ্যমে Partner API দিয়ে। সিক্রেট একবারই দেখানো হয়, আর URL null হলে ফরওয়ার্ডিং বন্ধ হয়ে যায়।
একটি ফরওয়ার্ড করা ইভেন্ট কেমন দেখায়?
একটি POST, যাতে থাকে platform, list_social_accounts যে সংযোগের account_id দেয় সেটি, অ্যাকাউন্টের external_id (TikTok-এর open_id), এবং entry: ইভেন্টের নাম, create_time ও content। content আগেই পার্স করা এবং এর ID-গুলো স্ট্রিং-এ রূপান্তরিত, যাতে কোনোটিই রাউন্ড না হয়।
{
"platform": "tiktok",
"account_id": "<ACCOUNT_ID>",
"external_id": "<TIKTOK_OPEN_ID>",
"entry": {
"event": "comment.update",
"create_time": 1793318400,
"content": {
"comment_id": "<COMMENT_ID>",
"video_id": "<VIDEO_ID>",
"parent_comment_id": null,
"comment_type": "comment",
"comment_action": "insert",
"timestamp": 1793318399000,
"unique_identifier": "<UNIQUE_IDENTIFIER>",
"text": "<COMMENT_TEXT>"
}
}
}একটি ফরওয়ার্ড করা ইভেন্ট কীভাবে যাচাই করবেন?
প্রতিটি ফরওয়ার্ড করা ডেলিভারিতে থাকে X-EC-Signature হেডার, t=<unix>,v1=<hex>, যেখানে v1 হলো টাইমস্ট্যাম্প, একটি ডট ও কাঁচা বডির HMAC-SHA256, যার কী অ্যাকাউন্টের সাইনিং সিক্রেট। বডি যেমন এসেছে ঠিক তেমনভাবে আবার হিসাব করুন, দুটি মান constant time-এ তুলনা করুন, এবং 5 মিনিটের বেশি পুরোনো টাইমস্ট্যাম্প প্রত্যাখ্যান করুন।
একটি ইভেন্ট কি আবার চেষ্টা করা হয়?
easyCoexistence করে না। প্রতিটি ইভেন্ট একবার, মেমোরিতে, এবং আবার চেষ্টার জন্য কোনো কপি না রেখে ফরওয়ার্ড করা হয়। ফরওয়ার্ড 8 সেকেন্ড উত্তরের জন্য অপেক্ষা করে এবং রিডাইরেক্ট অনুসরণ করে না। উৎস পর্যায়ে TikTok নিজের ডেলিভারি সর্বোচ্চ 72 ঘণ্টা পর্যন্ত আবার চেষ্টা করে এবং অন্তত একবার পৌঁছানোর প্রতিশ্রুতি দেয়, তাই একই ইভেন্ট আপনার কাছে দুবার আসতে পারে। comment_id ও comment_action একসঙ্গে ধরে ডুপ্লিকেট বাদ দিন।
সাধারণ ভুলগুলো
- ID-কে সংখ্যা হিসেবে পার্স করা। comment_id ও video_id, double যতটা সঠিকভাবে ধরে তার চেয়ে বড়। easyCoexistence এগুলো স্ট্রিং হিসেবে ফরওয়ার্ড করে, তাই সেভাবেই রাখুন।
- পার্স করা কপির ওপর সিগনেচার হিসাব করা। HMAC কাঁচা বডি যেমন এসেছে তার ওপর হিসাব হয়; আবার সিরিয়ালাইজ করলে মিল ভেঙে যায়।
- একটি পুনরাবৃত্ত ইভেন্ট দুবার হ্যান্ডল করা। TikTok অন্তত একবার ডেলিভারি করে, তাই কোনো কাজ করার আগে comment_id ও comment_action দিয়ে চিহ্নিত করুন।
- এমন ঠিকানায় ডেস্টিনেশন দেওয়া যা রিডাইরেক্ট করে। ফরওয়ার্ড রিডাইরেক্ট অনুসরণ করে না, তাই চূড়ান্ত HTTPS URL দিন।
Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা Partner API দিয়ে চালু করুন। প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন বিনামূল্যে।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন TikTok ওয়েবহুক ইভেন্ট ফরওয়ার্ড করা হয়?
comment.update, সংযুক্ত অ্যাকাউন্টের পোস্টে কমেন্ট ও রিপ্লাইয়ের জন্য: তৈরি, মুছে ফেলা, লুকানো, শুধু বন্ধুদের জন্য সেট বা সবার জন্য প্রকাশ।
TikTok প্রকাশনার ইভেন্টও কি ফরওয়ার্ড হয়?
না। ফরওয়ার্ডিং কমেন্ট ইভেন্ট বহন করে; বদলে কোনো পোস্টের প্রকাশনা অনুসরণ করতে get_tiktok_publish_status ব্যবহার করুন।
একটি TikTok কমেন্ট ইভেন্ট কত দ্রুত পৌঁছায়?
TikTok পরিবর্তনের পাঁচ মিনিটের মধ্যে comment.update পাঠায়, আর easyCoexistence সেটি আসামাত্র এগিয়ে দেয়।
একটি TikTok কমেন্ট ইভেন্টে কি লেখা থাকে?
TikTok নথিভুক্ত করে যে ইভেন্টের content-এ একটি text ফিল্ড থাকে, কমেন্ট ও পোস্টের ID, অ্যাকশন এবং কমেন্টকারীর unique_identifier-এর পাশে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে