EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

30

Máximo de comentários que o endpoint de listagem retorna por página, incluindo os ocultos.

1,200

Caracteres que o texto de uma resposta pode ter pelo endpoint de respostas do TikTok, contados em UTF-8.

Own only

Comentários que a API pode excluir: os da própria conta. Comentários de outros usuários só podem ser ocultados.

5 min

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_rules e update_comment_rule criam, 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í.
Fazendo isso com o EasyCoexistence

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