Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Respostas e moderação de comentários no TikTok através da API

A API for Business do TikTok permite a uma conta ler os comentários dos seus vídeos, responder-lhes publicamente, ocultar um comentário ou voltar a mostrá-lo, e eliminar os comentários escritos pela própria conta. A leitura devolve comentários públicos e ocultos, até 30 por página, podendo incluir até três respostas a cada um, e os novos comentários podem chegar por webhook em cinco minutos.

A easyCoexistence lê os comentários do TikTok com list_social_comments, responde publicamente com reply_to_comment, oculta ou mostra com hide_comment e elimina os da conta com delete_tiktok_comment, a partir do Claude, do ChatGPT ou do seu próprio código.

30

Número máximo de comentários que o endpoint de listagem devolve por página, incluindo os ocultos.

1,200

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

Own only

Os comentários que a API pode eliminar: os da própria conta. Os comentários de outros utilizadores só podem ser ocultados.

5 min

Prazo em que o webhook de comentários do TikTok comunica que um comentário foi criado, eliminado, ocultado ou tornado público de novo.

Como se leem os comentários?

Com GET /business/comment/list/ e o ID do vídeo, o item_id na lista de vídeos da conta. Devolve comentários públicos e ocultos, até 30 por página, ordenados por gostos, respostas ou data, e include_replies acrescenta até três respostas a cada comentário; /business/comment/reply/list/ devolve uma conversa completa. Através da easyCoexistence, list_social_comments recebe o vídeo como post_id e devolve os 30 mais recentes, com até três respostas a cada um.

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 por baixo do comentário. O TikTok documenta até 1,200 caracteres de texto, contados em UTF-8, ou uma imagem em vez do texto. Através da easyCoexistence, reply_to_comment publica a resposta, e as respostas no TikTok são sempre públicas: um pedido de resposta privada é recusado.

Como se ocultam, voltam a mostrar ou eliminam comentários?

POST /business/comment/hide/ com action definido como HIDE ou UNHIDE oculta um comentário ou volta a mostrá-lo, embora o TikTok avise que um comentário retido pela moderação, pelas definições de privacidade ou por outros filtros pode continuar oculto. POST /business/comment/delete/ elimina um comentário que a própria conta escreveu; os comentários de outras pessoas podem ser ocultados, mas não eliminados. hide_comment e delete_tiktok_comment fazem o mesmo através da easyCoexistence.

Como funcionam as regras de comentários?

Uma regra de comentários responde sozinha a novos comentários, a qualquer hora: quando um comentário nos vídeos da conta, ou num vídeo escolhido, contém uma das palavras-chave da regra, a easyCoexistence publica por baixo dele a resposta da regra, em público.

  • create_comment_rule, list_comment_rules e update_comment_rule criam, listam, pausam ou eliminam regras.
  • As palavras-chave correspondem em qualquer parte do comentário, independentemente de maiúsculas ou minúsculas; uma regra sem palavras-chave corresponde a qualquer novo comentário.
  • As respostas são apenas públicas, já que as regras no TikTok não enviam mensagens privadas.
  • Até 50 regras por conta; quando várias correspondem, responde a mais antiga.
  • Um comentário chega às regras em cerca de 5 minutos, o tempo que o TikTok leva a comunicá-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 é que as automatizações respondem a comentários?

Uma automatização, configurada no painel ou através do MCP, arranca com um novo comentário, qualquer comentário ou um que tenha uma palavra-chave, em qualquer vídeo ou num vídeo escolhido. Os seus passos correm por ordem: responder com um texto fixo, responder com IA, ocultar o comentário, chamar um webhook, esperar ou parar. As respostas são públicas e têm até 150 caracteres: uma resposta fixa mais longa não pode ser guardada, e uma resposta de IA ou de webhook é cortada ao fim de uma palavra. Um comentário que corresponda a uma regra fica a cargo da regra.

O que o TikTok vigia nas respostas?

O volume. O TikTok pede às aplicações que não publiquem muitos comentários com texto muito parecido num curto espaço de tempo, pois o seu sistema pode marcá-los como spam e ocultá-los. Regras e automatizações que respondem num vídeo movimentado com um texto fixo publicam exatamente esse tipo de comentário; em vídeos movimentados, a resposta de IA de uma automatização varia a formulação.

Erros comuns

  • Tentar eliminar o comentário de outra pessoa. O TikTok só elimina os comentários escritos pela conta; oculte os outros.
  • Responder a uma rajada de comentários com o mesmo texto. O TikTok pode marcar como spam comentários muito parecidos publicados em pouco tempo e ocultá-los.
  • Chamar ferramentas de comentários sem o ID do vídeo. O TikTok precisa de post_id, o item_id do vídeo em list_social_posts, para ler, responder ou ocultar um comentário.
  • Esperar que uma regra responda no momento em que o comentário chega. O TikTok comunica os novos comentários em cerca de cinco minutos, e as respostas seguem a partir daí.
Fazer isto com a EasyCoexistence

Regras e automatizações respondem a qualquer hora. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

A API do TikTok pode eliminar comentários de outros utilizadores?

Não. O seu endpoint de eliminação só remove os comentários escritos pela própria conta, e os comentários de outras pessoas podem ser ocultados em vez disso.

Posso responder a comentários do TikTok por mensagem direta?

Não através da easyCoexistence. As respostas vão por baixo do comentário, em público, e o TikTok mantém as mensagens diretas numa Business Messaging API separada, que precisa de revisão própria.

Com que rapidez respondem as regras de comentários no TikTok?

Normalmente em cerca de cinco minutos desde o comentário, que é o tempo que o TikTok pode levar a comunicá-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 guardada, e uma resposta de IA ou de webhook é cortada ao fim de uma palavra.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em