Como funciona o Logic Nodes
O Logic Nodes é a forma mais visual de montar uma automação na Ayami: você conecta blocos num canvas, em vez de escrever código ou preencher formulários em sequência.
"Pensa nele como um quadro branco: cada nó é uma ideia, e as linhas são o caminho que ela percorre.", Ayami
O que é o Logic Nodes
O Logic Nodes é um editor visual de automações baseado em nós conectados: você arrasta blocos pro canvas — um evento, uma condição, uma ação — e liga um no outro com linhas pra desenhar o caminho que o fluxo deve seguir.
Ele faz parte do Logic Engine, o mesmo motor de automação por trás do Logic Builder e do Logic Script. A diferença é só a forma como você constrói: aqui, tudo acontece organizando nós no espaço, em vez de preencher um formulário passo a passo ou escrever comandos de texto.
Os três produtos usam o mesmo motor por trás dos panos — então o que você monta em qualquer um deles roda do mesmo jeito no seu servidor. Escolha o que fizer mais sentido pro seu jeito de pensar.
Anatomia do Canvas
Todo fluxo no Logic Nodes segue a mesma lógica: um nó de evento dispara o fluxo, ele pode passar por nós de condição que decidem se o caminho continua, e termina em nós de ação que fazem alguma coisa acontecer no seu servidor.
Exemplo simplificado: um comando dispara o fluxo, uma condição decide o caminho, e uma ação executa o resultado.
Biblioteca de Nós
Painel lateral com todos os nós disponíveis, organizados por categoria e com busca.
Propriedades
Painel que abre ao selecionar um nó, pra configurar seus campos específicos.
Conexões
Linhas que ligam um nó a outro, definindo a ordem de execução do fluxo.
Undo/Redo
Desfazer e refazer qualquer alteração no canvas, sem medo de errar.
Categorias de Nós
Os nós são organizados em 4 categorias, cada uma com uma cor própria no canvas pra facilitar a leitura visual do fluxo:
Start
Ponto inicial de fluxos que não dependem de um gatilho externo específico.
Comando
Dispara o fluxo quando alguém usa um comando de barra configurado.
Interaction Create
Dispara quando o bot recebe qualquer interação (botão, menu, etc).
IF
Bifurca o fluxo em dois caminhos, dependendo de uma condição.
Comparar Texto
Compara dois valores de texto entre si.
Comparar Número
Compara dois valores numéricos (maior, menor, igual).
Contém Texto
Verifica se um texto contém um trecho específico.
Igual
Verifica se dois valores são exatamente iguais.
Existe
Verifica se um valor existe (não é nulo ou vazio).
Enviar Mensagem
Envia uma mensagem num canal do servidor.
Editar Mensagem
Edita uma mensagem já enviada pelo bot.
Responder Interação
Responde a uma interação (botão, menu) que disparou o fluxo.
Responder Mensagem
Responde diretamente a uma mensagem, como uma citação.
Editar Resposta
Edita uma resposta de interação já enviada.
Resposta Ephemeral
Envia uma resposta visível só pra quem interagiu.
Delay
Pausa o fluxo por um tempo antes de continuar pro próximo nó.
Variável de Usuário
Lê ou grava um valor associado a um usuário específico.
Variável do Servidor
Lê ou grava um valor compartilhado por todo o servidor.
End
Marca o fim explícito de um caminho do fluxo.
Propriedades de um Nó
Ao selecionar um nó no canvas, o painel de Propriedades abre à direita com os campos específicos daquele tipo de nó — é ali que você define, por exemplo, em qual canal enviar uma mensagem ou qual texto exibir.
Assim como no Logic Builder, os campos de texto aceitam placeholders como {user} ou {guild}, que são substituídos pelos valores reais na hora que o fluxo executa.
Exemplo de Fluxo Completo
Um fluxo simples de boas-vindas, montado com 4 nós conectados em sequência:
Cada linha entre os nós representa a ordem de execução. Quando uma condição tem mais de uma saída possível (sim/não), você pode conectar caminhos diferentes a partir dela — assim como o Logic Builder permite ramificar com condições, só que aqui o caminho fica visível no próprio canvas.
Execução automática
O Logic Nodes já saiu do Beta: monte seus fluxos visualmente e eles rodam de verdade no seu servidor.
Assim que você salva um fluxo, o motor de execução já fica escutando comandos e interações (botões, menus, modais) e roda o grafo automaticamente quando o gatilho acontece.
Continua valendo a dica: se você quer algo mais rápido de montar, o Logic Builder é o caminho mais direto; se quer mais controle com código, o Logic Script. O Logic Nodes é ótimo pra fluxos visuais mais complexos e ramificados.
Pronta pra desenhar seu primeiro fluxo?
Abra o editor visual direto no dashboard do seu servidor e comece a montar.