TikTok कमेंट वेबहुक इवेंट्स
TikTok का API for Business, खाते की फ़ोटो पोस्ट और सार्वजनिक वीडियो पर कमेंट या रिप्लाई बनने, मिटने, छिपने, सिर्फ़ दोस्तों के लिए सेट होने या सार्वजनिक होने के पाँच मिनट के भीतर comment.update वेबहुक भेजता है। हर इवेंट में कमेंट, पोस्ट, कार्रवाई, कमेंट करने वाले की पहचान और टेक्स्ट होता है, और वह Tiktok-Signature हेडर से साइन किया जाता है।
easyCoexistence हर TikTok कमेंट इवेंट को खाते के लिए आते ही आपके HTTPS एंडपॉइंट तक भेजता है, उस खाते के सीक्रेट से साइन करके और बिना कोई कॉपी रखे।
कमेंट या रिप्लाई बनने, मिटने या दृश्यता बदलने के बाद comment.update कितने समय के भीतर भेजा जाता है।
जब कॉलबैक HTTP 200 के साथ जवाब न दे, तो TikTok डिलीवरी कितने समय तक घातांकीय बैकऑफ़ के साथ दोबारा करने की कोशिश करता है।
comment.update इवेंट भेजे जाने के लिए खाते के पास दी गई और वैध बनी रहने वाली स्कोप।
TikTok का डिलीवरी वादा: एक ही इवेंट एक से ज़्यादा बार आ सकता है, इसलिए हैंडलिंग इडेम्पोटेंट होनी चाहिए।
comment.update क्या रिपोर्ट करता है?
खाते की फ़ोटो पोस्ट और सार्वजनिक वीडियो पोस्ट पर कमेंट में हुए बदलाव, चाहे वे एपीआई से प्रकाशित हुए हों या 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 वेबहुक डेवलपर ऐप को भेजता है, पूरे ऐप के लिए एक कॉलबैक यूआरएल के जरिए। easyCoexistence इन्हें प्राप्त करता है और जुड़े हुए खाते का हर comment.update, उसके लिए सेट किए गए HTTPS एंडपॉइंट तक, एक बार, आते ही, उस खाते के अपने सीक्रेट से साइन करके भेजता है। एंडपॉइंट को Claude या ChatGPT से set_social_webhook_destination से, या पार्टनर एपीआई से PUT /channels/:id/webhook के जरिए सेट करें; सीक्रेट एक बार दिखाया जाता है, और null यूआरएल फ़ॉरवर्डिंग बंद कर देता है।
आगे भेजा गया इवेंट कैसा दिखता है?
एक POST जिसमें platform, account_id (जो list_social_accounts कनेक्शन को देता है), खाते का 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 साथ मिलाकर डुप्लिकेट हटाएँ।
आम गड़बड़ियाँ
- IDs को नंबर मानकर पार्स करना। comment_id और video_id, double में ठीक-ठीक समाने से बड़े हैं; easyCoexistence इन्हें स्ट्रिंग के रूप में आगे भेजता है, इसलिए इन्हें वैसा ही रखें।
- पार्स की हुई बॉडी की कॉपी पर सिग्नेचर की गणना करना। HMAC उस रॉ बॉडी पर होता है जैसी वह डिलीवर हुई, और उसे दोबारा सीरियलाइज़ करने से मिलान टूट जाता है।
- एक ही इवेंट को दो बार हैंडल करना। TikTok कम से कम एक बार डिलीवर करता है, इसलिए कार्रवाई से पहले comment_id और comment_action के आधार पर पहचानें।
- डेस्टिनेशन ऐसे पते पर सेट करना जो रीडायरेक्ट करता है। फ़ॉरवर्डिंग रीडायरेक्ट को फ़ॉलो नहीं करती, इसलिए अंतिम HTTPS यूआरएल दें।
Claude या ChatGPT से set_social_webhook_destination से, या पार्टनर एपीआई से चालू करें। प्रति कनेक्शन प्रति माह 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 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित