⭐ Guia para quem nunca mexeu nisso

Como usar o Logic Builder

Oii! Eu sou a Ayami. Vou te explicar tudo bem devagarinho, do zero — sem precisar saber nada de programação. Prometo! 💙

"Vai por partes, no seu tempo. Eu fico aqui do seu lado até você entender tudinho." — Ayami ⭐

👋

Antes de começar

Oii! Antes de mais nada, respira fundo — você não precisa saber programar. De verdade! O Logic Builder é todo feito de botões, cliques e menus. Você nunca vai precisar escrever código.

💙

Pensa nele como um joguinho de montar blocos. Você escolhe um bloco aqui, encaixa outro ali, e pronto — criou uma automação inteirinha sozinha.

Essa página vai te ensinar uma coisa de cada vez, na ordem certa. Pode ler com calma — não tem pressa nenhuma. Se quiser pular direto pra algum assunto, é só usar o menu do lado (ou, no celular, o menu lá em cima)! ⭐

📖

O que é um Fluxo?

Um Fluxo é uma regrinha automática que você cria uma vez, e a partir daí eu mesma cuido de tudo pra sempre. Você não precisa ficar fazendo nada toda vez — eu faço por você!

Imagina que você tem uma lâmpada que liga sozinha quando alguém entra no quarto. Você não aperta o interruptor — ela simplesmente sabe a hora certa de ligar. Um Fluxo funciona igualzinho, só que no seu servidor do Discord:

🚪
Alguém entra no quarto...

(no Discord: alguém manda uma mensagem, entra no servidor, clica num botão...)

🌙
Se for de noite...

(no Discord: se a pessoa tiver tal cargo, se a mensagem tiver tal palavra...)

💡
A lâmpada liga!

(no Discord: eu mando uma mensagem, dou um cargo, salvo um número...)

É só isso! Todo Fluxo, por mais complicado que pareça, é sempre essa mesma receitinha de 3 passos. Vamos ver cada passo com calma agora.

🧩

As 3 partes de um Fluxo

Todo Fluxo que você for criar tem essas 3 partinhas. Elas até têm nomes "técnicos", mas não se assusta — são só 3 palavras, e eu vou explicar cada uma a fundo logo depois:

1
O Quando
(chamado de "Trigger")

O momento que faz tudo começar. Sem ele, nada acontece.

2
🔀
O Se (opcional)
(chamado de "Condição")

Uma checagem antes de fazer algo. Pode até não ter nenhuma.

3
🎯
O Então
(chamado de "Ação")

O que eu realmente faço quando tudo bate certo.

💡

Não precisa decorar os nomes "Trigger", "Condição" e "Ação" agora — eles vão aparecer naturalmente conforme você for usando o Logic Builder. Daqui a pouco já vão ser familiares pra você!

E olha só — essas 3 partes aparecem como 3 botões dentro do painel, no Discord. É só clicar em cada um pra configurar:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:35
⚡ Boas-vindas 😊
Dá as boas-vindas pra quem entra no servidor
📌 Status: 🟢 Ativo
① O Quando
🔍 Condições: 0
② O Se
Ações: 0
③ O Então

👆 Esse é o painel de configuração — ele aparece quando você abre um Fluxo. Cada botão te leva pra configurar uma das 3 partes.

1. O Quando (Trigger)

O Quando é o ponto de partida. É a única parte obrigatória de um Fluxo — todo Fluxo tem exatamente um Quando, e ele decide a hora certa de tudo começar.

💡

Pensa nele como o "toque do despertador". Enquanto o despertador não toca, nada acontece — assim que ele toca, a sequência começa.

Aqui estão alguns "despertadores" que você pode escolher (você seleciona um deles em uma listinha, sem digitar nada):

💬

Alguém mandou uma mensagem

Toda vez que qualquer pessoa escrever em um canal.

👋

Uma pessoa nova entrou

No exato instante em que alguém entra no servidor.

🖱️

Alguém clicou num botão

Você cria um botão, e quando clicam nele, o Fluxo começa.

🔗

A mensagem tinha um link

Só começa se a mensagem enviada tiver um endereço de site.

🔊

Entrou numa chamada de voz

Quando alguém entra em um canal de voz pra conversar.

Reagiram a uma mensagem

Quando colocam um emoji de reação em alguma mensagem.

🤔

Existem mais opções de "Quando" do que essas — mas não se preocupa em decorar todas. Quando você for criar seu Fluxo, é só rolar a lista e escolher a que combina com o que você quer fazer.

Veja como fica a telinha pra escolher: você clica no botão "🎯 Trigger" no Menu do Fluxo, e abre essa lista pra você selecionar:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:36
🎯 Configurar Trigger
Escolha a categoria abaixo, depois o evento exato:
💬  Mensagens
👋  Membros
🖱️  Botões e Menus
🔊  Voz
➕  Reações
👈 clique numa categoria
🔀

2. O Se (Condição)

Depois que o Quando acontece, eu posso checar uma ou mais coisinhas antes de seguir em frente. É como um porteiro em frente a uma porta: ele só deixa passar quem está na lista.

O Se é totalmente opcional. Se o seu Fluxo não precisar checar nada, é só não colocar nenhum — eu vou direto pro Então!

Se você colocar mais de um Se, todos precisam ser verdade pra eu continuar. Se um deles falhar, eu paro ali mesmo e não faço o resto.

Alguns exemplos de "Se" que você pode escolher:

👤

A pessoa tem um cargo específico

Ex: só continua se a pessoa tiver o cargo @VIP.

🤖

Não é um robô (bot)

Pra eu não reagir em cima de outros robôs do servidor.

🔢

Um número guardado é maior que X

Ex: só continua se a pessoa já tiver 100 pontos ou mais.

📌

Está em um canal específico

Ex: só funciona dentro do canal #bate-papo.

🎲

Por sorte (chance aleatória)

Ex: só continua com 30% de chance — ótimo pra surpresas!

🔍 Veja um exemplo bem simples
⚡ Quando Alguém manda uma mensagem ✓ aconteceu
🔀 Se A pessoa não tem o cargo @Moderador ✗ ela TEM o cargo — para aqui
🎯 Então Apagar a mensagem — eu não fiz isso

Nesse exemplo, a pessoa era Moderadora — então eu parei no "Se" e não apaguei a mensagem dela. Foi assim que deveria ser! 💙

Pra adicionar um Se, clica em "🔍 Condições" no Menu do Fluxo. Abre essa telinha:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:37
🔍 Condições
Nenhuma condição adicionada ainda — sem nenhuma, o Fluxo sempre passa direto pro Então!

👆 Clicando em "➕ Adicionar Condição", abre outra lista — igualzinha à do Trigger — pra você escolher o que checar.

🎯

3. O Então (Ação)

O Então é a parte mais divertida — é o que eu realmente faço quando tudo deu certo! Você pode pedir várias coisas seguidas, e eu faço uma de cada vez, na ordem que você colocou.

💬

Mandar uma mensagem num canal

Eu escrevo algo em qualquer canal do servidor.

📩

Mandar uma mensagem privada

Eu mando uma DM direto pra pessoa, no privado.

🏷️

Dar um cargo pra alguém

Eu adiciono um cargo na pessoa automaticamente.

🗑️

Apagar a mensagem

Eu removo a mensagem que começou tudo.

📦

Guardar ou mudar um número

Eu salvo, somo ou subtraio algum valor — tipo XP ou moedas.

⏸️

Esperar um pouquinho

Eu pauso uns segundos antes de fazer a próxima coisa.

🧩

E é isso! Quando = Se = Então. As 3 partes juntas formam um Fluxo completo. A partir daqui, vamos ver coisas extras que deixam seus Fluxos ainda mais espertos.

Pra adicionar uma Ação, clica em "⚡ Ações" no Menu do Fluxo, depois em "➕ Adicionar Ação", escolhe "Enviar mensagem" e preenche essa caixinha:

📝 Enviar mensagem — configurar
#geral
Bem-vinda {user_mention}! 🌟
Salvar Ação
⚠️

Atenção, é importante saber a diferença: a telinha de configuração que você vê (os cartões escuros com botões) é só o painel onde você mexe. A mensagem que sai no final, depois que o Fluxo roda, é uma mensagem normal do Discord — sem esses cartões escuros. Veja como ela realmente aparece:

# geral
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:38
Bem-vinda @Ayami Hoshiori! 🌟

👆 Viu? Simples assim — um texto comum, igual qualquer mensagem que qualquer pessoa manda no Discord.

📦

Guardando informação (Variáveis)

Às vezes você quer que eu lembre de um número ou texto mesmo depois que o Fluxo terminar — tipo quantos pontos cada pessoa tem. Pra isso existem as Variáveis.

📝

Pensa numa variável como um post-it com um nome escrito nele. Você escreve "XP" no post-it e cola o número 340. Quando quiser saber o XP de alguém, é só olhar o post-it dela.

Existem só 2 tipos que você realmente precisa saber pra começar:

🔢 Número

Pra guardar quantidades que você quer somar ou comparar — tipo XP, moedas, nível.

Exemplo:
xp guarda 340
📝 Texto

Pra guardar palavras ou frases — tipo um nome ou o nome de um item.

Exemplo:
item_favorito guarda Espada de Fogo

Quando você cria uma variável, decide se ela é de cada pessoa (cada um tem seu próprio número, como o XP) ou do servidor inteiro (um número só que todo mundo compartilha, como um contador de mensagens). Não precisa decidir isso agora — é só uma opção que aparece na hora de criar.

Com uma variável você pode pedir pra eu:

📝

Definir um valor

Ex: colocar o XP em zero.

Somar

Ex: dar +25 de XP.

Subtrair

Ex: tirar 100 moedas.

🎲

Sortear um número

Ex: um valor aleatório entre 10 e 50.

🔖

Mensagens personalizadas (Placeholders)

Quando você escreve uma mensagem numa Ação, dá pra usar umas palavrinhas mágicas entre chaves — tipo {user} — que eu troco pelo valor de verdade na hora de enviar. Assim, cada pessoa recebe uma mensagem diferente, com o nome dela!

📝 Você escreve assim:
"Oi {user_mention}! Bem-vinda ao {guild}! ⭐"
↓ e eu transformo em:
💬 A pessoa vê assim:
"Oi @Ayami Hoshiori! Bem-vinda ao Jardim da Ayami! ⭐"

Aqui estão as palavrinhas mágicas mais usadas — não precisa decorar todas, só volta nesta tabela quando precisar:

Você escreve Eu coloco Exemplo
👤 Sobre a pessoa
{user} Nome de usuário dela Ayami Hoshiori
{user_mention} Uma menção que avisa a pessoa @Ayami Hoshiori
{user_nickname} O apelido dela no servidor Ayami ⭐
{user_avatar} O link da foto de perfil dela https://cdn.discordapp.com/...
🌐 Sobre o servidor
{guild} Nome do servidor Jardim da Ayami
{guild_members} Quantas pessoas tem no servidor 1.842
📺 Sobre o canal
{channel} Onde aconteceu #geral
📦 Suas variáveis
{var:nome} O valor que você guardou numa variável 340
🗓️ Diversos
{date} Data de hoje 19/06/2026
{aleatorio:a,b,c} Escolhe um desses valores aleatoriamente b
🎲

Dica fofa: use {aleatorio:Olá,Oi,Eai,Fala} pra eu escolher uma saudação diferente toda vez — assim as mensagens de boas-vindas não ficam repetitivas!

📨

Mensagens bonitas (Publicações)

Quando uma Ação manda uma mensagem, ela pode ser de 3 jeitos diferentes. Você escolhe qual deles usar lá no painel, e cada um fica com uma cara diferente no Discord. Vamos ver os 3:

💡

Esses 3 jeitos abaixo são diferentes do painel escuro que mostrei nas outras seções! Aquele painel escuro é só a tela onde você configura as coisas. As mensagens aqui embaixo são o que a pessoa do servidor realmente vê quando o Fluxo roda.

1

📝 Texto simples

O jeito mais básico — só um texto puro, igual qualquer mensagem que qualquer pessoa manda:

# geral
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:39
🌟 Bem-vinda ao Jardim da Ayami, @Ayami Hoshiori!

Bom pra avisos rápidos e diretos. Só não dá pra colorir nem colocar imagem dentro.

2

🎴 Embed (cartão colorido)

Se você quer algo mais bonito — com título, cor na lateral, descrição e imagem — você escolhe um Embed:

# boas-vindas
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:40
🌟 Bem-vinda, Ayami Hoshiori!
Que alegria ter você no Jardim da Ayami
Você é a nossa 842ª integrante!
Ayami acenando

No painel, você preenche cada parte do Embed separadamente:

🎨
Cor

A cor da barrinha que aparece na lateral esquerda do cartão.

📌
Título

A frase em destaque no topo do cartão.

📝
Descrição

O texto principal, logo abaixo do título.

🖼️
Imagem

Uma foto grande dentro do próprio cartão.

3

🔘 Botões e menus

Em qualquer um dos dois acima (texto ou embed), você também pode adicionar botões clicáveis por baixo da mensagem:

# boas-vindas
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:41
📖 Dá uma olhadinha nas regras antes de começar a conversar!

👆 Esses botões de verdade podem virar o Quando (Trigger) de um outro Fluxo — lembra do "Alguém clicou num botão" lá em cima? É exatamente esse tipo de botão!

Você escolhe Texto simples ou Embed direto no painel, e pode usar as palavrinhas mágicas ({user_mention}, {guild}...) em qualquer um dos dois!

🖥️

O painel do Logic Builder, passo a passo

Agora vou te mostrar o painel de verdade que abre dentro do Discord quando você usa o comando /logicbuilder. Tudo que você precisa é clicar nos botões — vou te guiar tela por tela! 💙

Passo 1

Abra o painel principal

Use o comando /logicbuilder em qualquer canal. Esse painel aparece — é a tela inicial do Logic Builder:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:33
⚡ Logic Builder 💙
Oii! Eu sou a Ayami e vou te ajudar a criar automações incríveis no Jardim da Ayami!

Com o Logic Builder você cria regras automáticas — sem precisar saber programar!
📊 Seus Fluxos
Total: 0 · Nenhum criado ainda
🔧 Comandos Personalizados
Total: 0 comandos
👉

Clica no botão verde "✨ Novo Fluxo" pra começar a criar o seu primeiro!

Passo 2

Dê um nome pro seu Fluxo

Vai abrir uma caixinha de texto (chamada de "modal"). É só preencher e enviar:

📝 Criar novo Fluxo ✨
Boas-vindas
Dá as boas-vindas pra quem entra no servidor
Enviar
✏️

Escreve qualquer nome que ajude você a lembrar do que esse Fluxo faz — tipo "Boas-vindas" ou "Anti-Link". A descrição é só pra te ajudar a organizar, pode até deixar em branco.

Passo 3

Escolha o Quando (Trigger)

Assim que você envia o nome, eu já te levo direto pra escolher o Quando. É só abrir a listinha e selecionar uma categoria:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:34
🎯 Configurar Trigger
O que é um Trigger? É o "gatilho" que faz seu Fluxo começar!

🎯 Trigger atual: nenhum definido
Escolha a categoria abaixo:
🎯 1️⃣ Escolha a categoria do Trigger
👉

Escolha, por exemplo, "Membros" — depois aparece uma segunda listinha só com eventos de membro, tipo "Um novo membro entrou". Clica nessa opção e o Trigger fica pronto!

Passo 4

O Menu do Fluxo — sua central de comando

Depois de definir o Quando, eu te levo pro Menu do Fluxo. É aqui que você adiciona Condições, Ações, e liga ou desliga seu Fluxo quando quiser:

# comandos-bot
Avatar da Ayami
Ayami Hoshiori BOT hoje às 20:35
⚡ Boas-vindas 😊
Dá as boas-vindas pra quem entra no servidor
📌 Status: 🟢 Ativo  •  🎯 Trigger: Novo membro entrou
⏱️ Cooldown: Sem cooldown
🔍 Condições: 0  •  ⚡ Ações: 0
📊 Execuções: ✅ 0 ❌ 0 (Total: 0)
🧭

Essa telinha é a "central" do seu Fluxo. Toda vez que quiser mexer em algo — trocar o Trigger, adicionar uma Condição, criar uma Ação — você sempre volta pra cá.

Passo 5

Adicione uma Ação

Clica em "⚡ Ações" no Menu do Fluxo, depois em "➕ Adicionar Ação". Escolhe a categoria (ex: "Mensagem") e depois o tipo exato (ex: "Enviar mensagem"). Por fim, é só preencher onde e o que vai ser enviado:

📝 Enviar mensagem — configurar
#boas-vindas
🌟 Bem-vinda ao {guild}, {user_mention}! ⭐
Salvar Ação

Pronto! Seu Fluxo já está completo: Quando alguém entra no Jardim da Ayami, eu mando essa mensagem de boas-vindas automaticamente. Você pode voltar ao Menu do Fluxo e adicionar quantas Ações e Condições quiser!

🔗

Ligando dois Fluxos (Evento Personalizado)

Às vezes você quer que dois Fluxos trabalhem juntos — tipo ganhar XP e, quando bater um número, subir de nível automaticamente. Pra isso existe o Evento Personalizado: um Fluxo "chama" o outro.

🔗

Num Fluxo você usa a Ação "Chamar outro fluxo". No outro Fluxo, você usa "Evento personalizado" como o Quando dele — ele fica esperando ser chamado.

Fluxo 1 — Ganha XP
⚡ Mensagem enviada
📦 xp += número aleatório (10–40)
⚡ Chama o Fluxo 2
chama
Fluxo 2 — Sobe de Nível
⚡ Foi chamado pelo Fluxo 1
🔀 xp é maior que 1000?
💬 "Parabéns, subiu de nível! ⭐"

O Fluxo 1 roda toda vez que alguém manda mensagem e vai juntando XP. Quando termina, chama o Fluxo 2 — que confere se já é hora de subir de nível. Cada um cuidando da sua parte! ✨

🚀

Exemplos prontos pra copiar

Chega de explicação — agora vamos ver Fluxos completos que você pode montar agora mesmo! Clica em cada um pra abrir e ver o passo a passo. ✨

👋
Boas-vindas
Dá um cargo e manda uma mensagem quando alguém entra
📋 Um Fluxo só — "Boas-vindas"
1
⚡ Quando Uma pessoa nova entrou no servidor
2
🎯 Então Dar o cargo @Membro pra ela
3
🎯 Então Mandar mensagem no canal #boas-vindas
💬 A mensagem fica assim:
"🌟 Bem-vinda ao {guild}, {user_mention}! Você é a nossa {count}ª integrante! ⭐"
Sistema de XP
Dois fluxos juntos: um soma XP, outro detecta o level up
📦

Antes de tudo, crie uma variável chamada xp (número, começa em 0).

📋 Fluxo 1 — "Ganhar XP"
1
⚡ Quando Alguém manda mensagem
2
📦 Então Somar XP aleatório (10 a 40)
3
🎯 Então Chamar o Fluxo 2
📋 Fluxo 2 — "Verificar Nível"
1
⚡ Quando Fluxo 1 chamou
2
🔀 Se O xp é maior que 1000
3
🎯 Então Mandar mensagem de parabéns
💬 Mensagem de level up:
"🌟 Parabéns {user_mention}! Você subiu de nível! ⭐"

Pronta pra criar o seu? ⭐

Adicione a Ayami ao seu servidor, use /logicbuilder e o Logic Builder já vai estar esperando por você!