Discord

The Discord integration lets you programmatically interact with Discord to read/send messages, manage channels, automate community interactions and much more.

How to connect

Method	Type	Description
BYO Discord Bot	Bot Token	Custom app with complete control over the permission set and branding

Helios bot is not supported for Discord due to permissions limitations.

BYO Discord Bot

Create your own Discord bot application for interacting with Discord through Helios.

Setup Steps

Go to Discord Developer Portal.

Click New Application and give it a name.

Navigate to the 'Installation' section and scroll to the bottom of the page to the 'Default Install Settings'.

Click on the Guild Install scope dropdown > Select 'bot' from the scope list. Default Install Settings - Update Guild Install

A new permissions section will show up for the Guild Install. Click on the dropdown and select the appropriate permissions for your bot. You can either give the bot exact permission set or you can give it 'Administrator' permission. 'Administrator' permission has complete access to the Discord API. Finally, click 'Save Changes'. Default Install Settings - Add bot permissions

Discord should give you a confirmation at the top of the page. Default Install Settings - Save confirmation

Copy and paste the install link in your browser. Install screen

Click on 'Add to Server'. Select your server. Click on 'Continue'. Install screen - Select Server

Click on 'Authorize' on the next screen. Install screen - Authorize

Discord should redirect you to a success screen here. Install screen - Success

Close the tab and go back to your application settings. Navigate to the OAuth2 section. Copy the 'Client ID' from this page. Client credentials

Navigate to the create Discord integration page. Give the integration a name. Paste your client ID.

Navigate back to your Discord application page and click on 'Reset Secret' under the 'Client Secret' section. This will open a verification popup. Client credentials - Discord Client Secret Popup

Click on 'Yes, do it!'. Discord may ask you to perform additional steps for verification like password verification. It should show a newly generated secret in the 'Client Secret' section. Please copy it.

The client secret here is sensitive information, do not share this with anyone. We show the token here for simplicity; the token shown here is revoked and is no longer in use.

Client credentials - Discord Client Secret Gen

Navigate back to the 'Create Discord Integration' tab on Helios and paste the token in the Client Secret section.

Navigate back to the Discord applications tab > Go to the Bot section. Generate and copy the 'Token'. You'll need to follow steps similar to the 'Client Secret' generation. Bot token - Discord Bot Generate

Copy the token and navigate back to the 'Create Discord Integration' tab on Helios. Paste the Bot Token and click on 'Test Connection' to validate.

Click on 'Create Integration'.

Learn more about creating Discord bots in the Discord documentation.

Functionality

The Discord integration lets your workflows send messages, manage channels, handle interactions, and automate community management without writing custom code.

Category	Features
Core Capabilities	Messaging, Channel Management, User Operations
Message Features	Rich Embeds, Mentions, Threads, Reactions, Scheduled Messages

Real-time Events

Webhook Setup

Discord in Helios supports 'Interaction API'. Interactions are the way Discord sends Helios information about slash commands which you can configure to trigger your workflows.

Go to Discord integrations page > Click 'Manage' for your Discord integration > Click 'Advanced Configuration' > Copy the URL > Go to Discord Developer Portal > General Information > Paste the URL in 'Interactions Endpoint URL'. Don't click on 'Save Changes' yet on Discord.

Go to Discord Developer Portal > General Information > Copy the Public Key > Paste in the public key section in the Manage Discord modal in Helios > Click 'Save Changes' on Helios.

Go back to the Discord Developer Portal > Click 'Save Changes'.

This configures Discord to send notifications to Helios.

Setup slash commands

Discord integration supports slash commands as a way for directly interacting with Helios from Discord. These commands are available to you in a Discord server when you type / (slash). Since these are custom commands, they need to be registered per Discord application + server.

For example, if we want to create a command which sends a message to Helios like /helios <statement>, we could use the following curl command to register this command to our server.

curl -X POST \
  "https://discord.com/api/v10/applications/<application_id>/guilds/<guild_id>/commands" \
  -H "Authorization: Bot <bot_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "helios",
    "description": "Ask Helios something",
    "options": [
      {
        "name": "statement",
        "description": "What you want to tell or ask Helios",
        "type": 3,
        "required": true
      }
    ]
  }'

Fetching the details:

application_id: Application ID can be located in Discord application settings > General Information > Application ID section.
guild_id: A Discord guild is a Discord server. This is your Discord server ID. To fetch the guild_id you need to enable developer mode in Discord. To enable developer mode, go to Discord > User Settings (click on the gear icon) > Advanced (Under App Settings) > Enable Developer Mode. Navigate back to Discord home screen > Right click on the server icon > Click 'Copy Server ID'.
bot_token: The token for the Discord bot.

After updating the values and running the curl command, you should be able to see a /helios command in your server. Do a test run, say hello.

/helios statement:hello

This should return an acknowledgment message to you. You can customize this further and use slash commands to trigger various workflows in Helios.