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.
Muda ambao TikTok hujaribu tena uwasilishaji ambao haujajibiwa kwa HTTP 200, kwa muda wa kusubiri unaoongezeka kwa kasi, kabla ya kuutupa.
Idadi kubwa ya post IDs ambazo item_list moja inaweza kutaja ili kupunguza matukio ya comment.update kwa machapisho fulani.
Thamani ya sasa ya kichwa cha webhook-schema-version ambacho TikTok hutuma pamoja na kila uwasilishaji.
Kile ambacho marejeo ya TikTok yanaorodhesha kwa endpoints za usanidi wa webhook, ambazo hujithibitisha kwa app ID na secret.
Algoriti inayotumika kwa Tiktok-Signature: timestamp, nukta na mwili wa ombi, ikitumia secret ya programu na kusimbwa kwa hex.
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:
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.
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.
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_ageUnapokeaje 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_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.
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 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 |
Jinsi ya kuisanidi
- 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.
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.
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