Getting startedAdminAbout 5 min

A server admin's first 5 minutes

Invite the bot, set the trigger channel, a matchmaker and DM notices, then send your first match invite.

On this page

Before you start

Start with a Discord account that has the Manage Server permission. Point your members to A member's first 5 minutes. For a tour of the web screens, see A tour of the web console and logging in.

Note · You need
  • An account with Manage Server
  • A server to add Kletoi to
  • A few members to invite to a match

Invite the bot

Press Add to server

Press the Add to server button on kletoi.com. The invite link takes you to the same place.

Pick the server and approve

On the Discord screen, pick the server and approve the permission request. What each permission is for is in The server permissions Kletoi needs.

You are done when you see this

You are done when the Kletoi bot shows up in your server's member list.

Set up the trigger channel

When the bot joins, the server owner gets a DM and a Kletoi is in — 30 seconds to ready card is posted in a text channel. If the bot has no channel it can post in, no card appears. If you see the card, use the Discord path; if not, use the web path or the command.

@Kletoi· Direct MessageExample screen
Kletoi BOT
Kletoi installed
Auto-creates personal voice channels when users join a trigger. 1. Create a voice channel (e.g. + Create Room) 2. Run /admin set-trigger channel:#that-voice-channel 3. (Optional) /admin set-language to switch language, /admin set-hub to post a control panel Full guide: https://kletoi.com/en/guide/basics/first-five-admin
Finish setup in the web dashboardSet the trigger channel, hub and language in one place from your browser. https://kletoi.com/admin/guilds/1
Get started with matchesAssign a matchmaker and create your first match — set it all up in the web console.
Kletoi · v0.16.5
Redrawn in code from the message the bot sends. Fonts and spacing differ slightly from Discord, and Discord’s own wording may vary by version.The DM the server owner gets right after install, with the real message text.

Where do you want to do this?

In the web console

Open the web console

Web consoleHomeAdmin console

Log in at kletoi.com with Discord. On Home, press the Admin console card and pick your server.

kletoi.comv2026.10
The Kletoi Home screen — three quick-link cards side by side, the admin console card at the right end.1
Mark 1 is the Admin console card.

Choose the trigger in the setup

A server with no trigger yet opens the console on Guided setup with the trigger window already open. Pick one of three ways. Existing voice channel uses a voice channel you already have as the entrance. Create new creates a channel from a name you type once you press Create. Recommended setup in one go creates a category, a trigger, a management hub and a weekly report together. It shows what will be created first, and you can uncheck an item to leave it out.

With Existing voice channel and Create new, press Save to set the trigger. Recommended setup in one go finishes with Create these.

Note · Permission

Creating a channel needs Discord's Manage Channels permission. Manage Server alone can't create channels.

In Discord

Press Quick start on the card

When someone with Manage Server presses Quick start, a trigger voice channel ➕ Make a room is created and registered as the trigger. If there is no management hub yet, one is posted there too.

The Kletoi is in — 30 seconds to ready post the bot puts in one of your server's text channels. The first button is Quick start.
After you press it, the post changes to All set — you're live and names the trigger channel it created.

No card? Send the command

/admin set-triggerPick a voice channel you already made. Use it only when the server has no trigger yet (it deletes any existing triggers)
You are done when you see this

You are done when the trigger channel shows up in your server's voice channel list.

Check that a room gets created

Join the trigger channel

Join the voice channel ➕ Make a room (or the one you picked yourself). Your room is created and you are moved into it.

Look at the panel in the room's chat

A control panel appears in the room's chat. Rename the room, set the user limit or lock it from there.

The control panel in the room's chat.
You are done when you see this

You are done when the room appears and the panel shows up. When the last person leaves, the room disappears on its own.

Get ready for matches: matchmaker, DM notices, announce channel

Note · Good to know

There is no per-server switch for matches. Admins and the server owner can already run matches; appoint a matchmaker only to hand it to someone else. A matchmaker runs only the matches they created, while server admins run every match (Who can press what · Appointing and revoking matchmakers). To send invites as DMs, Allow bot DM notifications must be on. If the server turns on Require Riot link, only members with a linked Riot account can be added to matches. How to link is in Link and re-verify your Riot account.

Where do you want to do this?

In the web console

Appoint a matchmaker

Web consoleMembersAssign matchmaker

Pick a member and press Assign matchmaker.

In Discord

Appoint a matchmaker

/matchmaker grantPick the member

Appointing, revoking, and how a newly appointed member first opens the match screen are in Appointing and revoking matchmakers.

Turn on Allow bot DM notifications

Web consoleSettingsNew channel defaultsAllow bot DM notifications

On a new server this switch is off, and while it is off match invite DMs are not sent. Turn it on and press Save. You can see the current state in Discord. The starting state of the other switches is in Server settings at a glance.

/admin show-configLook at the Bot DM notifications line

Set a Match announce channel (optional)

Web consoleSettingsChannelsMatch announce channel

Pick a text channel and press Save. With one set, the Join buttons are posted there for members the DM cannot reach, so nobody misses the invite (Server settings at a glance).

You are done when you see this

You are done when /admin show-config shows Bot DM notifications as 🟢 On.

Create the first match and send invites

Press Create match

Web consoleMatchesCreate match

Build the teams

Add members to Team 1 and Team 2 and pick a lane for each. The match can be created once both teams are the same size (up to 5 each) and no lane repeats within a team.

Press Create — send invites

With Allow bot DM notifications on, members on the roster get an invite DM with Join, Maybe and Decline buttons. Members who blocked DMs do not get it.

@Kletoi· Direct MessageExample screen
Kletoi BOT
📣 Match #1 — () The call has been sent. Will you answer?
📣 Match #1 — the call
The call has been sent. Will you answer? Use the buttons below to accept or decline. We'll notify you again once teams are set. Times are shown in your Discord timezone. · Set timezone
When ()
Summoned Kletoi▸ Aria • Kai • Rin • Juno • Theo • Mika • Sol • Noa • Remy • Iris
Your slotTeam 1 · Top
🎟️ Tournament codeSANDBOX-TC-1
Open on the webhttps://kletoi.com/me/guilds/1/matches/1
Kletoi · v0.16.5
✅ Join ❓ Maybe ❌ Decline Open on the web
The invite DM, with the real message text.
With an announce channel set, a post like this goes there and mentions the members the DM could not reach.
Caution · If no invite went out

If Allow bot DM notifications is off and no invite reaches anyone, the match is still created and you see a notice about it. Turn on Allow bot DM notifications or set a Match announce channel. When the announce channel gets a post is in I didn't get the invite DM.

You are done when you see this

You are done when a listed member gets the invite DM. If you set an announce channel, the Join buttons for members the DM could not reach show up there.

If you get stuck

Note · Invite DMs are not going out
  • Check whether Allow bot DM notifications is off. It is off on new servers. How to turn it on is in I didn't get the invite DM.
  • A member may have blocked DMs from server members.
  • With a Match announce channel set, the Join buttons for members the DM cannot reach are posted there.
Note · The console menu is locked

Until a trigger channel is set, other menus send you back to Guided setup. Finish the trigger step above first. More is in The console is locked or commands are missing.

Caution · Quick start stops over permissions

It tells you which permissions are missing and gives a re-invite link. See The server permissions Kletoi needs for what each one does. Approving again through the invite link is also covered in The console is locked or commands are missing.

Note · No room appears
  • There is a limit on how many rooms can be open at once (per person and server-wide). At the limit the bot sends a DM. The numbers and what to do are in How many rooms can be open at once.
  • No room appears either if the bot lacks permission to create channels or move members. Check with /admin check-permissions in The server permissions Kletoi needs.

To add more triggers or change their options, see Create or change a trigger channel. To move members who keep their headphones off to the AFK channel, see AFK auto-move. Tell your members the name of the trigger channel and send them A member's first 5 minutes. If the web screens are new to you, see A tour of the web console and logging in. How to create a match is in Team balance, lanes and positions, and how it goes from invites to a confirmed result is in Run a match, step by step. To fill in the past records of linked members in one go, see Importing past records and replays; for how a member links a Riot account, see Link and re-verify your Riot account. To turn on tiers from voice time, weekly challenges and seasons, see Voice mileage, tiers and badges, Weekly challenges and Running a season and its wrap-up. All server settings are in Server settings at a glance, and result cards and share links are in Share cards and result cards. To decide whether to use Premium, see Compare plans and free-tier limits.

Check it worked

You are done when you see this

Joining the trigger channel creates a room, and members receive the invite DM for your match. That is it.

Last updated 2026-10-21
Choose language