Moderação

As ferramentas para manter a conversa saudável. Todas funcionam em três lugares: no painel, direto no widget (para moderadores logados) e pela API de gerência.

Quem pode moderar

Quem	Onde modera	O que pode
Dono do site	Painel, widget e API	Tudo, inclusive configurações, chaves e moderadores.
Moderador adicionado no painel	Painel e widget	Aprovar, apagar, fixar, banir, trancar conversas e resolver denúncias. Não mexe em configurações nem em chaves.
Usuário com `mod: true` no token do seu site	Widget	As mesmas ações de moderador, direto na página.
Seu servidor, com a chave secreta	API de gerência	Tudo o que o dono pode.

Para adicionar um moderador, a pessoa precisa ter uma conta Qorum. Em Configurações, digite o usuário dela em Adicionar moderador.

Aprovação antes de publicar

Em Configurações, escolha quando um comentário precisa ser aprovado antes de aparecer:

Opção	Vai para a fila
Não: publica na hora	Só o que tiver palavra bloqueada.
Só comentários com link ou imagem	Comentários com endereço de site ou imagem anexada, mais os com palavra bloqueada.
Tudo passa por aprovação	Todos os comentários.

Comentários de moderadores nunca vão para a fila. Quem comentou vê o aviso "Seu comentário foi enviado e aparece depois que a moderação aprovar".

Enquanto está na fila, o comentário não aparece para ninguém, não conta no total da conversa, não gera notificação e não dispara webhook. Ao ser aprovado, ele aparece com a data em que foi escrito, e só aí contam o total, a notificação e o webhook. Ao ser recusado, ele é apagado sem aviso para ninguém.

A fila fica em Moderação → Pendentes no painel, ou em GET /v1/site/comments?status=pending.

Palavras bloqueadas

Uma palavra ou expressão por linha. Se o comentário contiver alguma delas, em qualquer lugar do texto e sem diferenciar maiúsculas, ele vai para a fila em vez de aparecer. Cuidado com palavras curtas: "ass" também pega "assinatura".

Ao editar um comentário já publicado, o texto novo não pode ter palavra bloqueada. A edição é recusada com a mensagem "O texto tem uma palavra bloqueada neste site".

Denúncias

Qualquer pessoa logada pode denunciar o comentário de outra, escolhendo um motivo. Cada pessoa denuncia o mesmo comentário uma vez só. A denúncia aparece em Moderação → Denúncias, e o seu servidor recebe o webhook comment.reported.

Para cada denúncia você pode:

Apagar o comentário: apaga e marca todas as denúncias dele como resolvidas.
Ignorar a denúncia: o comentário fica, e as denúncias dele saem da lista.
Banir o autor, junto ou separado.

Banimento

Banir impede a pessoa de comentar, responder e enviar imagem no site. Ela continua lendo e curtindo. Os prazos no painel e no widget são 1 dia, 7 dias, 30 dias ou para sempre. Pela API, você escolhe as horas. Banir de novo substitui o banimento anterior.

Quem está banido vê, no lugar da caixa de comentário: "Você está banido de comentar até 15/03/2027 18:00. Motivo: ...". A hora é a de Brasília.

A lista de banidos fica em Moderação → Banidos, com o botão para desbanir.

Apagar

O autor apaga os próprios comentários. Moderadores apagam qualquer um. Apagar um comentário principal apaga as respostas dele junto. O comentário apagado some para todos, mas continua no painel em Moderação → Apagados, de onde dá para restaurar.

Conversa trancada

Trancar uma conversa impede comentários novos nela, sem apagar nada. Os leitores veem "Os comentários desta conversa estão fechados". Moderadores ainda conseguem comentar. Tranque e destranque em Moderação → Conversas ou com PUT /v1/site/threads/lock.

Comentário fixado

Comentários fixados aparecem no topo da conversa, com o selo "Fixado". Só comentários principais podem ser fixados, nunca respostas.

Moderadores fixam qualquer comentário pelo menu do comentário. Pela API, escolha por quantas horas (padrão 24).
Leitores fixam o próprio comentário por 24 horas se você liberar o benefício fixar_comentario para eles. Use isso para assinantes ou clientes: POST /v1/site/users/:id/entitlements com {"item": "fixar_comentario", "quantity": 1}. Cada uso gasta uma unidade, e -1 deixa ilimitado.

Proteção contra spam

Estes limites ficam sempre ligados e não valem para moderadores. Eles ficam bem acima do que gente de verdade faz, então só seguram robô e quem cola a mesma coisa em todo lugar:

Limite	Valor
Tempo entre comentários da mesma pessoa	5 segundos
Ações por pessoa (comentar, curtir, editar, denunciar...)	30 por minuto
Comentários por pessoa	150 por hora e 1000 por dia
O mesmo texto na mesma conversa	Recusado por 10 minutos
O mesmo texto (25 caracteres ou mais, ou com link) em várias páginas	Recusado a partir da 4ª página em 10 minutos
Envio de imagens por pessoa	20 a cada 10 minutos
Pedidos por endereço IP	25 por segundo (picos de até 120)

Texto curto como "valeu!" pode repetir entre páginas: tem gente que agradece em todo capítulo. O comentário recusado recebe 429 com uma mensagem dizendo qual limite foi atingido.

Boas práticas

Comece com a aprovação em "Só comentários com link ou imagem". É onde aparece a maior parte do spam.
Adicione moderadores em vez de dividir a sua senha. Cada um entra com a própria conta.
Use o webhook comment.reported para avisar a equipe no canal que vocês já usam.
Prefira banimentos com prazo. O banimento para sempre fica para casos repetidos.