HeliosHELIOS DOCS

Discord

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

What your agents can do

Helios agents don't work from a preset list of actions. They semantically search the entire Discord API and call any endpoint directly, with authentication handled server-side. Anything your Discord bot has permission to do, an agent can do on your behalf.

  • Post a message or rich embed to a channel
  • Read recent messages from a channel and summarize them
  • Create and manage channels, threads, and roles
  • Add reactions, mention users, and pin messages
  • Look up server members and their roles
  • Manage the server on behalf of your bot

Authentication

MethodTypeDescription
BYO Discord BotBot TokenYour own Discord bot, with full control over its 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. You supply the client ID, client secret, and bot token.

Setup Steps

Click New Application and give it a name. New Application

Navigate to the 'Installation' section and scroll to the bottom of the page to the 'Default Install Settings'. 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.

Triggers

Discord does not currently emit event triggers into Helios. Use it from Chat, or from a Workflow driven by a schedule, webhook, or manual run.

Last updated on