TikTok వ్యాపార API వెబ్హుక్ల సెటప్
TikTok యొక్క వ్యాపార API ఒక్కో డెవలపర్ యాప్ మరియు ఈవెంట్ రకానికి ఒక కాల్బ్యాక్ URL కు వెబ్హుక్లను పంపుతుంది. దీన్ని యాప్ యొక్క 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 లో పేర్కొనగల గరిష్ట పోస్ట్ IDలు, comment.update ఈవెంట్లను నిర్దిష్ట పోస్ట్లకు పరిమితం చేయడానికి.
TikTok ప్రతి డెలివరీతో పంపే webhook-schema-version హెడర్ యొక్క ప్రస్తుత విలువ.
webhook కాన్ఫిగరేషన్ ఎండ్పాయింట్ల కోసం TikTok రిఫరెన్స్ జాబితా చేసేవి, ఇవి app ID మరియు సీక్రెట్తో ధృవీకరించబడతాయి.
Tiktok-Signature వెనుక అల్గోరిథం: టైమ్స్టాంప్, చుక్క, బాడీ, యాప్ సీక్రెట్తో కీ చేసి హెక్స్-ఎన్కోడ్ చేయబడినవి.
comment.update కోసం TikTok Accounts కింద అవసరమైన యాప్ అనుమతి; ప్రచురణ ఈవెంట్లకు Business Content కావాలి.
ఏ వెబ్హుక్ ఈవెంట్లను TikTok ఖాతా యాప్ స్వీకరించగలదు?
రెండు వర్గాలు, ప్రతిదీ దాని స్వంత event_type గా సబ్స్క్రైబ్ అవుతుంది. VIDEO అనేది /business/video/publish/ లేదా /business/photo/publish/ ద్వారా ప్రచురించిన పోస్ట్లను కవర్ చేస్తుంది. COMMENT అనేది ఖాతా యొక్క ఫోటో పోస్ట్లు మరియు పబ్లిక్ వీడియో పోస్ట్లపై కామెంట్లను కవర్ చేస్తుంది, అవి API ద్వారా లేదా TikTok యాప్లో ప్రచురించినా సరే:
సబ్స్క్రైబ్ చేయడానికి ముందు యాప్కు ఏమి కావాలి?
వ్యాపార API కు యాక్సెస్, ఒక డెవలపర్ యాప్, మరియు దానికి అధికారం ఇచ్చిన TikTok ఖాతాలు. TikTok యొక్క సబ్స్క్రిప్షన్ గైడ్ ప్రతి వర్గానికి ఒక అనుమతిని జోడిస్తుంది, మరియు కామెంట్ ఈవెంట్కు ప్రతి యజమాని నుండి ఒక స్కోప్ అవసరం:
- పబ్లిషింగ్ ఈవెంట్లు: యాప్పై TikTok Accounts, Business Content అనుమతి.
- కామెంట్ ఈవెంట్లు: యాప్పై TikTok Accounts, Business Comment అనుమతి.
- comment.update: యజమాని మంజూరు చేసి చెల్లుబాటులో ఉంచిన comment.list స్కోప్.
- HTTPS పై ఒక కాల్బ్యాక్ URL, ఇది వెంటనే 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 కు మళ్లీ కాల్ చేస్తే callback URL మారుతుంది.
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 రకానికి ఒకటి ఉన్నప్పుడు మాత్రమే కనిపిస్తుంది, item_list సెట్ చేసినప్పుడు మాత్రమే కనిపిస్తుంది. app_id, secret, event_type తో POST /business/webhook/delete/ దాన్ని తొలగిస్తుంది. COMMENT కోసం, డిలీట్ కాల్లో item_list ఉంటే ఆ పోస్ట్లు మాత్రమే తొలగిపోతాయి. లేకపోతే అన్ని పోస్ట్లకు కామెంట్ ఈవెంట్లు ఆగిపోతాయి.
కాల్బ్యాక్ URL ఏమి చేయాలి?
వెంటనే స్పందించాలి. 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. ..."
}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 తిరిగి వస్తాయి.
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 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 తో: TikTok ఫైల్ను డౌన్లోడ్ చేసి తనిఖీ చేసిన తర్వాత post.publish.complete, ఆ తర్వాత పోస్ట్ పబ్లిక్ అయినప్పుడు post_id తో post.publish.publicly_available.
TikTok విఫలమైన వెబ్హుక్ను ఎంతసేపు మళ్లీ ప్రయత్నిస్తుంది?
ఘాతాంక బ్యాక్ఆఫ్తో 72 గంటల వరకు, ఆ తర్వాత ఈవెంట్ తొలగించబడుతుంది. డెలివరీ కనీసం ఒకసారి జరుగుతుంది, కాబట్టి నకిలీలను ఆశించండి.
easyCoexistence యొక్క TikTok యాప్పై నా స్వంత కాల్బ్యాక్ను నమోదు చేయగలనా?
లేదు. యాప్ వెబ్హుక్ సెట్టింగ్లు easyCoexistence వద్దే ఉంటాయి. బదులుగా set_social_webhook_destination ఖాతా యొక్క కామెంట్ ఈవెంట్లను మీకు పంపుతుంది.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ