Discord
Bot
Create the Discord application, connect the token, invite the bot to your city's server and set its name, avatar, color and emojis.
Create the Discord application, connect the token, invite the bot to your city's server and set its name, avatar, color and emojis.
The FiveDash bot is your city’s bot: you create the application on Discord, with your city’s name and avatar, and FiveDash makes it work. This page shows how to create the application, connect the token, invite the bot to your Discord server, and take care of its profile and the look of its messages. It’s for whoever sets up the organization’s bot.
| Level | What it allows |
|---|---|
| View | The bot’s profile and look (read only). The page shows “Your access only lets you view the bot.” |
| Configure | Connect, change the token and edit the profile. It’s also the level that runs the first setup and disconnects the bot. |
Open Discord in the sidebar. While the bot isn’t ready, the page shows Connect your city’s bot. The first step is Create and connect the bot.
Click Open Developer Portal. In Discord’s Developer Portal, click New Application and give it your city’s name, for example “Cidade Exemplo”.
In the application’s Bot tab, click Reset Token and copy the token.
Still in the Bot tab, under Privileged Gateway Intents, turn on Server Members Intent and Message Content Intent and save the changes on Discord.
Back in FiveDash, paste the token in Bot token and click Connect bot. The panel shows Checking token… and then Bot connected.
The panel accepts the token even with quotes, spaces or a Bot prefix. Messages you may see:
| Message | What to do |
|---|---|
| This doesn’t look like a bot token. | Copy the token from the Bot tab in the Developer Portal, not the Client Secret or the Application ID. |
| Discord rejected this token. | Generate a new one in Bot → Reset Token and paste it again. |
| This token doesn’t belong to a bot. | Use the token from an application’s Bot tab. |
| This bot is already connected to another FiveDash server. | Each bot lives in a single FiveDash server. Create another application for this server. |
| This token belongs to another bot. Disconnect the current bot before switching. | After setup is finished, you can only switch to a token of the same bot. To use another bot, disconnect the current one first. |
| Intent | Required | What it’s for |
|---|---|---|
| Server Members Intent | Yes | Seeing who’s in the server: joins, leaves, verification, welcome and roles. Without it, setup can’t be finished. |
| Message Content Intent | Recommended | Reading message text: logs, tickets (the AI attendant included), suggestions, clock-in, creators’ posts, typed whitelist answers and protection’s link and spam layers. |
The bot doesn’t ask for the presence intent.
The second step is Add it to your server.
Click Add to Discord. Discord opens the authorization screen with the permissions the bot asks for.
Pick your city’s Discord server and authorize. Keep the permissions ticked.
Go back to the FiveDash tab. The list updates on its own while it shows Waiting for the bot to join a server….
Under Where the bot joined, select the server and click Use this server. The panel shows Setting up the server…, registers the commands and moves on to the checks.
If the bot doesn’t show up, open Bot not showing up?:
To put the bot in another Discord server while still in setup, use Add to another server or Change. After setup is finished, the panel asks you to disconnect the bot before switching servers.
The invite asks for Administrator plus each permission below. That way, if someone unticks Administrator on Discord’s screen, the bot still gets the rest. Names are as in Discord’s English UI.
| Permission | Checked in step 3 |
|---|---|
| View Channels | Yes |
| Send Messages | Yes |
| Embed Links | Yes |
| Attach Files | Yes |
| Read Message History | Yes |
| Add Reactions | Yes |
| Use External Emojis | Yes |
| Manage Messages | Yes |
| Manage Channels | Yes |
| Manage Roles | Yes |
| Manage Nicknames | Yes |
| Manage Webhooks | Yes |
| Kick Members | Yes |
| Ban Members | Yes |
| Timeout Members | Yes |
| Create Public Threads | On each module’s page |
| Manage Threads | On each module’s page |
| Send Messages in Threads | On each module’s page |
| View Audit Log | On each module’s page |
| Manage Server | On each module’s page |
| Connect | On each module’s page |
| Speak | On each module’s page |
Administrator isn’t required: the check passes if the bot’s role has the 15 permissions marked “Yes”.
The third step is Check the permissions. The panel checks everything directly on Discord before turning the bot on.
| Check | Required | When it’s pending |
|---|---|---|
| Server permissions | Yes | Shows “Missing: …” with the list. Click Update permissions to authorize again. |
| Server Members Intent | Yes | Turn it on in Bot → Privileged Gateway Intents and save. Use Open Bot tab. |
| Message Content Intent | No (Recommended) | Shows Warning. Turn it on in the same screen as Server Members Intent. |
| Interactions endpoint | Yes, if Discord rejects it | FiveDash sets the address that receives commands on its own. If Discord can’t validate it, click Check again in a moment. |
| /status and /ip commands | Yes | Shows how many commands were registered. If it fails, click Add again. |
Once the required items show All good, click Finish. The panel shows “(bot name) is ready!”, suggests typing /status in any channel to try it, and offers Go to the bot’s panel. Right after, the bot shows as Starting on the overview; within a few minutes it turns Online.
Open Discord → Bot. The Bot settings page shows how the bot appears on Discord and in the messages it sends, with a Discord preview of the profile and of a reply. Changes only apply after Save in the bar that shows at the bottom (Discard undoes them).
| Field | What it does | Rules |
|---|---|---|
| Name | How the bot shows up on Discord. | 2 to 32 characters. No @, #, : or ```. No word “discord”. Discord allows changing it twice an hour. |
| Avatar | The bot’s picture. Opens a square crop. | PNG, JPG, WebP or GIF, up to 10 MB. GIFs become static. Change avatar / Remove avatar. |
| Banner | The image at the top of the profile. | Best at 680 × 240. Change banner / Remove banner. |
| About me | The bot’s profile bio. | Up to 400 characters. Supports Discord formatting: Ctrl+B for bold, Ctrl+I for italic. |
| Field | What it does | Default |
|---|---|---|
| Main color | The embeds’ side stripe and the background of the Highlight pack. Pick a ready-made color or Pick another color. | #5865F2 (Discord blue) |
| Emoji pack | The icons in the bot’s replies. | Default |
Emoji packs:
| Pack | How it looks |
|---|---|
| Default | Discord’s own emojis. |
| Lines | Thin icons, subtle on any theme. |
| Highlight | Icons on the bot’s main color. Changing the Main color redraws the pack. |
The Lines and Highlight packs are uploaded as your bot’s own emojis (application emojis) and work in any server. If Discord asks to slow down, the panel shows “Discord asked us to wait before uploading more emojis. Save again in a few seconds.”
In module texts (panels, buttons, messages), the Insert emoji button opens a picker with three tabs:
| Tab | What’s in it |
|---|---|
| Bot pack | The icons of the pack picked above, by category (Status, Highlights, People, Security, Communication, Game, Places and weather, Shop and money, Objects, Arrows and actions). |
| Common emojis | Standard emojis, with Recent, categories and Skin tone. |
| From the server | Your Discord server’s own emojis. If there are none, add them in Discord’s Server Settings → Emoji. |
On the Discord Overview, the More bot options menu (only for people with Configure on Bot) has:
If Discord rejects the saved token (for example, after a Reset Token in the Developer Portal), the overview shows Discord rejected this bot’s token and the Bot page won’t save changes. Generate a token in Bot → Reset Token and use Save new token.
Do I need to give the bot Administrator? No. The invite asks for Administrator to make things easier, but the check only requires the 15 permissions in the table.
Why won’t the bot’s name change? Discord only allows renaming twice an hour. If too many accounts already use the name, Discord rejects it and the panel asks for another one.
Is Message Content Intent required? Not to finish setup, but without it Discord hides message text. Logs, tickets, suggestions, clock-in and the link and spam protection depend on it.