Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Postavljanje TikTok API for Business webhookova

TikTokov API for Business šalje webhookove na jedan callback URL po razvojnoj aplikaciji i vrsti događaja, postavljen pozivom POST /business/webhook/update/ s app_id i secretom aplikacije. event_type VIDEO pretplaćuje na četiri događaja vezana uz objavljivanje objava, a COMMENT na comment.update. Svaka isporuka je HTTPS POST potpisan u zaglavlju Tiktok-Signature pomoću HMAC-SHA256 s tajnim ključem aplikacije.

easyCoexistence drži TikTokovu pretplatu na webhook komentara za svoju aplikaciju, provjerava TikTokov potpis i prosljeđuje svaki događaj komentara za vaš račun na vaš HTTPS endpoint, potpisan vlastitim tajnim ključem.

72 hours

Koliko dugo TikTok ponavlja isporuku na koju nije odgovoreno HTTP 200, uz eksponencijalno povećavanje razmaka, prije nego je odbaci.

100

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

v1.0

Trenutačna vrijednost zaglavlja webhook-schema-version koje TikTok šalje uz svaku isporuku.

No permission

Što TikTokova referenca navodi za endpointe za konfiguraciju webhookova, koji se autentificiraju pomoću app ID-a i secreta.

HMAC-SHA256

Algoritam iza Tiktok-Signature: vremenska oznaka, točka i tijelo, potpisani tajnim ključem aplikacije i heksadecimalno kodirani.

Business Comment

Dopuštenje aplikacije pod TikTok Accounts potrebno za comment.update; događaji objavljivanja trebaju Business Content.

Koje webhook događaje može primati aplikacija TikTok računa?

Dvije kategorije, a svaka se pretplaćuje kao zaseban event_type. VIDEO obuhvaća objave objavljene putem /business/video/publish/ ili /business/photo/publish/, a COMMENT obuhvaća komentare na foto objave računa i javne video objave, bez obzira jesu li objavljene putem API-ja ili u aplikaciji 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

Što aplikacija treba prije pretplate?

Pristup TikTok API for Business, razvojnu aplikaciju i TikTok račune koji su je ovlastili. TikTokov vodič za pretplatu dodaje dopuštenje za svaku kategoriju, a događaj komentara treba opseg od svakog vlasnika:

  • Događaji objavljivanja: dopuštenje TikTok Accounts, Business Content na aplikaciji.
  • Događaji komentara: dopuštenje TikTok Accounts, Business Comment na aplikaciji.
  • comment.update: opseg comment.list, koji odobrava vlasnik i održava valjanim.
  • Callback URL na HTTPS-u koji odmah odgovara HTTP 200.

Kako se pretplaćuje?

POST zahtjevom na /business/webhook/update/, jednom za svaki event_type. Tijelo sadrži app_id i secret, event_type, VIDEO ili COMMENT, te callback_url; za COMMENT može sadržavati i item_list. Odgovor ponavlja app_id, event_type, callback_url i, ako je postavljen, item_list. Ponovni poziv za isti event_type zamjenjuje 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-ova iz /business/video/list/, a prvi popis od tada određuje način rada za aplikaciju:

  • Prvi COMMENT poziv s item_list: događaji stižu samo za navedene objave.
  • Kasniji pozivi s item_list: nove objave pridružuju se već navedenima.
  • COMMENT poziv bez item_list, dok nijedan nije postavljen: događaji stižu za objave računa koji su ovlastili aplikaciju.
  • COMMENT poziv bez item_list, kad popis već postoji: konfigurirane objave ostaju kakve jesu.

Kako provjeriti ili ukloniti pretplatu?

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

Što callback URL mora raditi?

Odmah odgovoriti. TikTok šalje JSON putem HTTPS-a i smatra svaki odgovor osim HTTP 200 neuspjelom isporukom, ponavljajući je s eksponencijalnim povećavanjem razmaka do 72 sata prije nego odbaci događaj. Isporuka je najmanje jednom, pa isti događaj može stići dvaput i obrada mora biti idempotentna. Svaki zahtjev nosi tri zaglavlja vrijedna bilježenja: tiktok-signature, webhook-schema-version i x-tt-logid, te tijelo s client_key, event, create_time u sekundama, user_openid, što je business_id računa, i content, serijalizirani JSON niz znakova.

Kako provjeriti Tiktok-Signature?

Razdvojite zaglavlje, t=<unix>,s=<hex>, prvo po zarezima, pa po znaku jednakosti. Sastavite potpisanu poruku od vrijednosti t, točke i tijela zahtjeva, izračunajte HMAC-SHA256 nad njom s tajnim ključem aplikacije, heksadecimalno je kodirajte i usporedite sa s. Zatim provjerite koliko je stara vrijednost t: TikTok potpisuje vrijeme isporuke kako bi onemogućio ponovna slanja, a njegov primjer prihvaća kašnjenje od 5 sekundi. Rad s neobrađenim tijelom kako je primljeno izbjegava drugačije ponovno serijaliziranje 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 primati TikTok događaje u sustavu easyCoexistence?

Dajući računu odredište. easyCoexistence drži vlastitu aplikaciju pretplaćenu na COMMENT, provjerava TikTokov potpis, odmah odgovara TikToku i šalje svaki comment.update za povezani račun na HTTPS endpoint postavljen za njega. Iz Clauda ili ChatGPT-ja, set_social_webhook_destination uzima account_id i url, ili null za zaustavljanje, te vraća potpisni tajni ključ prikazan samo jednom; ponovni poziv izdaje novi. Događaji objavljivanja se ne prosljeđuju: umjesto 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 postaviti putem Partner API-ja?

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

Kako se razlikuju dvije isporuke?

Prosljeđivanje iz sustava easyCoexistence potpisano je i oblikovano drugačije od TikTokove vlastite isporuke, pa prijemnik napisan za jednu treba izmjene za drugu. Prosljeđeni payload zadržava TikTokova polja komentara, s raščlanjenim content i ID-ovima kao stringovima; mijenja se način na koji je svaka isporuka potpisana, ograničena i ponovno se š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 ga postaviti

  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.

Uobičajene pogreške

  • Obrada događaja prije odgovora. TikTok traži odmah HTTP 200 i ponavlja isporuke čiju potvrdu ne vidi, pa posao stavite u red čekanja i prvo odgovorite.
  • Slanje item_list pri prvoj COMMENT pretplati slučajno. Od tada TikTok prijavljuje događaje komentara samo za navedene objave.
  • Provjera s access tokenom. TikTok potpisuje webhookove tajnim ključem aplikacije, istim onim koji prima /business/webhook/update/.
  • Usmjeravanje dva okruženja na jednu aplikaciju. Svaki tip događaja zadržava jedan callback_url po aplikaciji, a novi poziv /business/webhook/update/ ga zamjenjuje.
Radite ovo uz EasyCoexistence

Postavite ga s set_social_webhook_destination iz Clauda ili ChatGPT-ja ili s PUT /channels/{id}/webhook. US$ 9 do US$ 0.75 po vezi mjesečno, uz pad cijene kako dodajete veze, uz besplatno probno razdoblje od 3 dana.

Često postavljana pitanja

Koja zaglavlja nosi TikTok webhook isporuka?

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

Šalje li TikTok webhook kad se video objavi?

Da, s event_type VIDEO: post.publish.complete nakon što TikTok preuzme i provjeri datoteku, zatim post.publish.publicly_available, s post_id, kada je objava javna.

Koliko dugo TikTok ponavlja neuspjeli webhook?

Do 72 sata s eksponencijalnim povećavanjem razmaka, nakon čega se događaj odbacuje. Isporuka je najmanje jednom, pa računajte na duplikate.

Mogu li registrirati vlastiti callback u TikTok aplikaciji sustava easyCoexistence?

Ne. Postavke webhookova aplikacije ostaju u sustavu easyCoexistence. set_social_webhook_destination umjesto toga šalje događaje komentara računa vama.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na