Enterprise Tool

Discord

Post messages and alerts to Discord channels via webhook

Discord is a popular messaging platform used by developer communities and teams. CipherSense Agents connects via a Discord Webhook URL to post messages and embeds to any server channel.

Setup

Create a Discord Application and Bot

Go to discord.com/developers/applications > New Application. Name your app and go to the Bot tab. Click Add Bot, then under Token click Reset Token and copy the Bot Token.

Discord Developer Portal

Invite the bot to your server

In the Developer Portal: OAuth2 > OAuth2 URL Generator. Select the 'bot' scope and grant the 'Send Messages' and 'View Channels' permissions. Copy the generated URL, open it in a browser, and add the bot to your server.

Get the Channel ID

In Discord: enable Developer Mode in User Settings > Advanced. Right-click the target channel and click Copy Channel ID.

Add the integration in CipherSense Agents

Go to Project > Integrations > Add Integration > Discord. Enter the Bot Token and optionally a Default Channel ID. Click Save & Test.

Connection Fields

Fields required when adding this integration in your Project › Integrations.

Field	Required	Description
Bot Token	Required	Your Discord Bot Token from the Developer Portal > Bot tab.
Default Channel ID (Optional)	Optional	Default channel to post messages to. Can be overridden per workflow node.

Common Use Cases

Post deployment notificationsAlert community channels on AI eventsSend workflow summaries to team serversNotify on error or exception events

Common Errors

Known errors and how to resolve them.

Missing AccessWorkflow Execution

Why this happens

The bot token is valid (which is why the connection test passes), but the bot has not been added to the target server or does not have permission to view or post in the specific channel. Discord returns HTTP 403 with the message "Missing Access" in this case.

How to fix

1. Open the Discord Developer Portal and go to your app's OAuth2 > URL Generator.

2. Select the 'bot' scope and tick the 'View Channels' and 'Send Messages' bot permissions.

3. Copy the generated URL, paste it into a browser, and add the bot to the correct server.

4. If the target channel is private, go to the channel settings in Discord > Permissions and explicitly add the bot.

5. Return to CipherSense Agents and run Test Connection again — set a Default Channel ID in the integration config so the test now verifies channel access, not just the token.

Unknown ChannelWorkflow Execution

Why this happens

The Channel ID provided in the workflow node (or the Default Channel ID in the integration config) does not exist or belongs to a different server the bot is not in.

How to fix

In Discord: enable Developer Mode under User Settings > Advanced. Right-click the target channel and click Copy Channel ID. Paste the correct ID into the workflow node's Channel ID field or update the Default Channel ID in the integration settings.

Message content exceeds Discord's 2000-character limitWorkflow Execution

Why this happens

The message content being passed to the Discord node is longer than Discord's hard limit of 2000 characters.

How to fix

Add a preceding node (e.g. a Script Runner or agent prompt) to truncate or summarise the content before passing it to the Discord node. Alternatively, split the message across multiple Discord nodes.

Invalid Bot Token or Discord API is unreachableTest Connection

Why this happens

The Bot Token entered in the integration config is incorrect, has been regenerated, or the bot has been deleted.

How to fix

Go to the Discord Developer Portal > your app > Bot tab. Click Reset Token, copy the new token, and update the integration in CipherSense Agents. Note: resetting a token immediately invalidates the old one.

Ready to connect Discord?

Add this integration from your project dashboard and wire it into a workflow.

Open Dashboard ← Back to Integrations