Evenimentele webhook pentru comentarii TikTok
API for Business de la TikTok trimite un webhook comment.update în cel mult cinci minute de la crearea, ștergerea, ascunderea, restricționarea doar pentru prieteni sau publicarea unui comentariu ori răspuns la fotografiile și videoclipurile publice ale unui cont. Fiecare eveniment indică comentariul, postarea, acțiunea, identificatorul celui care a comentat și textul și este semnat cu antetul Tiktok-Signature.
easyCoexistence transmite fiecare eveniment comment.update TikTok pentru cont către endpoint-ul dumneavoastră HTTPS, pe măsură ce sosește, semnat cu un secret propriu contului și fără nicio copie păstrată.
Intervalul în care comment.update se declanșează după ce un comentariu sau răspuns este creat, șters sau își schimbă vizibilitatea.
Cât timp reîncearcă TikTok o livrare la care callback-ul nu a răspuns cu HTTP 200, cu o întârziere care crește exponențial.
Permisiunea pe care contul trebuie să o fi acordat și să o mențină valabilă pentru ca evenimentele comment.update să fie trimise.
Promisiunea de livrare a TikTok, astfel încât același eveniment poate sosi de mai multe ori, iar procesarea trebuie să fie idempotentă.
Ce raportează comment.update?
Modificările comentariilor de pe fotografiile și videoclipurile publice ale contului, indiferent dacă au fost publicate prin API sau în aplicația TikTok. comment_action arată ce s-a întâmplat:
- insert: a fost creat un comentariu sau un răspuns.
- delete: a fost șters.
set_to_hidden: a fost ascuns, de un utilizator sau prin moderare.set_to_friends_only: a fost setat să fie vizibil doar pentru prieteni.set_to_public: a trecut de la ascuns sau doar pentru prieteni la vizibil pentru toată lumea.
Ce conține un eveniment?
TikTok trimite JSON cu client_key, event, create_time, user_openid, care este ID-ul contului, și content, un șir JSON serializat. În content se află comment_id și video_id, parent_comment_id pentru răspunsuri, comment_type (comment sau reply), comment_action, un marcaj de timp, unique_identifier al celui care a comentat și textul. ID-urile sunt numere JSON prea mari pentru a fi reținute exact de un double, așa că citiți-le din șirul brut.
Cum ajung evenimentele la endpoint-ul dumneavoastră?
TikTok trimite webhook-urile către aplicația de dezvoltator, printr-un singur URL de callback pentru întreaga aplicație. easyCoexistence le primește și transmite fiecare comment.update pentru un cont conectat către endpoint-ul HTTPS setat pentru acesta, o singură dată, pe măsură ce sosește, semnat cu propriul secret al contului. Setați endpoint-ul cu set_social_webhook_destination din Claude sau ChatGPT ori cu Partner API prin PUT /channels/:id/webhook; secretul se afișează o singură dată, iar un URL null oprește transmiterea.
Cum arată un eveniment transmis?
Un POST cu platforma, account_id pe care îl dă list_social_accounts pentru conexiune, external_id al contului, care este open_id-ul TikTok, și entry: numele evenimentului, create_time și content, cu content deja analizat și cu ID-urile transformate în șiruri, astfel încât niciunul să nu fie rotunjit.
{
"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>"
}
}
}Cum verificați un eveniment transmis?
Fiecare livrare transmisă are antetul X-EC-Signature, t=<unix>,v1=<hex>, în care v1 este un HMAC-SHA256 al marcajului de timp, al unui punct și al corpului brut, cu cheia secretă de semnare a contului. Recalculați semnătura peste corpul exact cum a sosit, comparați cele două valori în timp constant și respingeți un marcaj de timp mai vechi de 5 minute.
Se reîncearcă livrarea?
Nu de către easyCoexistence. Fiecare eveniment este transmis o singură dată, în memorie, fără o copie păstrată pentru reluare; transmiterea așteaptă 8 secunde un răspuns și nu urmează redirecționările. În amonte, TikTok își reîncearcă propriile livrări timp de până la 72 de ore și promite cel puțin una, așa că același eveniment poate ajunge la dumneavoastră de două ori: eliminați duplicatele după comment_id împreună cu comment_action.
Greșeli frecvente
- Parsarea ID-urilor ca numere. comment_id și video_id sunt mai mari decât poate reține exact un double; easyCoexistence le transmite ca șiruri, așa că păstrați-le astfel.
- Calcularea semnăturii pe o copie analizată a corpului. HMAC acoperă corpul brut, cum a fost livrat, iar reserializarea strică potrivirea.
- Tratarea de două ori a unui eveniment repetat. TikTok livrează cel puțin o dată, așa că folosiți comment_id și comment_action ca cheie înainte de a acționa.
- Direcționarea destinației către o adresă care redirecționează. Transmiterea nu urmează redirecționările, așa că indicați URL-ul HTTPS final.
Activați-l cu set_social_webhook_destination din Claude sau ChatGPT ori cu Partner API. De la US$ 9 până la US$ 0.75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Ce evenimente webhook TikTok sunt transmise?
comment.update, pentru comentariile și răspunsurile de pe postările contului conectat: create, șterse, ascunse, setate doar pentru prieteni sau făcute publice.
Sunt transmise și evenimentele de publicare TikTok?
Nu. Transmiterea include evenimentele de comentarii; urmăriți în schimb publicarea unei postări cu get_tiktok_publish_status.
Cât de repede ajunge un eveniment de comentariu TikTok?
TikTok trimite comment.update în cel mult cinci minute de la modificare, iar easyCoexistence îl transmite imediat ce sosește.
Un eveniment de comentariu TikTok include textul?
TikTok documentează un câmp text în content evenimentului, alături de ID-urile comentariului și postării, de acțiune și de unique_identifier al celui care a comentat.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la