Eventos webhook de comentarios de TikTok
La API for Business de TikTok envía un webhook comment.update en un plazo de cinco minutos desde que se crea, elimina, oculta, limita a amigos o hace público un comentario o una respuesta en las publicaciones de fotos y los videos públicos de una cuenta. Cada evento indica el comentario, la publicación, la acción, el identificador de quien comenta y el texto, y va firmado con un encabezado Tiktok-Signature.
easyCoexistence reenvía cada evento de comentario de TikTok de la cuenta a tu endpoint HTTPS en cuanto llega, firmado con un secreto propio de esa cuenta y sin guardar ninguna copia.
Plazo en el que se dispara comment.update tras crearse, eliminarse o cambiar de visibilidad un comentario o una respuesta.
Durante cuánto tiempo reintenta TikTok una entrega a la que su URL de callback no respondió con HTTP 200, espaciando los intentos de forma exponencial.
Permiso (scope) que la cuenta debe haber concedido, y mantener vigente, para que se envíen sus eventos comment.update.
Garantía de entrega de TikTok: el mismo evento puede llegar más de una vez, así que el procesamiento debe ser idempotente.
¿Qué informa comment.update?
Los cambios en los comentarios de las publicaciones de fotos y de los videos públicos de la cuenta, tanto si se publicaron a través de la API como en la app de TikTok. comment_action indica qué ocurrió:
- insert: se creó un comentario o una respuesta.
- delete: se eliminó.
set_to_hidden: se ocultó, por parte de un usuario o mediante moderación.set_to_friends_only: pasó a ser visible solo para amigos.set_to_public: pasó de oculto o solo para amigos a visible para todos.
¿Qué contiene cada evento?
TikTok envía por POST un JSON con client_key, event, create_time, user_openid, que es el ID de la cuenta, y content, una cadena JSON serializada. Dentro de content: comment_id y video_id, parent_comment_id en las respuestas, comment_type (comment o reply), comment_action, una marca de tiempo, el unique_identifier de quien comenta y el texto. Los IDs son números JSON demasiado grandes para que un double los represente con exactitud, así que léelos de la cadena sin procesar.
¿Cómo llegan los eventos a tu endpoint?
TikTok envía los webhooks a la app de desarrollador, a través de una única URL de callback para toda la app. easyCoexistence los recibe y reenvía cada comment.update de una cuenta conectada al endpoint HTTPS que configures para ella, una sola vez y en cuanto llega, firmado con el secreto propio de esa cuenta. Configura el endpoint con set_social_webhook_destination desde Claude o ChatGPT, o con la Partner API mediante PUT /channels/:id/webhook; el secreto se muestra una sola vez, y una URL nula desactiva el reenvío.
¿Cómo es un evento reenviado?
Un POST con la plataforma, el account_id que list_social_accounts asigna a la conexión, el external_id de la cuenta, que es el open_id de TikTok, y entry: el nombre del evento, create_time y content, con content ya parseado y sus IDs convertidos en cadenas para que ninguno se redondee.
{
"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>"
}
}
}¿Cómo se verifica un evento reenviado?
Cada entrega reenviada incluye un encabezado X-EC-Signature, t=<unix>,v1=<hex>, donde v1 es un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar, calculado con el secreto de firma de la cuenta como clave. Recalcúlalo sobre el cuerpo exactamente como llegó, compara ambos valores en tiempo constante y rechaza cualquier marca de tiempo con más de 5 minutos de antigüedad.
¿Se reintentan las entregas?
easyCoexistence no las reintenta. Cada evento se reenvía una sola vez, en memoria, sin guardar ninguna copia desde la que reintentar; el reenvío espera 8 segundos una respuesta y no sigue redirecciones. En origen, TikTok reintenta sus propias entregas hasta 72 horas y garantiza al menos una, así que el mismo evento puede llegarte dos veces: deduplica por comment_id junto con comment_action.
Errores comunes
- Parsear los IDs como números. comment_id y video_id son más grandes de lo que un double representa con exactitud; easyCoexistence los reenvía como cadenas, así que mantenlos así.
- Calcular la firma sobre una copia ya parseada del cuerpo. El HMAC cubre el cuerpo sin procesar tal como se entregó, y volver a serializarlo hace que no coincida.
- Procesar dos veces un evento repetido. TikTok entrega al menos una vez, así que usa comment_id y comment_action como clave antes de actuar.
- Apuntar el destino a una dirección que redirige. El reenvío no sigue redirecciones, así que indica la URL HTTPS final.
Actívalo con set_social_webhook_destination desde Claude o ChatGPT, o con la Partner API. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Qué eventos webhook de TikTok se reenvían?
comment.update, para los comentarios y respuestas en las publicaciones de la cuenta conectada: creados, eliminados, ocultados, limitados a amigos o hechos públicos.
¿También se reenvían los eventos de publicación de TikTok?
No. El reenvío incluye eventos de comentarios; para seguir la publicación de un contenido, usa get_tiktok_publish_status.
¿Cuánto tarda en llegar un evento de comentario de TikTok?
TikTok envía comment.update en un plazo de cinco minutos tras el cambio, y easyCoexistence lo reenvía en cuanto lo recibe.
¿Un evento de comentario de TikTok incluye el texto?
TikTok documenta un campo text en el content del evento, junto a los IDs del comentario y de la publicación, la acción y el unique_identifier de quien comenta.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el