Skip to main content
Before careers-engine can publish opportunities, it must be connected to a Discord bot with permission to send messages in your server. This guide walks through creating the bot, configuring the required permissions, and obtaining the credentials used by careers-engine.

​
Create a Discord application

Visit the Discord Developer Portal and create a new application.

Discord Developer Portal

Choose a descriptive name for your application, such as careers-engine.

​
Create a bot

Inside your application, navigate to Bot and click Add Bot. After the bot has been created, copy its token.
Treat your bot token like a password. Never commit it to Git or share it publicly.
Store the token in your local .env file.

​
Enable gateway intents

Under Bot → Privileged Gateway Intents, enable the intents required by the project. For most publishing workflows, the default intents are sufficient. Future versions of careers-engine may require additional intents depending on supported features.

​
Invite the bot

Navigate to OAuth2 → URL Generator. Select the following scopes.
  • Bot
Select the following permissions.
  • View Channels
  • Send Messages
  • Embed Links
  • Attach Files
  • Read Message History
Copy the generated URL and open it in your browser to invite the bot to your server.
The bot must be invited to the server before it can publish opportunities.

​
Obtain the channel ID

Enable Developer Mode in Discord. Then:
  1. Right-click the destination channel.
  2. Select Copy Channel ID.
Add the value to your environment configuration.

​
Verify the configuration

Your .env file should now contain at least:

​
Troubleshooting

Common issues include:
  • Invalid bot token.
  • Missing channel permissions.
  • Bot not invited to the server.
  • Incorrect channel ID.
  • Bot role positioned below the target channel permissions.

​
Next step

The Discord bot is now configured. Continue with GitHub Actions to automate job discovery and publishing.

GitHub Actions