Événements webhook des commentaires TikTok
L'API for Business de TikTok envoie un webhook comment.update dans les cinq minutes qui suivent la création, la suppression, le masquage, la restriction aux amis ou la publication d'un commentaire ou d'une réponse sur les photos et vidéos publiques d'un compte. Chaque événement désigne le commentaire, la publication, l'action, l'identifiant de l'auteur et le texte, et il est signé par l'en-tête Tiktok-Signature.
easyCoexistence transmet chaque événement de commentaire TikTok du compte à votre endpoint HTTPS dès sa réception, signé avec un secret propre à ce compte et sans copie conservée.
Délai dans lequel comment.update est émis après la création, la suppression ou le changement de visibilité d'un commentaire ou d'une réponse.
Durée pendant laquelle TikTok renouvelle une livraison dont le callback n'a pas répondu par HTTP 200, avec des délais de plus en plus longs.
Autorisation que le compte doit avoir accordée, et conserver valide, pour que ses événements comment.update soient envoyés.
Garantie de livraison de TikTok : un même événement peut arriver plus d'une fois, d'où la nécessité de traitements idempotents.
Que signale comment.update ?
Les modifications apportées aux commentaires sur les photos et les vidéos publiques du compte, qu'elles aient été publiées via l'API ou dans l'application TikTok. comment_action indique ce qui s'est passé :
- insert : un commentaire ou une réponse a été créé.
- delete : il a été supprimé.
set_to_hidden: il a été masqué, par un utilisateur ou par la modération.set_to_friends_only: il a été rendu visible aux seuls amis.set_to_public: il est passé de masqué ou réservé aux amis à visible par tous.
Que contient un événement ?
TikTok envoie un JSON contenant client_key, event, create_time, user_openid, qui correspond à l'identifiant du compte, et content, une chaîne JSON sérialisée. Dans content figurent comment_id et video_id, parent_comment_id pour les réponses, comment_type (comment ou reply), comment_action, un horodatage, l'unique_identifier de l'auteur et le texte. Les identifiants sont des nombres JSON trop grands pour être représentés exactement par un double : lisez-les donc dans la chaîne brute.
Comment les événements parviennent-ils à votre endpoint ?
TikTok envoie les webhooks à l'application développeur, par une seule URL de rappel pour l'ensemble de l'application. easyCoexistence les reçoit et transmet chaque comment.update d'un compte connecté à l'endpoint HTTPS que vous lui avez défini, une seule fois, dès sa réception, signé avec le secret propre à ce compte. Définissez cet endpoint avec set_social_webhook_destination depuis Claude ou ChatGPT, ou avec la Partner API via PUT /channels/:id/webhook ; le secret n'est affiché qu'une fois, et une URL nulle désactive la transmission.
À quoi ressemble un événement transmis ?
Un POST contenant la plateforme, le account_id que list_social_accounts attribue à la connexion, l'external_id du compte, qui est l'open_id de TikTok, et entry : le nom de l'événement, create_time et content, ce dernier déjà analysé et ses identifiants convertis en chaînes afin qu'aucun ne soit arrondi.
{
"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>"
}
}
}Comment vérifier un événement transmis ?
Chaque livraison transmise porte un en-tête X-EC-Signature, t=<unix>,v1=<hex>, où v1 est un HMAC-SHA256 de l'horodatage, d'un point et du corps brut, calculé avec le secret de signature du compte. Recalculez-le sur le corps exactement tel qu'il est arrivé, comparez les deux valeurs en temps constant, et refusez tout horodatage vieux de plus de 5 minutes.
Une livraison est-elle relancée ?
Pas par easyCoexistence. Chaque événement est transmis une seule fois, en mémoire, sans copie conservée pour une relance ; la transmission attend 8 secondes une réponse et ne suit pas les redirections. En amont, TikTok relance ses propres livraisons pendant 72 heures au plus et garantit au moins une livraison, si bien qu'un même événement peut vous parvenir deux fois : dédoublonnez sur comment_id combiné à comment_action.
Erreurs courantes
- Analyser les identifiants comme des nombres. comment_id et video_id dépassent ce qu'un double peut représenter exactement ; easyCoexistence les transmet sous forme de chaînes, gardez-les ainsi.
- Calculer la signature sur une copie analysée du corps. Le HMAC porte sur le corps brut tel que livré, et le resérialiser rompt la correspondance.
- Traiter deux fois un événement répété. TikTok livre au moins une fois : indexez sur comment_id et comment_action avant d'agir.
- Pointer la destination vers une adresse qui redirige. La transmission ne suit pas les redirections ; indiquez donc l'URL HTTPS finale.
Activez-le avec set_social_webhook_destination depuis Claude ou ChatGPT, ou avec la Partner API. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Quels événements webhook TikTok sont transmis ?
comment.update, pour les commentaires et réponses sur les publications du compte connecté : créés, supprimés, masqués, réservés aux amis ou rendus publics.
Les événements de publication TikTok sont-ils transmis aussi ?
Non. La transmission porte sur les événements de commentaires ; suivez plutôt la publication d'un contenu avec get_tiktok_publish_status.
En combien de temps un événement de commentaire TikTok arrive-t-il ?
TikTok envoie comment.update dans les cinq minutes suivant la modification, et easyCoexistence le transmet dès sa réception.
Un événement de commentaire TikTok contient-il le texte ?
TikTok documente un champ text dans content de l'événement, à côté des identifiants du commentaire et de la publication, de l'action et de l'unique_identifier de l'auteur.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le