EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Eventos de webhook de comentários do TikTok

A API for Business do TikTok envia um webhook comment.update em até cinco minutos depois que um comentário ou resposta é criado, excluído, ocultado, definido como visível só para amigos ou tornado público nas publicações de foto e nos vídeos públicos de uma conta. Cada evento informa o comentário, a publicação, a ação, o identificador de quem comentou e o texto, e vem assinado com o cabeçalho Tiktok-Signature.

O easyCoexistence repassa cada evento de comentário do TikTok da conta ao seu endpoint HTTPS assim que ele chega, assinado com um segredo daquela conta e sem guardar cópia.

5 min

Prazo em que o comment.update é disparado depois que um comentário ou resposta é criado, excluído ou muda de visibilidade.

72 hours

Por quanto tempo o TikTok repete uma entrega à qual o callback não respondeu com HTTP 200, com intervalos que crescem exponencialmente.

comment.list

Escopo que a conta precisa ter concedido, e manter válido, para que seus eventos comment.update sejam enviados.

At least once

Garantia de entrega do TikTok: o mesmo evento pode chegar mais de uma vez, então o tratamento deve ser idempotente.

O que o comment.update informa?

Mudanças nos comentários das publicações de foto e dos vídeos públicos da conta, publicados pela API ou pelo app do TikTok. O campo comment_action indica o que aconteceu:

  • insert: um comentário ou resposta foi criado.
  • delete: foi excluído.
  • set_to_hidden: foi ocultado, por um usuário ou pela moderação.
  • set_to_friends_only: passou a ser visível só para amigos.
  • set_to_public: deixou de estar oculto ou restrito a amigos e passou a ser visível para todos.

O que um evento traz?

O TikTok envia, via POST, um JSON com client_key, event, create_time, user_openid, que é o ID da conta, e content, uma string JSON serializada. Dentro de content vêm comment_id e video_id, parent_comment_id nas respostas, comment_type (comment ou reply), comment_action, um timestamp, o unique_identifier de quem comentou e o texto. Os IDs são números JSON grandes demais para um double representar com exatidão, então leia-os direto da string bruta.

Como os eventos chegam ao seu endpoint?

O TikTok envia os webhooks ao app de desenvolvedor, por uma única URL de callback para o app inteiro. O easyCoexistence os recebe e repassa cada comment.update de uma conta conectada ao endpoint HTTPS que você definiu para ela, uma única vez, assim que chega, assinado com o segredo próprio daquela conta. Defina o endpoint com set_social_webhook_destination pelo Claude ou pelo ChatGPT, ou pela Partner API com PUT /channels/:id/webhook; o segredo é exibido uma única vez, e uma URL nula desativa o repasse.

Como é um evento repassado?

Um POST com a plataforma, o account_id que list_social_accounts informa para a conexão, o external_id da conta, que é o open_id do TikTok, e entry: o nome do evento, create_time e content, com content já desserializado e os IDs convertidos em strings para que nenhum seja arredondado.

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>"
    }
  }
}

Como verificar um evento repassado?

Cada entrega repassada traz um cabeçalho X-EC-Signature, t=<unix>,v1=<hex>, em que v1 é um HMAC-SHA256 do timestamp, de um ponto e do corpo bruto, usando como chave o segredo de assinatura da conta. Recalcule a assinatura sobre o corpo exatamente como chegou, compare os dois valores em tempo constante e recuse timestamps com mais de 5 minutos.

Uma entrega é repetida?

Não pelo easyCoexistence. Cada evento é repassado uma vez, em memória, sem cópia guardada para repetir depois; o repasse aguarda 8 segundos por uma resposta e não segue redirecionamentos. Na origem, o TikTok repete as próprias entregas por até 72 horas e garante ao menos uma, então o mesmo evento pode chegar duas vezes: deduplique pela combinação de comment_id e comment_action.

Erros comuns

  • Converter os IDs em números. comment_id e video_id são maiores do que um double representa com exatidão; o easyCoexistence os repassa como strings, então mantenha-os assim.
  • Calcular a assinatura sobre uma cópia desserializada do corpo. O HMAC cobre o corpo bruto exatamente como foi entregue, e serializá-lo de novo quebra a correspondência.
  • Processar duas vezes um evento repetido. O TikTok entrega ao menos uma vez, então use comment_id e comment_action como chave antes de agir.
  • Apontar o destino para um endereço que redireciona. O repasse não segue redirecionamentos, então informe a URL HTTPS final.
Fazendo isso com o EasyCoexistence

Ative com set_social_webhook_destination pelo Claude ou pelo ChatGPT, ou pela Partner API. De R$ 29,90 a R$ 3,90 por conexão por mês, valor que cai conforme você adiciona conexões, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Quais eventos de webhook do TikTok são repassados?

O comment.update, para comentários e respostas nas publicações da conta conectada: criados, excluídos, ocultados, definidos como visíveis só para amigos ou tornados públicos.

Os eventos de publicação do TikTok também são repassados?

Não. O repasse cobre eventos de comentário; para acompanhar a publicação de um post, use get_tiktok_publish_status.

Quanto tempo leva para chegar um evento de comentário do TikTok?

O TikTok envia o comment.update em até cinco minutos após a mudança, e o easyCoexistence o repassa assim que ele chega.

O evento de comentário do TikTok inclui o texto do comentário?

O TikTok documenta um campo text no content do evento, junto com os IDs do comentário e da publicação, a ação e o unique_identifier de quem comentou.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em