Eventi webhook dei commenti TikTok
L'API for Business di TikTok invia un webhook comment.update entro cinque minuti dalla creazione, eliminazione, nascondimento, impostazione solo amici o pubblicazione di un commento o di una risposta sui post fotografici e sui video pubblici di un account. Ogni evento indica il commento, il post, l'azione, l'identificativo dell'autore e il testo, ed è firmato con un header Tiktok-Signature.
easyCoexistence inoltra ogni evento di commento TikTok dell'account al tuo endpoint HTTPS appena arriva, firmato con un segreto dedicato a quell'account e senza conservare copie.
Tempo entro cui comment.update viene emesso dopo la creazione, l'eliminazione o il cambio di visibilità di un commento o di una risposta.
Per quanto tempo TikTok ritenta una consegna a cui il callback non ha risposto con HTTP 200, con attesa esponenziale.
Ambito che l'account deve aver concesso, e mantenere valido, perché gli eventi comment.update vengano inviati.
La garanzia di consegna di TikTok: lo stesso evento può arrivare più di una volta, quindi la gestione deve essere idempotente.
Cosa segnala comment.update?
Le modifiche ai commenti sui post fotografici e sui video pubblici dell'account, pubblicati tramite l'API o nell'app TikTok. comment_action indica cosa è successo:
- insert: un commento o una risposta è stato creato.
- delete: è stato eliminato.
set_to_hidden: è stato nascosto, da un utente o tramite moderazione.set_to_friends_only: è stato reso visibile solo agli amici.set_to_public: è passato da nascosto o solo amici a visibile a tutti.
Cosa contiene un evento?
TikTok invia JSON con client_key, event, create_time, user_openid, che è l'ID dell'account, e content, una stringa JSON serializzata. Dentro content: comment_id e video_id, parent_comment_id per le risposte, comment_type (comment o reply), comment_action, un timestamp, l'unique_identifier dell'autore e il testo. Gli ID sono numeri JSON troppo grandi per stare esattamente in un double, quindi leggili dalla stringa grezza.
Come arrivano gli eventi al tuo endpoint?
TikTok invia i webhook all'app sviluppatore, attraverso un unico URL di callback per l'intera app. easyCoexistence li riceve e inoltra ogni comment.update di un account connesso all'endpoint HTTPS che hai impostato per quell'account, una sola volta, appena arriva, firmato con il segreto proprio di quell'account. Imposta l'endpoint con set_social_webhook_destination da Claude o ChatGPT, oppure con la Partner API tramite PUT /channels/:id/webhook; il segreto viene mostrato una sola volta, e un URL null disattiva l'inoltro.
Che aspetto ha un evento inoltrato?
Una POST con la piattaforma, l'account_id che list_social_accounts restituisce per la connessione, l'external_id dell'account, che è l'open_id di TikTok, ed entry: il nome dell'evento, create_time e content, con content già analizzato e i suoi ID convertiti in stringhe, così che nessuno venga arrotondato.
{
"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>"
}
}
}Come verifichi un evento inoltrato?
Ogni consegna inoltrata porta un header X-EC-Signature, t=<unix>,v1=<hex>, in cui v1 è un HMAC-SHA256 del timestamp e del corpo grezzo, separati da un punto, con chiave il segreto di firma dell'account. Ricalcolalo sul corpo esattamente come è arrivato, confronta i due valori in tempo costante e rifiuta un timestamp più vecchio di 5 minuti.
La consegna viene ritentata?
Non da easyCoexistence. Ogni evento viene inoltrato una sola volta, in memoria, senza copia da cui ritentare; l'inoltro attende 8 secondi una risposta e non segue i reindirizzamenti. A monte, TikTok ritenta le proprie consegne per fino a 72 ore e garantisce almeno una consegna, quindi lo stesso evento può arrivarti due volte: deduplica su comment_id insieme a comment_action.
Errori comuni
- Analizzare gli ID come numeri. comment_id e video_id sono più grandi di quanto un double contenga esattamente; easyCoexistence li inoltra come stringhe, quindi mantienili così.
- Calcolare la firma su una copia analizzata del corpo. L'HMAC copre il corpo grezzo così come è stato consegnato, e riserializzarlo fa fallire il confronto.
- Gestire due volte un evento ripetuto. TikTok consegna almeno una volta, quindi usa comment_id e comment_action come chiave prima di agire.
- Puntare la destinazione a un indirizzo che reindirizza. L'inoltro non segue i reindirizzamenti, quindi indica l'URL HTTPS finale.
Attivalo con set_social_webhook_destination da Claude o ChatGPT, oppure con la Partner API. Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Quali eventi webhook di TikTok vengono inoltrati?
comment.update, per i commenti e le risposte sui post dell'account connesso: creati, eliminati, nascosti, resi visibili solo agli amici o pubblicati.
Vengono inoltrati anche gli eventi di pubblicazione di TikTok?
No. L'inoltro riguarda gli eventi sui commenti; per seguire la pubblicazione di un post usa invece get_tiktok_publish_status.
Con quanta rapidità arriva un evento di commento TikTok?
TikTok invia comment.update entro cinque minuti dal cambiamento, ed easyCoexistence lo inoltra appena arriva.
Un evento di commento TikTok include il testo?
TikTok documenta un campo text nel content dell'evento, accanto agli ID del commento e del post, all'azione e all'unique_identifier dell'autore.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il