Automações

Toda automação tem três partes: exatamente um gatilho que a inicia, condições opcionais que precisam passar antes e uma lista ordenada de ações que rodam depois. As automações podem ler dados do gatilho, como a mensagem enviada ou o membro que entrou, e reutilizá-los em condições e ações com tokens {variable}, igual aos comandos personalizados e às respostas automáticas.

Toda automação tem exatamente um gatilho: o evento que a inicia. Você pode escolher entre quase tudo o que o AutoMod observa, além de um webhook de entrada e de ser chamada por outra automação.

O gatilho Webhook de entrada dá a uma automação sua própria URL. Envie um HTTP POST de qualquer serviço externo (um serviço de formulários, um provedor de pagamentos, o seu próprio backend) e a automação roda com o corpo, os cabeçalhos e a origem da solicitação disponíveis como variáveis {http.*} em cada condição e ação.

Limites de taxa, nos dois sentidos

O endpoint público do webhook tem limite de taxa por URL e por IP de origem antes de qualquer outra coisa, incluindo consultas, verificação de assinatura e leitura do corpo. Uma enxurrada contra uma URL, ou uma varredura por várias URLs adivinhadas, não consegue deixar o resto do app lento. Além disso, toda automação tem um intervalo mínimo integrado de 1 s entre execuções, mesmo sem tempo de espera configurado, então um gatilho movimentado nunca roda sem limite.

Segurança também na saída

A ação Solicitação HTTP segue o mesmo padrão ao contrário: só URLs https:// são permitidas, o IP de destino é resolvido e verificado de novo a cada redirecionamento, e endereços de loopback, privados, link-local e de metadados da nuvem são recusados. Uma automação nunca pode ser usada para alcançar a infraestrutura interna.

As condições decidem se as ações de uma automação rodam ou não. Adicione quantas precisar e escolha se todas devem corresponder (E) ou só uma (OU). Sem nenhuma, as ações sempre rodam quando o gatilho dispara.

As ações rodam em ordem, de cima para baixo, quando as condições passam. A maioria age direto no Discord, como enviar mensagens, aplicar cargos ou punir membros. O grupo Controle de fluxo permite que uma automação ramifique, repita, espere, pare antes ou chame outra automação.

Variáveis são valores com nome (textos, números, booleanos, listas ou JSON) compartilhados no servidor inteiro e mantidos entre execuções e automações. Use a ação Definir variável para criar, incrementar, decrementar, adicionar a uma lista ou limpar uma, e leia com uma condição Variável armazenada ou com um token {variable_name} em qualquer outro lugar. Dê um TTL a uma variável e ela é zerada automaticamente quando esse tempo passa.

Toda automação roda dentro de um envelope de segurança fixo que não pode ser desligado, então um fluxo mal configurado nunca consegue derrubar seu servidor nem rodar para sempre:

Cada automação também tem seu próprio tempo de espera entre execuções e pode se desativar sozinha depois de um número de falhas seguidas, para que uma integração quebrada não continue falhando em silêncio.

A aba Testes e logs faz uma simulação da automação com um evento de exemplo fornecido por você e mostra cada etapa de gatilho, condição, controle e ação, incluindo um jeito de simular uma falha no meio, sem mexer no seu servidor. Execuções recentes guarda um histórico das execuções reais com resultado e duração.

As automações podem ser organizadas em até 20 grupos em qualquer plano.