Overview
This node sends messages, embeds, interactive prompts (buttons or select dropdowns), or performs actions (like removing messages or managing user roles) on Discord servers and channels. It supports sending to specific servers and channels, sending to the channel that triggered the workflow, replacing placeholder messages, and customizing bot activity and status. It is useful for automating Discord interactions such as sending announcements, collecting user input via buttons or selects, managing roles, or cleaning up messages.
Use Case Examples
- Sending a simple text message to a specific Discord channel.
- Sending an interactive button prompt to collect user responses and wait for interaction.
- Performing an action to add or remove roles from a user based on workflow logic.
- Sending rich embedded messages with images, fields, and author information to enhance message presentation.
Properties
| Name | Meaning |
|---|---|
| Replace the trigger placeholder | If active, the message produced by this node will replace the previous placeholder set by the Discord Trigger node or another Discord Send node. |
| Send to the trigger channel | If active, the message will be sent to the same channel where the workflow was triggered, without replacing any placeholder. |
| Choose server | Specifies the Discord server(s) where the message or action will be sent or performed. Requires bot credentials and presence in the server. |
| Send to | Specifies the text channel within the chosen server where the message or action will be sent or performed. |
| Type | Determines the type of interaction: sending a message, button prompt, select prompt, performing an action, or none (for clearing placeholders or updating bot status). |
| Action | Specifies the action to perform when Type is 'Action', such as removing messages or adding/removing roles from a user. |
| User ID | The Discord user ID to add or remove roles from (required for role actions). |
| Which roles | Specifies the roles to add or remove from the user (required for role actions). |
| How many? | Number of last messages to remove when performing the remove messages action (max 150, messages must be less than 4 weeks old). |
| Content | The text content of the message to send. Required for button and select prompts. |
| Embed | Enables sending rich embedded messages with additional formatting and media. |
| Color | Color of the embed message (if embed is enabled). |
| Title | Title of the embed message. |
| URL | URL associated with the embed title or author. |
| Author name | Name of the author displayed in the embed. |
| Author icon URL or base64 | URL or base64 image for the author's icon in the embed. |
| Author URL | URL linked to the author name in the embed. |
| Description | Description text of the embed message. |
| Thumbnail URL or base64 | URL or base64 image for the embed thumbnail. |
| Fields | Additional fields to add to the embed message, each with a title, value, and inline option. |
| Image URL or base64 | URL or base64 image to display in the embed. |
| Buttons | Up to 5 buttons to add to a button prompt, each with label, value, and style. |
| Select | Options for a select prompt dropdown, each with label, description, and value. |
| Persistent | If active, the button or select prompt remains visible after workflow completion. |
| Min select | Minimum number of options that must be selected in a persistent select prompt. |
| Max select | Maximum number of options that can be selected in a persistent select prompt. |
| Message ID | ID of the message to update when persistent is active; if empty, sends a new message. |
| Footer text | Footer text for the embed message. |
| Footer icon URL or base64 | URL or base64 image for the embed footer icon. |
| Displayed date | Timestamp to display in the embed message. |
| Timeout | Time in seconds to wait for user interaction before continuing or stopping the workflow; 0 means wait indefinitely. |
| Restrict to triggering user | If active, only the user who triggered the workflow can interact with the prompt. |
| Restrict to mentioned roles | If active, only users with specified roles can interact with the prompt. |
| Files | Up to 5 images to attach to the message. |
| Mention roles | Roles to mention in the message. |
| Placeholder | Placeholder message shown while waiting for user interaction; replaced by response message from another Discord Send node. |
| Bot customization | Enables customizing the bot's activity and status. |
| Bot activity | Text describing the bot's current activity shown in its profile. |
| Bot activity type | Type of bot activity displayed (Playing, Streaming, Listening, Watching). |
| Bot status | Status of the bot (Online, Idle, Do not disturb, Invisible). |
Output
JSON
value- Value returned from the Discord interaction, such as button or select response value.serverId- ID of the Discord server where the message or action was performed.channelId- ID of the Discord channel where the message or action was performed.userId- ID of the user who interacted or was affected by the action.userName- Username of the user who interacted or was affected.userTag- User tag (username#discriminator) of the user who interacted or was affected.messageId- ID of the message sent or interacted with.action- The action performed, if applicable (e.g., role added or removed).
Dependencies
- Discord API
- Bot token credential
Troubleshooting
- Ensure the bot token credential is valid and the bot is running in the target servers.
- Make sure the bot has the necessary permissions to send messages, manage roles, or remove messages in the specified channels.
- If using interactive prompts, verify that the workflow waits for user interaction and handles timeouts properly.
- When specifying server or channel IDs, ensure they exist and the bot has access.
- If replacing placeholders, confirm that the placeholder message exists and was set by a compatible node.
Links
- Discord Developer Documentation - Official Discord API documentation for understanding message types, embeds, and interactions.