Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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.

5 min

Plazo en el que se dispara comment.update tras crearse, eliminarse o cambiar de visibilidad un comentario o una respuesta.

72 hours

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.

comment.list

Permiso (scope) que la cuenta debe haber concedido, y mantener vigente, para que se envíen sus eventos comment.update.

At least once

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.

A forwarded comment.update event
{
  "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.
Hacerlo con EasyCoexistence

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