लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

TikTok API for Business चे वेबहुक सेट करणे

TikTok चा API for Business प्रत्येक डेव्हलपर ॲप आणि इव्हेंट प्रकारासाठी एका कॉलबॅक यूआरएलवर वेबहुक पाठवतो. ते POST /business/webhook/update/ द्वारे ॲपचे app_id आणि सिक्रेट वापरून सेट होते. event_type VIDEO चार पोस्ट-प्रकाशन इव्हेंट सबस्क्राइब करतो, तर COMMENT comment.update सबस्क्राइब करतो. प्रत्येक डिलिव्हरी HTTPS POST असते, जी Tiktok-Signature हेडरमध्ये ॲपच्या सिक्रेटसह HMAC-SHA256 वापरून सही केलेली असते.

easyCoexistence TikTok ची कमेंट वेबहुक आपल्या ॲपसाठी सबस्क्राइब ठेवते, TikTok ची सही तपासते आणि तुमच्या खात्याचा प्रत्येक कमेंट इव्हेंट तुमच्या HTTPS एंडपॉइंटकडे पाठवते, स्वतःच्या सिक्रेटसह सही करून.

72 hours

HTTP 200 ने उत्तर न दिलेली डिलिव्हरी TikTok टाकून देण्यापूर्वी किती वेळ, घातांकी बॅकऑफने, पुन्हा पाठवत राहतो.

100

एक item_list जास्तीत जास्त किती पोस्ट ID नमूद करू शकते, जेणेकरून comment.update इव्हेंट ठराविक पोस्टपुरते मर्यादित राहतील.

v1.0

प्रत्येक डिलिव्हरीसोबत TikTok पाठवणाऱ्या webhook-schema-version हेडरची सध्याची किंमत.

No permission

वेबहुक कॉन्फिगरेशन एंडपॉइंटसाठी TikTok च्या संदर्भात काय नमूद आहे, जे ॲप ID आणि सिक्रेटने प्रमाणीकरण करतात.

HMAC-SHA256

Tiktok-Signature मागील अल्गोरिदम: टाइमस्टॅम्प, ठिपका आणि बॉडी, ॲपच्या सिक्रेटसह की केलेले आणि हेक्स-एन्कोड केलेले.

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 आणि सिक्रेट, 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 इव्हेंट कसे मर्यादित करते?

ते comment.update ला नमूद केलेल्या पोस्टपुरते मर्यादित करते, /business/video/list/ मधील 100 ID पर्यंत, आणि पहिली यादी त्यानंतरसाठी ॲपचा मोड ठरवते:

  • item_list असलेला पहिला COMMENT कॉल: इव्हेंट फक्त यादी केलेल्या पोस्टसाठी येतात.
  • item_list असलेले नंतरचे कॉल: नवीन पोस्ट आधीपासून यादीत असलेल्यांमध्ये जोडल्या जातात.
  • item_list नसलेला COMMENT कॉल, आधी काहीच सेट नसल्यास: इव्हेंट ॲप अधिकृत केलेल्या खात्यांच्या पोस्टसाठी येतात.
  • item_list नसलेला COMMENT कॉल, यादी अस्तित्वात असल्यावर: कॉन्फिगर केलेल्या पोस्ट जशा आहेत तशाच राहतात.

सबस्क्रिप्शन कसे तपासायचे किंवा काढायचे?

app_id, सिक्रेट आणि event_type सह GET /business/webhook/list/ कॉन्फिगरेशन परत करते: callback_url फक्त त्या इव्हेंट प्रकारासाठी एक असल्यास दिसतो, आणि item_list फक्त सेट केली असल्यास. app_id, सिक्रेट आणि 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_ की, आणि {"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 वेबहुकवर ॲप सिक्रेटने सही करतो, तोच जो /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 चे टोकन कसे मिळतात, ते 24 तास वैध असतात, रिफ्रेश टोकन एक वर्ष आणि त्यांचे नूतनीकरण व रद्द करणे.TikTok व्यवसाय API चे स्कोप्स: प्रत्येक परवानगी काय उघडतेTikTok Accounts API साठी परवानग्या, TikTok च्या स्वतःच्या नावांनी: प्रत्येकामुळे काय उघडते, फील्डनिहाय टोकन स्कोप्स आणि टोकन कसे तपासायचे.एपीआयद्वारे TikTok वर व्हिडिओ कसा पोस्ट करायचाTikTok व्यवसाय एपीआयद्वारे व्हिडिओ पोस्ट करा: पब्लिश एंडपॉइंट, JSON बॉडी, share_id आणि स्टेटस कॉल, curl व Python मध्ये.टिकटॉक कमेंटवर एपीआयद्वारे उत्तर, लपवणे आणि मॉडरेशनटिकटॉक एपीआय कमेंट वाचते, त्यांना उत्तर देते, लपवते व हटवते. कीवर्ड नियम आणि ऑटोमेशन नवीन कमेंटना स्वतः उत्तर देतात.एपीआय द्वारे TikTok पोस्टचे प्रकाशन स्टेटस कसे तपासावेएपीआय द्वारे प्रकाशित केलेली TikTok पोस्ट कशी तपासायची: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE आणि FAILED, पोस्ट आयडी आणि अपयशाची कारणे.

तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.

कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.

  • 3 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: