TikTok व्यवसायका लागि एपीआई वेबहुक सेटअप गर्ने तरिका
TikTok व्यवसाय एपीआईले प्रत्येक डेभलपर एप र इभेन्ट प्रकारका लागि एउटा कलब्याक यूआरएलमा वेबहुक पठाउँछ। यो एपको app_id र सिक्रेटसँग POST /business/webhook/update/ मार्फत सेट गरिन्छ। event_type VIDEO ले पोस्ट प्रकाशनका चार इभेन्टमा सदस्यता लिन्छ, र COMMENT ले comment.update मा। प्रत्येक डेलिभरी HTTPS POST हो, जुन Tiktok-Signature हेडरमा HMAC-SHA256 सँग हस्ताक्षरित हुन्छ, जसको कुञ्जी एपको सिक्रेट हो।
easyCoexistence ले तपाईंको एपका लागि TikTok को कमेन्ट वेबहुक सदस्यता लिएर राख्छ, TikTok को हस्ताक्षर जाँच गर्छ, र तपाईंको खाताको प्रत्येक कमेन्ट इभेन्ट आफ्नै सिक्रेटले हस्ताक्षरित गरेर तपाईंको HTTPS एन्डपोइन्टमा पठाउँछ।
TikTokले HTTP 200 नपाएको डेलिभरी कति समयसम्म घातीय ब्याकअफसँग पुनः प्रयास गर्छ, र त्यसपछि त्यसलाई हटाउँछ।
एउटा item_list ले comment.update इभेन्टलाई विशेष पोस्टमा सीमित गर्न अधिकतम कति पोस्ट ID नाम दिन सक्छ।
TikTokले प्रत्येक डेलिभरीसँग पठाउने webhook-schema-version हेडरको हालको मान।
TikTokको सन्दर्भ सूचीले वेबहुक कन्फिगरेसन एन्डपोइन्टका लागि के सूचीबद्ध गर्छ, जसले एप ID र सिक्रेटसँग प्रमाणीकरण गर्छन्।
Tiktok-Signature पछाडिको एल्गोरिदम: टाइमस्ट्याम्प, डट र बडी, एपको सिक्रेटले कुञ्जी बनाइएको र हेक्स-इन्कोड गरिएको।
comment.update का लागि TikTok Accounts अन्तर्गत आवश्यक एप अनुमति; प्रकाशन इभेन्टका लागि Business Content चाहिन्छ।
कुन वेबहुक इभेन्ट TikTok खाताको एपले प्राप्त गर्न सक्छ?
दुई वर्ग, प्रत्येकलाई आफ्नै event_type को रूपमा सदस्यता दिइन्छ। VIDEO ले /business/video/publish/ वा /business/photo/publish/ मार्फत प्रकाशित पोस्ट समेट्छ, र COMMENT ले खाताका फोटो पोस्ट र सार्वजनिक भिडियो पोस्टका कमेन्टहरू समेट्छ, चाहे ती एपीआई मार्फत प्रकाशित भएका होऊन् वा TikTok एपमा:
सदस्यता लिनुअघि एपलाई के चाहिन्छ?
TikTok व्यवसाय एपीआईमा पहुँच, एक डेभलपर एप, र त्यसलाई अधिकार दिने TikTok खाताहरू। TikTok को सदस्यता गाइडले प्रत्येक वर्गका लागि अनुमति थप्छ, र कमेन्ट इभेन्टलाई प्रत्येक मालिकबाट एउटा स्कोप चाहिन्छ:
- प्रकाशन इभेन्टहरू: एपमा TikTok Accounts को व्यवसाय Content अनुमति।
- कमेन्ट इभेन्टहरू: एपमा TikTok Accounts को व्यवसाय 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 का लागि फेरि अनुरोध गर्दा कलब्याक यूआरएल बदलिन्छ।
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 सम्म, र पहिलो सूचीले त्यसपछि एपको मोड तय गर्छ:
- पहिलो COMMENT अनुरोध
item_listसहित: इभेन्टहरू सूचीबद्ध पोस्टका लागि मात्र आउँछन्। - पछिल्ला
item_listसहितका अनुरोधहरू: नयाँ पोस्टहरू पहिले सूचीबद्ध भइसकेकाहरूमा थपिन्छन्। item_listबिना COMMENT अनुरोध, पहिले कुनै सेट नभएको: इभेन्टहरू एपलाई अधिकार दिने खाताका पोस्टका लागि आउँछन्।item_listबिना COMMENT अनुरोध, सूची विद्यमान भएपछि: कन्फिगर गरिएका पोस्टहरू जस्ताका तस्तै रहन्छन्।
सदस्यता कसरी जाँच्ने वा हटाउने?
app_id, secret र event_type सहित GET /business/webhook/list/ ले कन्फिगरेसन फर्काउँछ: callback_url त्यो इभेन्ट प्रकारका लागि अस्तित्वमा भएमात्र देखिन्छ, र 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 फरक तरिकाले पुनः सिरियलाइज हुने समस्या हुँदैन।
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_ageeasyCoexistence मार्फत TikTok इभेन्ट कसरी प्राप्त गर्ने?
खातालाई गन्तव्य दिएर। easyCoexistence ले आफ्नै एपलाई COMMENT मा सदस्यता दिएर राख्छ, TikTok को हस्ताक्षर जाँच गर्छ, TikTok लाई तुरुन्तै जवाफ दिन्छ, र जडान गरिएको खाताका प्रत्येक comment.update लाई खाताका लागि सेट गरिएको HTTPS एन्डपोइन्टमा POST गर्छ। Claude वा ChatGPT बाट, set_social_webhook_destination ले account_id र url लिन्छ, वा रोक्न null, र एउटा हस्ताक्षर सिक्रेट फर्काउँछ जुन एक पटक मात्र देखाइन्छ; यसलाई फेरि अनुरोध गर्दा नयाँ सिक्रेट जारी हुन्छ। प्रकाशन इभेन्ट अगाडि पठाइँदैन: त्यसको सट्टा get_tiktok_publish_status ले पोस्टलाई पछ्याउँछ।
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. ..."
}पार्टनर एपीआईले कसरी सेट गर्ने?
https://easycoexistence.com/api/v1 मा PUT /channels/{id}/webhook, bearer टोकनका रूपमा तपाईंको ec_live_ कुञ्जी, र {"url": "https://..."} बडी। प्रतिक्रियामा webhook_url, signing_secret र note हुन्छन्, र {"url": null} ले फर्वार्डिङ रोक्छ। URL ले सार्वजनिक होस्टमा HTTPS प्रयोग गर्नुपर्छ; अज्ञात च्यानलले 404 not_found, हटाइएकोले 409 removed, र निलम्बन गरिएकोले 402 suspended फर्काउँछ।
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 पार्स गरिएको र आईडीहरू स्ट्रिङका रूपमा; फरक के हुन्छ भने हरेक डेलिभरी कसरी हस्ताक्षरित, दायरा तोकिएको र पुनः प्रयास गरिएको:
| TikTok to your app | easyCoexistence to your endpoint | |
|---|---|---|
| Header | Tiktok-Signature: t=<unix>,s=<hex> | X-EC-Signature: t=<unix>,v1=<hex> |
| Key | The developer app's secret | The account's signing secret, shown once |
| Events | VIDEO and COMMENT, per app | comment.update, per connected account |
| Body | client_key, event, create_time, user_openid, content as a string | platform, account_id, external_id, entry with content parsed |
| Retries | Up to 72 hours | None: one attempt, 8 seconds, no redirects |
यसलाई कसरी सेट अप गर्ने
- Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
- Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
- Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
- Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
- 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/ अनुरोधले त्यो बदल्छ।
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 सहित: post.publish.complete, TikTok ले फाइल डाउनलोड र जाँच गरिसकेपछि, र त्यसपछि post.publish.publicly_available, post_id सहित, पोस्ट सार्वजनिक भएपछि।
TikTok ले असफल वेबहुक कति समय पुनः प्रयास गर्छ?
72 घण्टासम्म घातीय ब्याकअफसहित, त्यसपछि इभेन्ट हटाइन्छ। डेलिभरी कम्तीमा एक पटक हुन्छ, त्यसैले दोहोरिने डेलिभरीका लागि तयार रहनुहोस्।
के म easyCoexistence को TikTok एपमा आफ्नै कलब्याक दर्ता गर्न सक्छु?
सकिँदैन। एपका वेबहुक सेटिङ easyCoexistence कै अधीनमा रहन्छन्। set_social_webhook_destination ले खाताका कमेन्ट इभेन्ट त्यसको सट्टा तपाईंलाई पठाउँछ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको