Zdarzenia webhook komentarzy TikTok
API for Business od TikToka wysyła webhook comment.update w ciągu pięciu minut od utworzenia, usunięcia, ukrycia, ustawienia widoczności tylko dla znajomych lub upublicznienia komentarza albo odpowiedzi pod zdjęciami i publicznymi filmami na koncie. Każde zdarzenie zawiera komentarz, post, działanie, identyfikator osoby komentującej i tekst, a podpisem jest nagłówek Tiktok-Signature.
easyCoexistence przekazuje każde zdarzenie komentarza TikTok dla konta na Twój endpoint HTTPS od razu po nadejściu, podpisane sekretem tego konta i bez zachowanej kopii.
Czas, w jakim comment.update uruchamia się po utworzeniu, usunięciu lub zmianie widoczności komentarza lub odpowiedzi.
Jak długo TikTok ponawia dostarczenie zdarzenia, na które odbiorca nie odpowiedział kodem HTTP 200, wydłużając przerwy wykładniczo.
Zakres uprawnień, jaki konto musi mieć nadany i ważny, aby wysyłać zdarzenia comment.update.
Gwarancja dostarczenia przez TikToka: to samo zdarzenie może przyjść więcej niż raz, dlatego obsługa powinna być idempotentna.
Co raportuje comment.update?
Zmiany komentarzy pod zdjęciami i publicznymi filmami na koncie, opublikowanymi przez API lub w aplikacji TikTok. comment_action mówi, co się stało:
- insert: komentarz lub odpowiedź została utworzona.
- delete: została usunięta.
set_to_hidden: została ukryta przez użytkownika lub w wyniku moderacji.set_to_friends_only: została ustawiona jako widoczna tylko dla znajomych.set_to_public: przeszła z ukrytej lub widocznej tylko dla znajomych na widoczną dla wszystkich.
Co zawiera zdarzenie?
TikTok wysyła JSON z client_key, event, create_time, user_openid, czyli identyfikatorem konta, oraz content, czyli zserializowany ciąg JSON. W content znajdują się comment_id i video_id, parent_comment_id dla odpowiedzi, comment_type (comment lub reply), comment_action, znacznik czasu, unique_identifier autora i tekst. Identyfikatory są liczbami JSON zbyt dużymi, by typ double przechowywał je dokładnie, więc odczytuj je z surowego ciągu znaków.
Jak zdarzenia docierają do Twojego endpointu?
TikTok wysyła webhooki do aplikacji dla deweloperów, przez jeden callback URL dla całej aplikacji. easyCoexistence je odbiera i przekazuje każde comment.update dla podłączonego konta na HTTPS endpoint, który dla niego ustawisz, raz, od razu po nadejściu, podpisane sekretem tego konta. Endpoint ustawisz przez set_social_webhook_destination z Claude lub ChatGPT albo przez Partner API, używając PUT /channels/:id/webhook. Sekret pokazuje się raz, a wartość null dla URL wyłącza przekazywanie.
Jak wygląda przekazane zdarzenie?
Żądanie POST z polem platform, account_id, który list_social_accounts przypisuje połączeniu, external_id konta, czyli open_id w TikToku, oraz entry: nazwa zdarzenia, create_time i content. Content jest już sparsowany, a identyfikatory zamienione na ciągi znaków, więc żaden nie jest zaokrąglony.
{
"platform": "tiktok",
"account_id": "<ACCOUNT_ID>",
"external_id": "<TIKTOK_OPEN_ID>",
"entry": {
"event": "comment.update",
"create_time": 1793318400,
"content": {
"comment_id": "<COMMENT_ID>",
"video_id": "<VIDEO_ID>",
"parent_comment_id": null,
"comment_type": "comment",
"comment_action": "insert",
"timestamp": 1793318399000,
"unique_identifier": "<UNIQUE_IDENTIFIER>",
"text": "<COMMENT_TEXT>"
}
}
}Jak zweryfikować przekazane zdarzenie?
Każde przekazane zdarzenie zawiera nagłówek X-EC-Signature: t=<unix>,v1=<hex>, gdzie v1 to HMAC-SHA256 liczony z znacznika czasu, kropki i surowej treści żądania, z kluczem będącym sekretem podpisującym konta. Przelicz go na treści dokładnie tak, jak przyszła, porównaj oba w stałym czasie i odrzuć znacznik czasu starszy niż 5 minut.
Czy dostarczenie jest ponawiane?
Nie przez easyCoexistence. Każde zdarzenie jest przekazywane raz, w pamięci, bez kopii, z której można by ponowić; przekazanie czeka 8 sekund na odpowiedź i nie podąża za przekierowaniami. Po stronie TikToka jego własne dostarczenia są ponawiane przez do 72 godzin, a TikTok gwarantuje co najmniej jedno, więc to samo zdarzenie może dotrzeć dwukrotnie: deduplikuj po comment_id razem z comment_action.
Typowe błędy
- Parsowanie identyfikatorów jako liczb. comment_id i video_id są większe, niż double przechowuje dokładnie; easyCoexistence przekazuje je jako ciągi znaków, więc tak je zachowaj.
- Liczenie podpisu na sparsowanej kopii treści. HMAC obejmuje surową treść tak, jak została dostarczona, a ponowna serializacja psuje zgodność.
- Obsługa powtórzonego zdarzenia dwa razy. TikTok dostarcza co najmniej raz, więc przed działaniem kluczuj po comment_id i comment_action.
- Wskazanie adresu, który przekierowuje. Przekazywanie nie podąża za przekierowaniami, więc podaj ostateczny adres HTTPS.
Włącz to przez set_social_webhook_destination z Claude lub ChatGPT albo przez Partner API. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, w miarę dodawania połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Które zdarzenia webhook TikTok są przekazywane?
comment.update, czyli komentarze i odpowiedzi pod postami podłączonego konta: utworzone, usunięte, ukryte, ustawione jako widoczne tylko dla znajomych lub upublicznione.
Czy zdarzenia publikacji TikToka też są przekazywane?
Nie. Przekazywane są zdarzenia komentarzy; śledź publikację posta za pomocą get_tiktok_publish_status.
Jak szybko nadchodzi zdarzenie komentarza TikTok?
TikTok wysyła comment.update w ciągu pięciu minut od zmiany, a easyCoexistence przekazuje je od razu po nadejściu.
Czy zdarzenie komentarza TikTok zawiera tekst?
TikTok dokumentuje pole text w content zdarzenia, obok identyfikatorów komentarza i posta, działania oraz unique_identifier autora.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w