skip to content

flow steps

a flow is arii doing something on its own when something happens, built in the dashboard's flows tab with no code. it starts with a trigger (someone joins, a message mentions a word, a button is pressed), can go through checks (only for people with a role, only at night), and does actions (send a message, give a role, wait a while). this page lists every one of them, as the flow editor names them.

triggers

what starts a flow.

members

  • someone joinsonce they're through membership screening (the rules accepted), or the moment they arrive. {event.pending} says if they're still on the rules screen.
  • a member changestheir roles, nickname, avatar, timeout, boost or screening; pick what counts. {event.before} and {event.after} hold how they were and are.
  • someone leavesthey left, were kicked or banned. {event.roles} has the roles they had.
  • someone's presence changestheir status, custom status or what they play or stream; pick what counts. needs presence turned on for the bot, and never for people who turned presence features off. a flow on it can't wait: presences are never kept.
  • reaches a levelthe levels module: by talking, in voice, or given xp. leave the levels empty for any, or write some: 5, 10, 20.
  • opens a ticketthe tickets module: from one of your panels. leave the categories empty for any, or write some: billing, bugs.
  • a ticket closesthe tickets module: its close button, /ticket, the dashboard, or nobody writing in it. {event.by} is who closed it.

moderation

  • someone is bannedby anyone, arii included.
  • someone is unbannedby anyone, arii included.
  • something is loggedwho did what, from discord's audit log: {user} did it and {event.action} is what. needs view audit log.
  • automod acts{event.rule}, {event.keyword} and {event.content} say what and why.
  • an automod rule is made{event.rule.name} is the rule.
  • an automod rule changes{event.rule.name} is the rule.
  • an automod rule is deleted{event.rule.name} was the rule.

messages

  • a message is sent{event.content} has its words (with the message content intent) and {event.link} links to it. give it words to answer only those: an auto-reply.
  • a message is edited{event.before.content} and {event.after.content} hold the old and new words.
  • a message is deleted{event.content} has its words when arii saw it in the last day.
  • messages are deleted at oncea purge: {event.count} says how many.
  • pins changea message was pinned or unpinned in {event.channel}.
  • someone starts typingdiscord says it again every few seconds while they type; a cooldown check keeps it to once.

reactions and polls

  • someone reactspick emoji and channels to narrow it down; empty means any.
  • someone takes a reaction backpick emoji and channels to narrow it down; empty means any.
  • all reactions are clearedsomeone cleared every reaction on a message.
  • an emoji's reactions are clearedsomeone cleared one emoji's reactions on a message.
  • someone votes in a poll{event.answer} is the answer's number.
  • someone takes a vote back{event.answer} is the answer's number.

voice

  • something changes in voicejoining, leaving or moving, muting, deafening, streaming or video; pick what counts. {event.before.channel} and {event.after.channel} are where they were and are.

channels and threads

  • a channel is made{event.channel} is the new channel.
  • a channel changesits name, topic, category, permissions and more. {event.before} and {event.after} hold how it was and is.
  • a channel is deleted{event.channel.name} keeps its name.
  • a thread startspick channels to only count threads started in them.
  • a thread changesrenamed, archived, reopened, locked or unlocked.
  • a thread is deleted{event.thread.name} keeps its name.
  • people join or leave a thread{event.added} are who joined.
  • webhooks changea webhook was made, changed or deleted in {event.channel}.

roles

  • a role is made{role} is the new role.
  • a role changesits name, color, permissions and more. {event.before} and {event.after} hold how it was and is.
  • a role is deleted{event.role.name} keeps its name.

the server

  • the server changesits name, icon, banner, vanity link and more. {event.before} and {event.after} hold how it was and is.
  • the emoji change{event.added} and {event.removed} are the emoji.
  • the stickers change{event.added} and {event.removed} are the stickers' names.
  • an invite is made{event.link} is the invite's link.
  • an invite is deletedor it ran out. {event.code} was its code.
  • the bot joins a serversomeone added your bot to a server. “here” is where it can talk: the server's system channel, or the first one it can write in.
  • the bot leaves a serversomeone removed your bot from a server, or the server is gone. it's no longer there, so it can send a dm, keep values and call the web; {server.name} is the server it left.

events and stages

  • an event is planned{event.scheduled} is the event.
  • an event changesit starts, ends, is cancelled, renamed or moved to another time.
  • an event is deleted{event.scheduled.name} keeps its name.
  • someone is interested in an event{event.scheduled} is the event.
  • someone isn't interested anymore{event.scheduled} is the event.
  • a stage starts{event.stage.topic} is what it's about.
  • a stage changes{event.before.topic} and {event.after.topic} are the old and new topics.
  • a stage ends{event.stage.topic} was what it was about.

on their own

  • at a timeon a schedule: once, or every few minutes, hours, days, weeks or months.
  • on a schedule, once for the botruns once for your whole bot at the times you pick, in no server: it can send a dm, keep the bot's values and call the web. to run in every server, use “at a time”.
  • a webhook is calledanother app sends JSON to this flow's own address. {event.body.<field>} reads what it sent.
  • a kept value changesa flow changed a kept value. {event.name} is which, {event.before} and {event.after} what it was and is.

commands

  • someone uses a commanda command of the server's own: as /slash, with the prefix, or from a person's or a message's menu. {args.<option>} and {args.1} read what they gave.

buttons and menus

  • a button or menu runs itin the builder, a button or menu can run this flow; {interaction.label} and {interaction.values} say what was used.

checks

what lets a flow go on, or stops it.

people

  • has a role
  • has a permission
  • is boosting
  • is in voice
  • account is old enough
  • joined long enough ago
  • is a bot
  • is someone in particular

places

  • happened in a channel

words

  • words match

values

  • compare two values
  • a value is true

time and chance

  • by chance
  • at certain times
  • not too often

actions

what a flow does.

messages

  • send a messagehere, in a channel, in their dms, replying to the message or to one an earlier step sent, or replying to the command or button (private if you like).
  • edit a messagea message arii sent; a step that sent it gives its link.
  • delete a messagethis message, one a step saved, or a link.
  • pin a messageor unpin it.
  • reactup to 20 emoji, in order.
  • forward a messageto another channel of the server.
  • publish an announcementin an announcement channel, to every server that follows it.
  • end a polla poll arii made ends now.
  • post in a foruma new post in a forum channel, with a title and a message.
  • start a giveawaythe giveaways module: posts its card in the channel now, as arii. it counts toward the giveaways your plan runs at once.
  • end a giveawaythe giveaways module: draws its winners now and tells them, as /giveaway end does.
  • draw againthe giveaways module: picks more winners of an ended giveaway, among those who didn't win.

members

  • give or take rolestoggle gives what they lack and takes what they have.
  • set a nicknameempty puts their own name back.
  • time outup to 28 days; 0 lifts it.
  • kickthey can come back with an invite.
  • banand delete up to 7 days of their messages.
  • unbanby their id.
  • move in voicemove, disconnect, mute or deafen them.
  • roles for everyonegoes through every person in the server in the background, one server at a time; bots are left as they are. the steps after it don't wait.
  • role panelthe roles module's panel: people pick roles by its rules (who may, how many, for how long). it says no for itself.
  • change xpthe levels module: give, take or set xp. their level and reward roles follow.
  • close a ticketthe tickets module: keeps its transcript, tells the person and locks it, as its close button does.

the server

  • write in the loga line in the server's log channel, naming the flow.
  • leave this serverarii leaves; nothing after it runs here anymore.
  • make a channela new channel, voice channel, forum or stage, in a category or not.
  • change a channelits name, topic or slowmode.
  • delete a channela channel picked or worked out. it can't be undone.
  • change channel permissionswhat some roles or a person may do in a channel. risky permissions can't be given.
  • start a threadin a channel, or on a message.
  • archive or lock a threadarchives, reopens, locks or unlocks a thread.
  • make a rolea new role, with a colour and permissions that aren't risky.
  • change a roleits name or colour; only roles below arii's own.
  • delete a roleonly roles below arii's own. it can't be undone.
  • make an invitean invite link to a channel, and saves it for the next steps.
  • make an eventa scheduled event of the server, in a voice channel or somewhere else.
  • turn an automod rule on or offone of the server's automod rules.

flow values

  • keep a valueworked out now, read later as {vars.name}.
  • remember a valuekeeps a value for later runs: the server's own, or one for each person.
  • recall a valuereads a value remembered earlier and saves it for the next steps.
  • count upadds to a number kept for later (nothing kept yet counts as 0).
  • add to a listadds an item at the end of a kept list, keeping its last ones.
  • forget a valueforgets a value remembered earlier.
  • make a leaderboardthe people with the highest numbers under a name, as a list for a message.
  • call a websitepremiumasks another website or app for something, or tells it something. a premium perk.