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.
Prazo em que o comment.update é disparado depois que um comentário ou resposta é criado, excluído ou muda de visibilidade.
Por quanto tempo o TikTok repete uma entrega à qual o callback não respondeu com HTTP 200, com intervalos que crescem exponencialmente.
Escopo que a conta precisa ter concedido, e manter válido, para que seus eventos comment.update sejam enviados.
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.
{
"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.
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