Skip to content
Docs | Val Town

Discord welcome bot

You can create a Discord welcome bot using scheduled vals.

In this example, a scheduled val gets the most recent members for your server and sends a DM to new users from a bot that you’ll create. It avoids messaging users who joined the server before the bot was added.

When users reply to the bot, the message is forwarded as a DM.

Create a new Discord application

Visit https://discord.com/developers/applications:

create-an-app.png

Enable the server members intent

Since the bot will be requesting a list of guild members, you need to enable the SERVER MEMBERS INTENT on the Bot tab.

Screenshot 2023-06-20 at 23.35.01.png

Get your bot’s token

On the Bot tab, copy the TOKEN, and save it as a Val Town environment variable as discordBot.

Screenshot 2023-06-16 at 22.05.23.png

On the OAuth2 tab, under URL Generator, select the bot scope, and give it permission to Send Messages, and then copy the GENERATED URL at the bottom of the page.

Screenshot 2023-06-20 at 21.45.54.png

Choose the server you want to invite the bot to and press Continue.

Screenshot 2023-06-20 at 15.27.42.png

Get your Server ID

Save your server id as a Val Town environment variable as discordServerId. (See: Where can I find my User/Server/Message ID?)

Setup your welcome message scheduled val

Fork this scheduled val that will send a welcome message to new users.

This val stores state in three other vals.

  • @me.discordWelcomeBotStartedAt stores the timestamp of the bot’s creation so that everyone who’s already on the server doesn’t get a welcome message when the bot is added.
  • @me.discordWelcomedMembers stores the ids of everyone that has been messaged so that they don’t receive another message.
  • @me.discordDMs stores the channel ids (each time the bot DMs a user it creates a channel) so that we can check for replies to the bot.

These vals will be automatically created if they don’t already exist.

Get your User ID

Save your user id as a Val Town environment variable as discordUserId. (See: Where can I find my User/Server/Message ID?)

This is so the bot knows where to forward user replies.

Set up your message forwarder scheduled val

Fork this scheduled val that will forward user replies to your Discord user.

This val loops through all of the DMs between the bot and new users. It checks for any new replies and then forwards these messages as a new DM (from the bot, to your Discord user).