Respostas e moderação de comentários do TikTok pela API
A API for Business do TikTok permite que uma conta leia os comentários dos seus vídeos, responda publicamente abaixo deles, oculte um comentário ou volte a exibi-lo e exclua comentários escritos pela própria conta. A leitura retorna comentários públicos e ocultos, até 30 por página, opcionalmente com até três respostas cada, e novos comentários podem chegar por webhook em até cinco minutos.
O easyCoexistence lê comentários do TikTok com list_social_comments, responde publicamente com reply_to_comment, oculta ou volta a exibir comentários com hide_comment e exclui os da própria conta com delete_tiktok_comment, a partir do Claude, do ChatGPT ou do seu próprio código.
Máximo de comentários que o endpoint de listagem retorna por página, incluindo os ocultos.
Caracteres que o texto de uma resposta pode ter pelo endpoint de respostas do TikTok, contados em UTF-8.
Comentários que a API pode excluir: os da própria conta. Comentários de outros usuários só podem ser ocultados.
Prazo em que o webhook de comentários do TikTok informa que um comentário foi criado, excluído, ocultado ou voltou a ser público.
Como os comentários são lidos?
Com GET /business/comment/list/ e o ID do vídeo, que é o item_id da lista de vídeos da conta. O endpoint retorna comentários públicos e ocultos, até 30 por página, ordenados por curtidas, respostas ou data, e include_replies acrescenta até três respostas a cada comentário; /business/comment/reply/list/ retorna uma thread completa. Pelo easyCoexistence, list_social_comments recebe o vídeo como post_id e retorna os 30 mais recentes, com até três respostas cada.
Como funcionam as respostas públicas?
POST /business/comment/reply/create/ com o ID do vídeo, o ID do comentário e o texto publica uma resposta abaixo do comentário. O TikTok documenta até 1.200 caracteres de texto, contados em UTF-8, ou uma imagem no lugar do texto. Pelo easyCoexistence, reply_to_comment publica a resposta, e as respostas no TikTok são sempre públicas: uma requisição de resposta privada é recusada.
Como ocultar, voltar a exibir ou excluir comentários?
POST /business/comment/hide/ com action definido como HIDE ou UNHIDE oculta um comentário ou volta a exibi-lo, embora o TikTok avise que um comentário retido pela moderação, pelas configurações de privacidade ou por outros filtros pode continuar oculto. POST /business/comment/delete/ exclui um comentário escrito pela própria conta; comentários de outras pessoas podem ser ocultados, mas não excluídos. hide_comment e delete_tiktok_comment fazem o mesmo pelo easyCoexistence.
Como funcionam as regras de comentário?
Uma regra de comentário responde sozinha a novos comentários, 24 horas por dia: quando um comentário nos vídeos da conta, ou em um vídeo específico, contém uma das palavras-chave da regra, o easyCoexistence publica a resposta da regra abaixo dele, em público.
create_comment_rule,list_comment_ruleseupdate_comment_rulecriam, listam, pausam ou excluem regras.- As palavras-chave são reconhecidas em qualquer parte do comentário, sem diferenciar maiúsculas e minúsculas; uma regra sem palavras-chave vale para qualquer novo comentário.
- As respostas são apenas públicas, já que as regras no TikTok não enviam DMs.
- Até 50 regras por conta; quando várias se aplicam, a mais antiga responde.
- Um comentário chega às regras em cerca de 5 minutos, o tempo que o TikTok leva para informá-lo.
- As regras respondem a novos comentários de primeiro nível, não a respostas, e ignoram os comentários da própria conta.
Como as automações respondem a comentários?
Uma automação, configurada no painel ou pelo MCP, é disparada por um novo comentário, seja qualquer comentário ou um que contenha uma palavra-chave, em qualquer vídeo ou em um vídeo específico. Os passos são executados em ordem: responder com um texto fixo, responder com IA, ocultar o comentário, chamar um webhook, aguardar ou encerrar. As respostas são públicas e têm até 150 caracteres: uma resposta fixa mais longa não pode ser salva, e uma resposta de IA ou de webhook é cortada sem quebrar palavras. Um comentário que se encaixa em uma regra fica a cargo da regra.
O que o TikTok observa nas respostas?
O volume. O TikTok pede que os apps não publiquem muitos comentários com textos muito parecidos em pouco tempo, porque o sistema pode marcá-los como spam e ocultá-los. Regras e automações que respondem em um vídeo movimentado com um único texto fixo publicam exatamente esse tipo de comentário; em vídeos movimentados, a resposta por IA de uma automação varia o texto.
Erros comuns
- Tentar excluir o comentário de outra pessoa. O TikTok só exclui comentários escritos pela conta; oculte os demais.
- Responder a uma enxurrada de comentários com o mesmo texto. O TikTok pode marcar como spam comentários muito parecidos publicados em sequência e ocultá-los.
- Chamar as ferramentas de comentário sem o ID do vídeo. O TikTok precisa do post_id, o item_id do vídeo retornado por list_social_posts, para ler, responder ou ocultar um comentário.
- Esperar que uma regra responda no instante em que o comentário chega. O TikTok informa novos comentários em cerca de cinco minutos, e as respostas vêm a partir daí.
Regras de comentário e automações respondem 24 horas por dia. De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e 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
A API do TikTok pode excluir comentários de outros usuários?
Não. O endpoint de exclusão remove apenas comentários escritos pela própria conta; os comentários de outras pessoas podem ser ocultados.
Posso responder comentários do TikTok por DM?
Não pelo easyCoexistence. As respostas ficam abaixo do comentário, em público, e o TikTok mantém as mensagens diretas em uma API separada, a Business Messaging API, que exige uma análise própria.
Em quanto tempo as regras de comentário respondem no TikTok?
Normalmente em cerca de cinco minutos após o comentário, que é o tempo que o TikTok pode levar para informá-lo por webhook.
Qual o tamanho máximo de uma resposta automática no TikTok?
Até 150 caracteres. Uma resposta fixa mais longa não pode ser salva, e uma resposta de IA ou de webhook é encurtada sem quebrar palavras.
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