DEV

Discord

Discord Connection

Put Discord to Work with @Human Automations and @Human Agents

The Discord Connection documents all Triggers, Actions and Query Operations available for creating automations via the Discord API.

What can you do with the Discord Connection?

  • Connect to the Discord API in a few clicks

  • Use the related Discord Operations (see below) in @Human Automations or @Human Agents

Trigger Operations

Server Updated

Triggers on: servers/server_updated

Triggered when a server's settings, including name or icon, are updated.

Member Joined

Triggers on: servers/member_added

Triggered when a new member joins a server.

Member Left

Triggers on: servers/member_removed

Triggered when a member leaves a server or is removed.

Channel Created

Triggers on: channels/channel_created

Triggered when a new channel is created within a server.

Channel Deleted

Triggers on: channels/channel_deleted

Triggered when an existing channel is deleted.

Message Created

Triggers on: messages/message_created

Triggered when a new message is sent in a channel.

Message Updated

Triggers on: messages/message_updated

Triggered when an existing message is edited.

Message Deleted

Triggers on: messages/message_deleted

Triggered when a message is deleted from a channel.

Action Operations

Action: Add Role

Action: Remove User Role

Action: Send Channel Message

Action: Send message in Forum Post

Query Operations

Example link

Example link

Obtaining Access Credentials

  1. Log in to the Discord Developer Portal and select your application.

  2. Navigate to the "Bot" page in the left sidebar.

  3. Reset and Copy your Bot Token by clicking the "Reset Token" button (this is your permanent access credential).

  4. Ensure "Public Bot" is disabled if you only want this bot for your own server.

  5. Add the Bot to your server via the OAuth2 URL Generator with the required scopes (e.g., bot, applications.commands).

Configuring Webhooks

  1. Log in to your Discord Developer Portal and select your application.

  2. Navigate to "Settings" → "Webhook Events" in the left sidebar.

  3. Enter the Webhook URL provided by your integration into the Endpoint field.

  4. Enable Events by clicking the toggle in the Events section.

  5. Select the specific events you wish to receive (e.g., APPLICATION_AUTHORIZED, ENTITLEMENT_CREATE) and click Save Changes.

  6. Navigate to the "General Information" page and enter the same URL into the Interactions Endpoint URL field to receive slash commands and component interactions.

  7. Navigate to the "Bot" page settings in the left sidebar.

  8. Enable Privileged Gateway Intents by toggling "Server Members Intent" and "Message Content Intent" to ensure all server-level events are captured.

  9. Click "Save Changes" to activate the configuration.

Code (Apache v2.0): Service Connectivity and Metadata

Code (Apache v2.0): List of External Resources and Internal Mapping

Last updated