Gatilhos — automação se-então sem código para o seu grupo

1O que são os gatilhos

Um gatilho é uma regra que você monta no painel: quando uma condição é atendida, faça uma ação. É a forma sem código de automatizar a moderação e as respostas de que a sua comunidade precisa, sem um desenvolvedor.

Os gatilhos rodam antes do motor antispam — as regras do dono sempre têm prioridade. Isso significa que um gatilho pode liberar uma mensagem ou agir sobre ela antes que qualquer verificação automática a toque, o que torna os gatilhos a ferramenta certa para sobreposições rígidas e para respostas automatizadas, não só moderação.

2Modos de correspondência — quando um gatilho dispara

Você escolhe como o gatilho reconhece uma mensagem:

• all — qualquer mensagem (use com condições para construir comportamentos como somente anúncios).
• commands — apenas comandos de barra (/...).
• mentions — apenas mensagens que mencionam alguém (@...).
• exact — o texto corresponde exatamente.
• contains — o texto contém uma frase.
• regex — uma expressão regular, para controle total de padrão.

3Ações — o que um gatilho faz

Quando um gatilho dispara, ele executa uma ação principal:

• reply — publica uma resposta, opcionalmente com botões inline e espaços reservados.
• delete — remove a mensagem.
• warn — emite um aviso que conta para o limite de avisos do grupo.
• mute — silencia o remetente por uma duração definida.
• ban — bane o remetente.
• kick — remove o remetente sem um banimento permanente, então ele pode entrar de novo.

4Opções extras em qualquer gatilho

Além da ação principal, um gatilho pode carregar estas opções — então um único gatilho pode, por exemplo, responder com botões, apagar o original e chamar os admins tudo de uma vez:

• Apagar o original — remove a mensagem que disparou, mesmo quando a ação principal é uma resposta.
• Notificar admins — alerta a equipe de admins quando o gatilho dispara.
• Registrar a ação — registra o disparo do gatilho em um canal.
• Duração do silenciamento — quanto tempo uma ação de mute dura, em segundos.
• Botões inline — anexa botões clicáveis a uma resposta (um link de documentação, um mapa de canais, um botão de regras).
• Espaços reservados — {username}, {user_id}, {group_id} e {message_id} são substituídos no texto da resposta.

5Condições extras

Você pode combinar condições adicionais para tornar um gatilho preciso. Empilhe-as para descrever exatamente a situação que você quer — por exemplo, membro novo E tem links:

• Somente membro novo — o autor é um novato.
• Faixa de contagem de mensagens — a contagem total de mensagens do autor está acima ou abaixo de um limite.
• Tipo de conteúdo — texto, foto, vídeo, documento e assim por diante.
• Tem mídia / tem links — a mensagem contém ou não cada um.
• É encaminhamento / é resposta — se a mensagem é um encaminhamento ou uma resposta.
• De um bot — se o remetente é um bot.

6Receitas prontas

Alguns padrões que os grupos montam com mais frequência:

• Resposta automática de FAQ — contains como configuro → responde com as instruções e um botão de documentação.
• Escudo contra concorrentes — contains o domínio ou a marca de um rival → delete mais warn.
• Guarda de links de novatos — membro novo E tem links → delete mais mute.
• Navegador de boas-vindas — contains por onde começo → responde com um mapa de canais e botões.
• Escalar para admins — contains urgente ou pagamento não funciona → reply mais notificar admins.
• Somente anúncios — modo all com uma condição de não-admin → delete, então só posts de admin permanecem.

7Gatilhos, regras personalizadas e ordem de atuação

Os gatilhos e as regras personalizadas se sobrepõem, mas ficam em pontos diferentes. Os gatilhos rodam primeiro, antes do motor antispam, e são melhores para respostas automatizadas e sobreposições rígidas. As regras personalizadas rodam como parte da pontuação antispam e são melhores para acrescentar peso a uma decisão de spam.

Como os gatilhos rodam primeiro, um gatilho que libera ou age sobre uma mensagem a resolve antes de qualquer verificação automática — então use gatilhos quando precisar de certeza sobre o que acontece, e regras quando quiser contribuir para o julgamento do motor.

8Boas práticas e erros comuns

Mantenha os gatilhos confiáveis com alguns hábitos:

• Dê aos gatilhos mais precisos uma prioridade mais alta para que um amplo não dispare primeiro.
• Teste gatilhos de regex em frases reais; contains muitas vezes basta e é mais fácil de raciocinar.
• Tenha cuidado com o modo all — combine-o com uma condição, ou ele agirá sobre toda mensagem.
• Lembre-se de que os gatilhos rodam antes do motor, então um gatilho de delete amplo demais pode remover boas mensagens que o motor teria permitido.
• Use o registro para ver qual gatilho disparou em uma mensagem específica.