Table of Contents

Create Your First Discord Bot

This guide walks through the normal Picotat flow for getting a Discord bot online.

Before You Start

You need:

  1. A Picotat account
  2. A Discord account
  3. Access to the Discord Developer Portal

1. Create Your Bot in Discord

In the Discord Developer Portal:

  1. Create a new application.
  2. Open the Bot section.
  3. Add a bot to the application.
  4. Copy the bot token.

Keep the token private. Anyone with the token can control your bot.

2. Invite the Bot to Your Discord Server

Before testing the bot, invite it to the Discord server where you want it to run. If your bot will use slash commands or moderation features, make sure it has the permissions it needs.

3. Add the Bot in Picotat

In Picotat:

  1. Open the Bots section.
  2. Choose the option to create or add a bot.
  3. Enter a name you will recognize later.
  4. Paste the Discord bot token.
  5. Choose the region you want to use.
  6. Save the bot.

4. Start the Bot

Open the bot details page and click Start. The status may stay on a loading state for a short time while Picotat brings the bot online.

When the bot is ready, the status should show as online.

5. Attach a Workflow

If you want your bot to respond to commands or events, attach a workflow.

  1. Open the Workflow Designer.
  2. Create or select a workflow.
  3. Attach it to the bot.
  4. Save your changes.

Use Build Your First Workflow if you have not created one yet.

6. Test the Bot

Try a simple action in Discord after the bot is online:

  • run one of its slash commands
  • trigger the event your workflow listens for
  • check whether the bot replies the way you expect

If nothing happens, give the bot a moment and then check whether the correct workflow is attached.

Helpful Tips

  • Use clear bot names if you manage more than one bot.
  • Choose the region closest to the people using the bot most often.
  • Make small workflow changes first, then test again.
  • If you update the token in Discord, update it in Picotat too.

Need Help?

If your bot does not start or does not respond, see Troubleshooting.

Edit this page