Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Podešavanje webhook-ova za TikTok API for Business

TikTok-ov API for Business šalje webhook-ove na jedan callback URL po developer aplikaciji i tipu događaja, a podešava se pozivom POST /business/webhook/update/ uz app_id i secret aplikacije. event_type VIDEO pretplaćuje četiri događaja objavljivanja posta, a COMMENT pretplaćuje comment.update. Svaka isporuka je HTTPS POST potpisan u zaglavlju Tiktok-Signature, HMAC-SHA256 algoritmom sa ključem koji je app secret.

easyCoexistence drži TikTok pretplatu na webhook za komentare za svoju aplikaciju, proverava TikTok potpis i prosleđuje svaki događaj komentara za vaš nalog na vaš HTTPS endpoint, potpisan sopstvenim tajnim ključem.

72 hours

Koliko dugo TikTok ponavlja isporuku koja nije potvrđena sa HTTP 200, uz eksponencijalno produživanje intervala, pre nego što je odbaci.

100

Najveći broj ID-jeva objava koje jedan item_list može navesti da bi se događaji comment.update ograničili na određene objave.

v1.0

Trenutna vrednost zaglavlja webhook-schema-version koje TikTok šalje uz svaku isporuku.

No permission

Šta TikTok navodi u referenci za endpoint-e konfiguracije webhook-a, koji se autentifikuju preko app_id i secret.

HMAC-SHA256

Algoritam iza Tiktok-Signature: vremenska oznaka, tačka i telo zahteva, ključ je app secret, a rezultat je heksadecimalno kodiran.

Business Comment

Dozvola aplikacije pod TikTok Accounts potrebna za comment.update; događaji objavljivanja zahtevaju Business Content.

Koje webhook događaje može da prima aplikacija za TikTok nalog?

Dve kategorije, a svaka se pretplaćuje kao poseban event_type. VIDEO obuhvata objave objavljene preko /business/video/publish/ ili /business/photo/publish/, a COMMENT obuhvata komentare na foto objave naloga i javne video objave, bez obzira na to da li su objavljene preko API-ja ili u TikTok aplikaciji:

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

Šta aplikacija treba pre pretplate?

Pristup API for Business, developer aplikaciju i TikTok naloge koji su je autorizovali. Vodič za pretplatu na TikTok dodaje dozvolu za svaku kategoriju, a događaj komentara zahteva scope od svakog vlasnika:

  • Događaji objavljivanja: dozvola TikTok Accounts, Business Content na aplikaciji.
  • Događaji komentara: dozvola TikTok Accounts, Business Comment na aplikaciji.
  • comment.update: scope comment.list, koji odobrava vlasnik i koji mora ostati važeći.
  • Callback URL na HTTPS-u koji odmah odgovara sa HTTP 200.

Kako se pretplaćuje?

POST zahtevom na /business/webhook/update/, jednom za svaki event_type. Telo sadrži app_id i secret, event_type, VIDEO ili COMMENT, i callback_url; za COMMENT može da sadrži i item_list. Odgovor ponavlja app_id, event_type, callback_url i, ako je podešen, item_list. Ponovni poziv za isti event_type zamenjuje 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" }
}

Kako item_list sužava događaje komentara?

Ograničava comment.update na objave koje navede, do 100 ID-jeva iz /business/video/list/, a prva lista određuje režim za aplikaciju od tada nadalje:

  • Prvi COMMENT poziv sa item_list: događaji stižu samo za navedene objave.
  • Kasniji pozivi sa item_list: nove objave se pridružuju onima koje su već navedene.
  • COMMENT poziv bez item_list, ako pre toga nije bilo nijedne liste: događaji stižu za objave naloga koji su autorizovali aplikaciju.
  • COMMENT poziv bez item_list, kada lista već postoji: podešene objave ostaju onakve kakve su.

Kako se proverava ili uklanja pretplata?

GET zahtev na /business/webhook/list/ sa app_id, secret i event_type vraća konfiguraciju: callback_url se pojavljuje samo ako postoji za taj tip događaja, a item_list samo ako je podešen. POST zahtev na /business/webhook/delete/ sa app_id, secret i event_type uklanja pretplatu; za COMMENT, item_list u delete pozivu uklanja samo te objave, a bez njega se događaji komentara zaustavljaju za sve objave.

Šta callback URL mora da radi?

Da odgovori odmah. TikTok šalje JSON preko HTTPS-a i sve osim HTTP 200 tretira kao neuspešnu isporuku, ponavljajući je sa eksponencijalnim produživanjem intervala do 72 sata, pre nego što odbaci događaj. Isporuka je najmanje jednom, pa isti događaj može stići dvaput i obrada mora biti idempotentna. Svaki zahtev nosi tri zaglavlja koja vredi beležiti: tiktok-signature, webhook-schema-version i x-tt-logid, i telo sa client_key, event, create_time u sekundama, user_openid, što je business_id naloga, i content, serijalizovan JSON string.

Kako se proverava Tiktok-Signature?

Razdvojite zaglavlje, t=<unix>,s=<hex>, prvo po zarezima, pa po znaku jednakosti. Sastavite poruku za potpis od vrednosti t, tačke i tela zahteva, izračunajte HMAC-SHA256 nad njom ključem app secret, heksadecimalno je kodirajte i uporedite sa s. Zatim proverite koliko je stara vrednost t: TikTok potpisuje vreme isporuke da bi sprečio ponavljanje, a njihov primer prihvata kašnjenje od 5 sekundi. Rad sa sirovim telom kakvo je primljeno sprečava različito ponovno serijalizovanje JSON-a.

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

Kako primate TikTok događaje preko easyCoexistence?

Dodeljivanjem odredišta nalogu. easyCoexistence drži sopstvenu aplikaciju pretplaćenu na COMMENT, proverava TikTok potpis, odmah odgovara TikTok-u i šalje svaki comment.update za povezani nalog na HTTPS endpoint podešen za njega. Iz Claude-a ili ChatGPT-a, set_social_webhook_destination uzima account_id i url, ili null da zaustavi, i vraća tajni ključ za potpisivanje koji se prikazuje samo jednom; ponovni poziv izdaje novi. Događaji objavljivanja se ne prosleđuju: umesto toga get_tiktok_publish_status prati objavu.

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

Kako se podešava preko Partner API-ja?

PUT zahtevom na /channels/{id}/webhook na https://easycoexistence.com/api/v1, sa ec_live_ ključem kao bearer tokenom i telom {"url": "https://..."}. Odgovor sadrži webhook_url, signing_secret i napomenu, a {"url": null} zaustavlja prosleđivanje. URL mora koristiti HTTPS na javnom hostu; nepoznat kanal vraća 404 not_found, uklonjen 409 removed, a suspendovan 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": "..." }

Čime se razlikuju dve isporuke?

Prosleđivanje iz easyCoexistence je potpisano i oblikovano drugačije od TikTok-ove sopstvene isporuke, pa prijemnik napisan za jednu zahteva izmene za drugu. Prosleđeni payload zadržava TikTok polja komentara, sa parsiranim content i ID-jevima kao stringovima; menja se način na koji se svaka isporuka potpisuje, ograničava i ponovo šalje:

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

Kako da podesite

  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.

Česte greške

  • Obrada događaja pre odgovora. TikTok traži trenutni HTTP 200 i ponavlja isporuke koje ne vidi potvrđene, pa stavite posao u red čekanja i prvo odgovorite.
  • Slučajno slanje item_list već pri prvoj COMMENT pretplati. Od tada TikTok prijavljuje događaje komentara samo za navedene objave.
  • Verifikacija pristupnim tokenom. TikTok potpisuje webhook-ove app secret-om, istim koji uzima /business/webhook/update/.
  • Usmeravanje dva okruženja na jednu aplikaciju. Svaki tip događaja zadržava jedan callback_url po aplikaciji, a novi poziv /business/webhook/update/ ga zamenjuje.
Ovo radite uz EasyCoexistence

Podesite ga pomoću set_social_webhook_destination iz Claude-a ili ChatGPT-a, ili preko PUT /channels/{id}/webhook. Od US$ 9 do US$ 0.75 po vezi mesečno, a cena pada kako dodajete veze, uz besplatni probni period od 3 dana.

Često postavljana pitanja

Koja zaglavlja nosi TikTok webhook isporuka?

tiktok-signature, webhook-schema-version, trenutno v1.0, i x-tt-logid, ID isporuke. JSON telo sadrži client_key, event, create_time, user_openid i content.

Da li TikTok šalje webhook kada se video objavi?

Da, sa event_type VIDEO: post.publish.complete kada TikTok preuzme i proveri fajl, zatim post.publish.publicly_available, sa post_id, kada objava postane javna.

Koliko dugo TikTok ponavlja neuspeli webhook?

Do 72 sata uz eksponencijalno produživanje intervala, nakon čega se događaj odbacuje. Isporuka je najmanje jednom, pa računajte na duplikate.

Mogu li da registrujem sopstveni callback na TikTok aplikaciji easyCoexistence?

Ne. Podešavanja webhook-a aplikacije ostaju kod easyCoexistence. Umesto toga, set_social_webhook_destination šalje vama događaje komentara za nalog.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na