TikTok API for Business webhooks සැකසීම
TikTok හි API for Business විසින් webhook එක යවන්නේ එක් developer යෙදුමකට සහ event type එකකට එක callback URL එකකටය. ඒ URL එක POST /business/webhook/update/ මගින් සකසයි, එහි යෙදුමේ app_id සහ secret භාවිතා වේ. event_type VIDEO මගින් පළ කිරීමේ events හතරට, COMMENT මගින් comment.update වලට subscribe වේ. සෑම delivery එකක්ම HTTPS POST එකක් වන අතර, එය Tiktok-Signature header එකේ HMAC-SHA256 මගින් signed වන්නේ යෙදුමේ secret එකෙනි.
easyCoexistence TikTok comment webhook එක තමන්ගේ යෙදුම සඳහා subscribe කර තබා ගන්නා අතර, TikTok signature පරීක්ෂා කර, ඔබේ ගිණුමේ සෑම comment event එකක්ම ඔබේ HTTPS endpoint එකට, තමන්ගේම secret එකකින් signed කර, යවයි.
HTTP 200 ලැබෙන්නේ නැති delivery එකක් TikTok විසින් ඉවත දැමීමට පෙර කොපමණ කාලයක් retry කරන්නේද, exponential backoff සමඟ.
එක් item_list එකකට නම් කළ හැකි වැඩිම post ID ගණන, comment.update events නිශ්චිත posts වලට සීමා කිරීමට.
TikTok සෑම delivery එකක් සමඟම යවන webhook-schema-version header එකේ වත්මන් අගය.
webhook configuration endpoints සඳහා TikTok යොමුවෙහි ලැයිස්තු කර ඇති දේ, app ID සහ secret සමඟ සත්යාපනය වන.
Tiktok-Signature හි ඇල්ගොරිතමය: timestamp, තිතක්, සහ body, යෙදුමේ secret මගින් key කර, hex-encode කළ.
comment.update සඳහා TikTok Accounts යටතේ අවශ්ය යෙදුම් අවසරය; පළ කිරීමේ events සඳහා Business Content අවශ්යයි.
TikTok ගිණුම් යෙදුමකට කුමන webhook events ලැබිය හැකිද?
කාණ්ඩ දෙකක්, එකක් එක් event_type එකක් ලෙස subscribe වේ. VIDEO ආවරණය කරන්නේ /business/video/publish/ හෝ /business/photo/publish/ හරහා පළ කළ posts ය. COMMENT ආවරණය කරන්නේ ගිණුමේ photo posts සහ public video posts මත comments ය, ඒවා API හරහා හෝ TikTok app එකෙන් පළ කර තිබුණත්:
subscribe කිරීමට පෙර යෙදුමට කුමක් අවශ්යද?
API for Business වෙත ප්රවේශය, developer යෙදුමක් සහ එය අනුමත කළ TikTok ගිණුම්. TikTok දායකත්ව මාර්ගෝපදේශයට සෑම කාණ්ඩයක් සඳහාම අවසරයක් එකතු වන අතර, comment event සඳහා එක් එක් owner ගෙන් scope එකක් අවශ්යයි:
- පළ කිරීමේ events: යෙදුමේ TikTok Accounts, Business Content අවසරය.
- Comment events: යෙදුමේ TikTok Accounts, Business Comment අවසරය.
- comment.update: owner විසින් ලබා දී වලංගුව තබාගත යුතු comment.list scope එක.
- ඉක්මනින්ම HTTP 200 පිළිතුරු දෙන HTTPS callback URL එකක්.
subscribe කරන්නේ කෙසේද?
/business/webhook/update/ වෙත POST එකක් මගින්, event_type එකකට එක වරක්. body එකට app_id සහ secret, event_type (VIDEO හෝ COMMENT) සහ callback_url ඇතුළත් වේ. COMMENT සඳහා item_list ද ගත හැක. පිළිතුරෙන් app_id, event_type, callback_url සහ, සකසා ඇත්නම්, item_list නැවත පෙන්වයි. එම event_type සඳහා නැවත call කළහොත් 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 events සීමා කරන්නේ කෙසේද?
එය /business/video/list/ වෙතින් IDs 100 දක්වා නම් කරන posts වලට comment.update සීමා කරන අතර, පළමු ලැයිස්තුව ඉන් පසු යෙදුම සඳහා mode තීරණය කරයි:
item_listසහිත පළමු COMMENT call: events ලැබෙන්නේ ලැයිස්තුගත posts සඳහා පමණි.item_listසහිත පසු call: නව posts දැනට ලැයිස්තුගත posts වලට එකතු වේ.item_listනොමැති COMMENT call, පෙර කිසිවක් නොමැති නම්: events ලැබෙන්නේ යෙදුමට අවසර දුන් ගිණුම්වල posts සඳහාය.item_listනොමැති COMMENT call, ලැයිස්තුවක් දැනටමත් ඇති විට: සකසා ඇති posts ඒ ආකාරයෙන්ම පවතී.
දායකත්වයක් පරීක්ෂා කරන්නේ හෝ ඉවත් කරන්නේ කෙසේද?
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 call එකේ item_list ඇත්නම් ඒ posts පමණක් ඉවත් වන අතර, එය නොමැති නම් සියලු posts සඳහා comment events නතර වේ.
callback URL එක කළ යුත්තේ කුමක්ද?
වහාම පිළිතුරු දෙන්න. TikTok HTTPS හරහා JSON POST කරන අතර HTTP 200 හැර වෙනත් ඕනෑම දෙයක් අසාර්ථක delivery එකක් ලෙස සලකයි, event එක ඉවත දැමීමට පෙර පැය 72 දක්වා exponential backoff සමඟ retry කරයි. Delivery අවම වශයෙන් එක් වරක් වන නිසා එකම event දෙවරක් පැමිණිය හැකි අතර, සැකසීම idempotent විය යුතුය. සෑම request එකකම ලොග් කිරීමට වටින headers තුනක් ඇත: tiktok-signature, webhook-schema-version සහ x-tt-logid, සහ body එකේ client_key, event, create_time (තත්පර වලින්), user_openid (එය ගිණුමේ business_id ය), සහ content (serialize කළ JSON string එකකි).
Tiktok-Signature සත්යාපනය කරන්නේ කෙසේද?
header එක t=<unix>,s=<hex> ලෙස, කොමා මතින් සහ පසුව සමාන ලකුණ මතින් බෙදන්න. t අගයෙන්, තිතකින් සහ request body එකෙන් signed message එක සාදා, එයට HMAC-SHA256 ගණනය කර, යෙදුමේ secret මගින් key කර, hex-encode කර s සමඟ සසඳන්න. ඉන්පසු t කොපමණ පැරණිද යන්න පරීක්ෂා කරන්න: TikTok delivery වේලාව signed කරන්නේ replay වලට එරෙහිව, එහි නියැදිය තත්පර 5ක ප්රමාදයක් පිළිගනී. Raw body එක ලැබුණු ආකාරයටම භාවිතා කිරීම JSON වෙනස් ආකාරයකට නැවත serialize වීම වළක්වයි.
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 events ලබාගන්නේ කෙසේද?
ගිණුමට ගමනාන්තයක් දීමෙන්. easyCoexistence තමන්ගේම යෙදුම COMMENT සඳහා subscribe කර තබා ගන්නා අතර, TikTok signature පරීක්ෂා කර, TikTok වෙත වහාම පිළිතුරු දෙයි, සහ සම්බන්ධිත ගිණුමක සෑම comment.update එකක්ම එයට සකසා ඇති HTTPS endpoint එකට POST කරයි. Claude හෝ ChatGPT වෙතින්, set_social_webhook_destination එකට account_id සහ url ලබා දිය හැකි අතර, නතර කිරීමට null; එය එක් වරක් පමණක් පෙන්වන signing secret එකක් ලබා දෙයි; නැවත call කළහොත් නව එකක් නිකුත් වේ. පළ කිරීමේ events forward නොකෙරේ: ඒ වෙනුවට get_tiktok_publish_status මගින් post එක අනුගමනය කරයි.
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 එක bearer token ලෙසත්, body එක {"url": "https://..."} ලෙසත්. පිළිතුරෙහි webhook_url, signing_secret සහ note ඇත, සහ {"url": null} යැවීමෙන් forwarding නතර වේ. URL එක public host එකක HTTPS භාවිතා කළ යුතුය; නොදන්නා channel එකක් 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": "..." }delivery දෙක අතර වෙනස කුමක්ද?
easyCoexistence වෙතින් forward කරන ලද delivery එක TikTok ගේ තමන්ගේම delivery එකෙන් වෙනස් ලෙස අත්සන් කර හැඩගස්වා ඇති නිසා, එකකට ලියූ receiver එකට අනෙකට අවශ්ය වෙනස්කම් අවශ්යයි. Forward කරන payload එකේ TikTok comment fields, content parse කර, IDs string ලෙස, තබා ඇත; වෙනස් වන්නේ එක් එක් delivery එක අත්සන් කරන, විෂයට සීමා කරන සහ retry කරන ආකාරයයි:
| 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.
සාමාන්ය වැරදි
- පිළිතුරු දීමට පෙර event එක සැකසීම. TikTok වහාම 200 ඉල්ලන අතර, ස්වීකාර නොකළ deliveries retry කරයි, එබැවින් වැඩ queue කර පළමුව පිළිතුරු දෙන්න.
- පළමු COMMENT subscription හිදී වරදින් item_list යැවීම. එතැන් පටන් TikTok ලැයිස්තුගත posts සඳහා පමණක් comment events වාර්තා කරයි.
- access token සමඟ සත්යාපනය කිරීම. TikTok webhooks අත්සන් කරන්නේ යෙදුමේ secret එකෙනි, /business/webhook/update/ ගන්නා එකම එකෙනි.
- එක යෙදුමකට පරිසර දෙකක් යොමු කිරීම. එක් event type එකකට යෙදුමකට එක callback_url එකක් පමණක් ඇත, නව /business/webhook/update/ call එකක් එය ප්රතිස්ථාපනය කරයි.
Claude හෝ ChatGPT වෙතින් set_social_webhook_destination මගින්, නැත්නම් PUT /channels/{id}/webhook මගින් එය සකසන්න. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වෙමින්, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
TikTok webhook delivery එකක් කුමන headers ගෙන එයිද?
tiktok-signature, webhook-schema-version, දැනට v1.0, සහ x-tt-logid, delivery එකේ ID. JSON body එකේ client_key, event, create_time, user_openid සහ content ඇත.
video එකක් පළ කළ විට TikTok webhook එකක් යවයිද?
ඔව්, event_type VIDEO සමඟ: TikTok ගොනුව බාගත කර පරීක්ෂා කළ පසු post.publish.complete, ඉන්පසු post public වූ විට post_id සමඟ post.publish.publicly_available.
TikTok අසාර්ථක webhook එකක් කොපමණ කාලයක් retry කරයිද?
පැය 72 දක්වා exponential backoff සමඟ, ඉන් පසු event ඉවත දමයි. Delivery අවම වශයෙන් එක් වරක් වන නිසා අනුපිටපත් බලාපොරොත්තු වන්න.
easyCoexistence හි TikTok යෙදුමේ මගේම callback එකක් ලියාපදිංචි කළ හැකිද?
නොහැක. යෙදුමේ webhook සැකසුම් easyCoexistence සතුව පවතී. set_social_webhook_destination මගින් ගිණුමේ comment events ඔබ වෙත යවයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ