Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Pag-set up ng TikTok API for Business webhooks

Nagpapadala ang TikTok API for Business ng webhooks sa isang callback URL kada developer app at kada event type, na itinakda gamit ang POST /business/webhook/update/ kasama ang app_id at secret ng app. Ang event_type na VIDEO ay nagsu-subscribe sa apat na publishing event ng post, at ang COMMENT naman sa comment.update. Bawat delivery ay isang HTTPS POST na may signature sa Tiktok-Signature header, gawa ng HMAC-SHA256 gamit ang app secret bilang key.

Pinapanatili ng easyCoexistence na naka-subscribe ang comment webhook ng TikTok para sa app nito, sinusuri ang signature ng TikTok, at ipinapasa ang bawat comment event para sa account ninyo sa inyong HTTPS endpoint, na pinirmahan gamit ang sarili nitong secret.

72 hours

Gaano katagal nire-retry ng TikTok ang delivery na hindi sinagot ng HTTP 200, may exponential backoff, bago ito itapon.

100

Pinakamaraming post ID na kayang pangalanan ng isang item_list para limitahan ang comment.update events sa partikular na post.

v1.0

Kasalukuyang halaga ng webhook-schema-version header na ipinapadala ng TikTok sa bawat delivery.

No permission

Ano ang nakalista sa reference ng TikTok para sa mga webhook configuration endpoint, na nag-a-authenticate gamit ang app ID at secret.

HMAC-SHA256

Algorithm sa likod ng Tiktok-Signature: ang timestamp, isang tuldok, at ang body, na keyed sa app secret at hex-encoded.

Business Comment

Permission ng app sa ilalim ng TikTok Accounts na kailangan para sa comment.update; ang publishing events ay nangangailangan ng Business Content.

Anong webhook events ang maaaring matanggap ng TikTok account app?

Dalawang kategorya, bawat isa ay naka-subscribe bilang sariling event_type. Sakop ng VIDEO ang mga post na na-publish sa pamamagitan ng /business/video/publish/ o /business/photo/publish/, at sakop ng COMMENT ang mga komento sa photo post at public video post ng account, naipost man sa pamamagitan ng API o sa TikTok app:

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

Ano ang kailangan ng app bago mag-subscribe?

Access sa API for Business, isang developer app, at mga TikTok account na nagbigay ng authorization dito. Nagdadagdag ang gabay ng TikTok sa subscription ng permission para sa bawat kategorya, at kailangan ng comment event ng scope mula sa bawat owner:

  • Publishing events: ang permission na TikTok Accounts, Business Content sa app.
  • Comment events: ang permission na TikTok Accounts, Business Comment sa app.
  • comment.update: ang comment.list scope, ibinigay ng owner at dapat manatiling valid.
  • Isang callback URL sa HTTPS na sumasagot ng HTTP 200 kaagad.

Paano mag-subscribe?

Sa pamamagitan ng POST sa /business/webhook/update/, isang beses kada event_type. Ang body ay kumukuha ng app_id at secret, ang event_type na VIDEO o COMMENT, at callback_url; para sa COMMENT, maaari rin itong kumuha ng item_list. Ibinabalik ng sagot ang app_id, event_type, callback_url at, kung may naka-configure, ang item_list. Kapag tinawag ulit para sa parehong event_type, papalitan nito ang callback URL.

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" }
}

Paano pinapaliit ng item_list ang comment events?

Nililimitahan nito ang comment.update sa mga post na binanggit, hanggang 100 ID mula sa /business/video/list/, at ang unang listahan ang magtatakda ng mode para sa app mula noon:

  • Unang COMMENT call na may item_list: ang events ay darating para sa mga nakalistang post lang.
  • Mga susunod na call na may item_list: sasali ang mga bagong post sa mga nakalista na.
  • COMMENT call na walang item_list, kapag wala pang nakatakda: darating ang events para sa mga post ng mga account na nagbigay ng authorization sa app.
  • COMMENT call na walang item_list, kapag may listahan na: mananatili ang mga naka-configure na post.

Paano tingnan o alisin ang subscription?

Ang GET sa /business/webhook/list/ kasama ang app_id, secret at event_type ay nagbabalik ng configuration: lalabas ang callback_url kapag may umiiral para sa event type na iyon, at ang item_list kapag may nakatakda. Inaalis ito ng POST sa /business/webhook/delete/ kasama ang app_id, secret at event_type; para sa COMMENT, ang item_list sa delete call ay nag-aalis lang ng mga post na iyon, at kapag wala nito, hihinto ang comment events para sa lahat ng post.

Ano ang dapat gawin ng callback URL?

Sumagot kaagad. Nagpapadala ang TikTok ng JSON sa pamamagitan ng HTTPS at itinuturing na failed delivery ang anumang bukod sa HTTP 200, kaya nire-retry ito na may exponential backoff hanggang 72 oras bago itapon ang event. Kahit isang beses man lang ang delivery, kaya maaaring dumating nang dalawang beses ang parehong event at dapat idempotent ang processing. Bawat request ay may tatlong header na sulit i-log: tiktok-signature, webhook-schema-version, at x-tt-logid, at may body na client_key, event, create_time sa segundo, user_openid na siyang business_id ng account, at content, isang serialized JSON string.

Paano i-verify ang Tiktok-Signature?

Hatiin ang header, t=<unix>,s=<hex>, sa mga kuwit at pagkatapos sa pantay na tanda (=). Buuin ang signed message mula sa value ng t, isang tuldok, at ang request body; kuwentahin ang HMAC-SHA256 nito gamit ang app secret bilang key, i-hex-encode, at ihambing sa s. Pagkatapos, tingnan kung gaano na katanda ang t: pinipirmahan ng TikTok ang oras ng delivery para maiwasan ang replay, at tumatanggap ang sample nito ng 5 segundong delay. Mas mainam gamitin ang raw body gaya ng natanggap para hindi mag-iba ang serialization ng 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

Paano tumatanggap ng TikTok events sa pamamagitan ng easyCoexistence?

Sa pamamagitan ng pagtatakda ng destination para sa account. Pinapanatili ng easyCoexistence ang sarili nitong app na naka-subscribe sa COMMENT, sinusuri ang signature ng TikTok, sumasagot agad sa TikTok, at nagpo-POST ng bawat comment.update para sa naka-connect na account sa HTTPS endpoint na itinakda para dito. Mula sa Claude o ChatGPT, tumatanggap ang set_social_webhook_destination ng account_id at url, o null para huminto, at nagbabalik ng signing secret na ipinapakita nang isang beses lang; kapag tinawag ulit, bibigyan ng bago. Hindi ipinapasa ang publishing events: sa halip, sinusundan ng get_tiktok_publish_status ang post.

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. ..."
}

Paano ito itatakda gamit ang Partner API?

Gamit ang PUT sa /channels/{id}/webhook sa https://easycoexistence.com/api/v1, ang ec_live_ key bilang bearer token, at body na {"url": "https://..."}. Ang sagot ay naglalaman ng webhook_url, signing_secret at note, at ang {"url": null} ay humihinto sa pagpapasa. Dapat gumamit ng HTTPS ang URL sa public host; ang hindi kilalang channel ay nagbabalik ng 404 not_found, ang naalis na 409 removed, at ang na-suspend na 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": "..." }

Paano nagkakaiba ang dalawang delivery?

Iba ang pagkakapirma at hugis ng forward mula sa easyCoexistence kaysa sa sariling delivery ng TikTok, kaya kailangan ng pagbabago ang receiver na nakasulat para sa isa kapag gagamit ng isa pa. Pinapanatili ng forwarded payload ang comment fields ng TikTok, na may parsed na content at mga ID bilang string; ang nagbabago ay kung paano pinipirmahan, sinasaklaw at ni-retry ang bawat delivery:

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

Paano ito i-set up

  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.

Mga karaniwang pagkakamali

  • Pag-process ng event bago sumagot. Humihingi ang TikTok ng agarang 200 at nire-retry ang mga delivery na hindi nakikitang kinilala, kaya ilagay muna sa queue ang trabaho at sumagot muna.
  • Aksidenteng pagpapadala ng item_list sa unang COMMENT subscription. Mula noon, iuulat ng TikTok ang comment events para sa nakalistang post lang.
  • Pag-verify gamit ang access token. Pinipirmahan ng TikTok ang webhooks gamit ang app secret, ang parehong kinukuha ng /business/webhook/update/.
  • Pagtuturo ng dalawang environment sa iisang app. Isang callback_url lang kada event type kada app ang pinapayagan, at papalitan ito ng bagong tawag sa /business/webhook/update/.
Ginagawa ito gamit ang EasyCoexistence

Itakda ito gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang PUT /channels/{id}/webhook. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, kasama ang unang 3 araw na free trial.

Mga madalas itanong

Anong headers ang dala ng TikTok webhook delivery?

tiktok-signature, webhook-schema-version, kasalukuyang v1.0, at x-tt-logid, ang ID ng delivery. Ang JSON body ay naglalaman ng client_key, event, create_time, user_openid at content.

Nagpapadala ba ang TikTok ng webhook kapag na-publish ang video?

Oo, gamit ang event_type na VIDEO: post.publish.complete kapag na-download at na-check na ng TikTok ang file, at pagkatapos ang post.publish.publicly_available, kasama ang post_id, kapag pampubliko na ang post.

Gaano katagal nire-retry ng TikTok ang nabigong webhook?

Hanggang 72 oras na may exponential backoff, pagkatapos ay itatapon ang event. Kahit isang beses man lang ang delivery, kaya asahan ang mga duplicate.

Maaari ba akong mag-register ng sariling callback sa TikTok app ng easyCoexistence?

Hindi. Nananatili sa easyCoexistence ang webhook settings ng app. Ipinapadala ng set_social_webhook_destination ang comment events ng account sa inyo.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong