IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Kuweka webhooks za TikTok API for Business

TikTok API for Business hutuma webhooks kwa URL moja ya callback kwa kila programu ya msanidi na kila aina ya tukio, ambayo huwekwa kwa POST /business/webhook/update/ kwa kutumia app_id na secret ya programu. event_type VIDEO hujiandikisha kwa matukio manne ya uchapishaji wa machapisho, na COMMENT kwa comment.update. Kila uwasilishaji ni HTTPS POST iliyosainiwa kwenye kichwa cha Tiktok-Signature kwa HMAC-SHA256 inayotumia secret ya programu.

easyCoexistence huweka usajili wa maoni wa TikTok kwa programu yake, huangalia sahihi ya TikTok na kupitisha kila tukio la maoni kwa akaunti yako kwenda kwenye endpoint yako ya HTTPS, likisainiwa kwa secret yake yenyewe.

72 hours

Muda ambao TikTok hujaribu tena uwasilishaji ambao haujajibiwa kwa HTTP 200, kwa muda wa kusubiri unaoongezeka kwa kasi, kabla ya kuutupa.

100

Idadi kubwa ya post IDs ambazo item_list moja inaweza kutaja ili kupunguza matukio ya comment.update kwa machapisho fulani.

v1.0

Thamani ya sasa ya kichwa cha webhook-schema-version ambacho TikTok hutuma pamoja na kila uwasilishaji.

No permission

Kile ambacho marejeo ya TikTok yanaorodhesha kwa endpoints za usanidi wa webhook, ambazo hujithibitisha kwa app ID na secret.

HMAC-SHA256

Algoriti inayotumika kwa Tiktok-Signature: timestamp, nukta na mwili wa ombi, ikitumia secret ya programu na kusimbwa kwa hex.

Business Comment

Ruhusa ya programu chini ya TikTok Accounts inayohitajika kwa comment.update; matukio ya uchapishaji yanahitaji Business Content.

Ni matukio gani ya webhook ambayo programu ya akaunti ya TikTok inaweza kupokea?

Makundi mawili, kila moja likijiandikisha kama event_type yake. VIDEO inahusu machapisho yaliyochapishwa kupitia /business/video/publish/ au /business/photo/publish/, na COMMENT inahusu maoni kwenye machapisho ya picha ya akaunti na machapisho ya video ya umma, ziwe zimechapishwa kupitia API au kwenye programu ya 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

Programu inahitaji nini kabla ya kujiandikisha?

Ufikiaji wa API for Business, programu ya msanidi, na akaunti za TikTok ambazo zimeidhinisha. Mwongozo wa usajili wa TikTok unaongeza ruhusa kwa kila kundi, na tukio la maoni linahitaji wigo kutoka kwa kila mmiliki:

  • Matukio ya uchapishaji: ruhusa ya TikTok Accounts, Business Content kwenye programu.
  • Matukio ya maoni: ruhusa ya TikTok Accounts, Business Comment kwenye programu.
  • comment.update: wigo wa comment.list, uliotolewa na mmiliki na unaobaki hai.
  • URL ya callback kwenye HTTPS inayojibu HTTP 200 mara moja.

Unajiandikisha vipi?

Kwa POST kwenda /business/webhook/update/, mara moja kwa kila event_type. Mwili unachukua app_id na secret, event_type, VIDEO au COMMENT, na callback_url; kwa COMMENT unaweza pia kuchukua item_list. Jibu linarudia app_id, event_type, callback_url na, ikiwa imewekwa, item_list. Kuita tena kwa event_type ile ile kunachukua nafasi ya 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" }
}

item_list inapunguzaje matukio ya maoni?

Inazuia comment.update kwa machapisho yaliyotajwa, hadi IDs 100 kutoka /business/video/list/, na orodha ya kwanza huamua hali ya programu tangu hapo:

  • Wito wa kwanza wa COMMENT wenye item_list: matukio yanafika kwa machapisho yaliyoorodheshwa pekee.
  • Wito wa baadaye wenye item_list: machapisho mapya yanajiunga na yale yaliyoorodheshwa tayari.
  • Wito wa COMMENT bila item_list, kisha hakuna iliyowekwa awali: matukio yanafika kwa machapisho ya akaunti zilizoidhinisha programu.
  • Wito wa COMMENT bila item_list, mara orodha ikiwepo: machapisho yaliyosanidiwa yanabaki kama yalivyo.

Unaangaliaje au kuondoa usajili?

GET /business/webhook/list/ pamoja na app_id, secret na event_type hurudisha usanidi: callback_url huonekana tu ikiwepo kwa aina hiyo ya tukio, na item_list tu ikiwa iliwekwa. POST /business/webhook/delete/ pamoja na app_id, secret na event_type huondoa usajili huo; kwa COMMENT, item_list katika wito wa kufuta huondoa machapisho hayo pekee, na bila hiyo matukio ya maoni yanakoma kwa machapisho yote.

URL ya callback inapaswa kufanya nini?

Kujibu mara moja. TikTok hutuma JSON kupitia HTTPS na huchukulia kila jibu lisilo HTTP 200 kama uwasilishaji ulioshindwa, ikijaribu tena kwa muda wa kusubiri unaoongezeka kwa kasi hadi saa 72 kabla ya kutupa tukio. Uwasilishaji ni angalau mara moja, kwa hiyo tukio lile lile linaweza kufika mara mbili, na uchakataji lazima uwe salama kurudiwa (idempotent). Kila ombi lina vichwa vitatu vinavyostahili kurekodiwa kwenye kumbukumbu: tiktok-signature, webhook-schema-version na x-tt-logid. Mwili una client_key, event, create_time kwa sekunde, user_openid, ambayo ni business_id ya akaunti, na content, ambayo ni mfuatano wa JSON uliopangwa kuwa maandishi.

Unathibitishaje Tiktok-Signature?

Gawanya kichwa, t=<unix>,s=<hex>, kwa koma kisha kwa alama ya sawa. Tengeneza ujumbe uliosainiwa kutoka thamani ya t, nukta na mwili wa ombi, kokotoa HMAC-SHA256 yake ukitumia secret ya programu, uisimbe kwa hex na ulinganishe na s. Kisha angalia umri wa t: TikTok inasaini muda wa uwasilishaji ili kuzuia urudiaji wa ombi, na mfano wake unakubali ucheleweshaji wa sekunde 5. Kufanya kazi kutoka mwili ghafi kama ulivyopokelewa kunazuia kuandika upya JSON kwa namna tofauti.

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

Unapokeaje matukio ya TikTok kupitia easyCoexistence?

Kwa kumpa akaunti lengwa. easyCoexistence huweka programu yake yenyewe ikijiandikisha kwa COMMENT, huangalia sahihi ya TikTok, hujibu TikTok mara moja, na hutuma kila comment.update kwa akaunti iliyounganishwa kwenye endpoint ya HTTPS iliyowekwa kwake. Kutoka Claude au ChatGPT, set_social_webhook_destination huchukua account_id na url, au null kusimamisha, na hurudisha signing secret inayoonekana mara moja tu; kuiita tena kunatoa mpya. Matukio ya uchapishaji hayatumwi: badala yake, get_tiktok_publish_status hufuatilia chapisho.

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

Unaiweka vipi kwa Partner API?

Kwa PUT /channels/{id}/webhook kwenye https://easycoexistence.com/api/v1, ufunguo wako wa ec_live_ kama bearer token, na mwili wa {"url": "https://..."}. Jibu lina webhook_url, signing_secret na note, na {"url": null} husimamisha usambazaji. URL lazima itumie HTTPS kwenye host ya umma; chaneli isiyojulikana hurudisha 404 not_found, iliyoondolewa 409 removed, na iliyositishwa 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": "..." }

Uwasilishaji hizo mbili zinatofautianaje?

Usambazaji kutoka easyCoexistence umesainiwa na kuundwa tofauti na uwasilishaji wa TikTok wenyewe, kwa hiyo mpokeaji aliyeandikwa kwa moja anahitaji mabadiliko kwa nyingine. Payload iliyosambazwa inabaki na sehemu za maoni za TikTok, content ikichambuliwa na IDs zikiwa mfuatano; kinachobadilika ni jinsi kila uwasilishaji unavyosainiwa, kuwekewa wigo na kujaribiwa tena:

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

Jinsi ya kuisanidi

  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.

Makosa ya kawaida

  • Kuchakata tukio kabla ya kujibu. TikTok inaomba 200 mara moja na hujaribu tena uwasilishaji ambao haioni kuthibitishwa, kwa hiyo weka kazi kwenye foleni na ujibu kwanza.
  • Kutuma item_list kwenye usajili wa kwanza wa COMMENT bila kukusudia. Tangu hapo, TikTok inaripoti matukio ya maoni kwa machapisho yaliyoorodheshwa pekee.
  • Kuthibitisha kwa access token. TikTok inasaini webhooks kwa secret ya programu, ile ile ambayo /business/webhook/update/ inachukua.
  • Kuelekeza mazingira mawili kwenye programu moja. Kila aina ya tukio huhifadhi callback_url moja kwa kila programu, na wito mpya wa /business/webhook/update/ unachukua nafasi yake.
Kufanya hili ukitumia EasyCoexistence

Iweke kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa PUT /channels/{id}/webhook. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kinapungua unapoongeza muunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Ni vichwa gani vinavyobebwa na uwasilishaji wa webhook wa TikTok?

tiktok-signature, webhook-schema-version, kwa sasa v1.0, na x-tt-logid, kitambulisho cha uwasilishaji. Mwili wa JSON unashikilia client_key, event, create_time, user_openid na content.

Je, TikTok hutuma webhook wakati video imechapishwa?

Ndiyo, kwa event_type VIDEO: post.publish.complete mara TikTok inapokuwa imepakua na kukagua faili, kisha post.publish.publicly_available, pamoja na post_id, mara chapisho linapokuwa la umma.

TikTok hujaribu tena webhook iliyoshindwa kwa muda gani?

Hadi saa 72 kwa muda wa kusubiri unaoongezeka kwa kasi, kisha tukio hutupwa. Uwasilishaji ni angalau mara moja, kwa hiyo tarajia nakala.

Je, naweza kusajili callback yangu kwenye programu ya TikTok ya easyCoexistence?

Hapana. Mipangilio ya webhook ya programu inabaki kwa easyCoexistence. set_social_webhook_destination hutuma matukio ya maoni ya akaunti kwako badala yake.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye