लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

TikTok API for Business के वेबहुक सेट करना

TikTok का API for Business हर डेवलपर ऐप और इवेंट टाइप के लिए एक कॉलबैक यूआरएल पर वेबहुक भेजता है, जिसे app_id और secret के साथ POST /business/webhook/update/ से सेट किया जाता है। event_type VIDEO पोस्ट प्रकाशन के चार इवेंट पर सब्सक्राइब करता है, और COMMENT comment.update पर। हर डिलीवरी एक HTTPS POST होती है, जो Tiktok-Signature हेडर में ऐप सीक्रेट से बनी HMAC-SHA256 सिग्नेचर के साथ आती है।

easyCoexistence आपके ऐप के लिए TikTok का कमेंट वेबहुक सब्सक्राइब रखता है, TikTok के सिग्नेचर की जाँच करता है और आपके खाते का हर कमेंट इवेंट आपके HTTPS एंडपॉइंट तक पहुँचाता है, जिस पर उसका अपना सीक्रेट होता है।

72 hours

TikTok उस डिलीवरी को कितने समय तक घातांकीय बैकऑफ़ के साथ दोबारा भेजता है जिसका HTTP 200 से जवाब नहीं आया, फिर उसे हटा देता है।

100

एक item_list में अधिकतम कितनी पोस्ट ID दी जा सकती हैं, ताकि comment.update इवेंट कुछ खास पोस्ट तक सीमित रहें।

v1.0

हर डिलीवरी के साथ TikTok जो webhook-schema-version हेडर भेजता है, उसका वर्तमान मान।

No permission

TikTok के रेफ़रंस में वेबहुक कॉन्फ़िगरेशन एंडपॉइंट की सूची, जो ऐप ID और सीक्रेट से प्रमाणीकरण करते हैं।

HMAC-SHA256

Tiktok-Signature का एल्गोरिदम: टाइमस्टैम्प, एक डॉट और बॉडी, जिस पर ऐप सीक्रेट से HMAC की गणना होती है और परिणाम हेक्स में एन्कोड होता है।

Business Comment

comment.update के लिए TikTok Accounts के अंतर्गत आवश्यक ऐप अनुमति; पब्लिशिंग इवेंट के लिए 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 पर एक कॉलबैक यूआरएल, जो तुरंत 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 के लिए दोबारा कॉल करने पर कॉलबैक यूआरएल बदल जाता है।

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.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 तभी दिखता है जब उस event type के लिए एक मौजूद हो, और item_list तभी जब उसे सेट किया गया हो। app_id, secret और event_type के साथ POST /business/webhook/delete/ उसे हटाता है; COMMENT के लिए, delete कॉल में item_list केवल उन पोस्ट को हटाती है, और उसके बिना कमेंट इवेंट सभी पोस्ट के लिए बंद हो जाते हैं।

कॉलबैक यूआरएल को क्या करना होता है?

तुरंत जवाब देना। 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, जो एक सीरियलाइज़्ड JSON स्ट्रिंग है।

Tiktok-Signature कैसे सत्यापित करें?

हेडर को पहले कॉमा पर, फिर बराबर के चिह्न पर बाँटें: t=<unix>,s=<hex>। t मान, एक डॉट और अनुरोध की बॉडी से हस्ताक्षरित संदेश बनाएँ, उस पर ऐप सीक्रेट से HMAC-SHA256 की गणना करें, उसे हेक्स में एन्कोड करें और s से तुलना करें। फिर t कितना पुराना है, यह जाँचें: TikTok रीप्ले रोकने के लिए डिलीवरी का समय साइन करता है, और उसका नमूना 5 सेकंड की देरी स्वीकार करता है। प्राप्त कच्ची बॉडी से काम करने पर JSON को अलग तरीके से दोबारा सीरियलाइज़ करने की समस्या नहीं आती।

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_ key को बेयरर टोकन के रूप में, और बॉडी {"url": "https://..."} के साथ। जवाब में webhook_url, signing_secret और एक नोट होता है, और {"url": null} भेजने पर फ़ॉरवर्डिंग रुक जाती है। यूआरएल को सार्वजनिक होस्ट पर 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 वेबहुक ऐप सीक्रेट से साइन करता है, वही जो /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 पर वीडियो कैसे पोस्ट करेंबिज़नेस एपीआई से TikTok पर वीडियो पोस्ट करें: पब्लिश एंडपॉइंट, उसकी JSON बॉडी, लौटने वाला share_id और स्टेटस कॉल, curl और Python में।API के ज़रिए TikTok कमेंट के जवाब और मॉडरेशनTikTok के API for Business से कमेंट पढ़ना, जवाब देना, छिपाना और डिलीट करना, और कीवर्ड नियम व ऑटोमेशन से नए कमेंट पर अपने आप जवाब देना।TikTok एपीआई से पोस्ट का पब्लिश स्टेटस कैसे जांचेंएपीआई से TikTok पर प्रकाशित पोस्ट को ट्रैक करें: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, पोस्ट ID और गड़बड़ी के कारण।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित