Overview
This node sends messages, embeds, interactive prompts (buttons or select dropdowns), and performs actions (like removing messages or managing user roles) on Discord channels. It supports sending messages to specific channels, the trigger channel, or replacing placeholders set by other nodes. It is useful for automating Discord interactions such as sending announcements, collecting user input via buttons or selects, and managing roles or messages programmatically.
Use Case Examples
- Sending a simple text message to a specified Discord channel.
- Sending an interactive button prompt to collect user responses and wait for interaction.
- Removing the last 100 messages from a channel as part of a cleanup workflow.
- Adding or removing roles from a user based on workflow logic.
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. |
| Send to | Specifies the text channel where the message will be sent. Requires valid credentials and bot permissions. |
| Type | Specifies the type of interaction to perform: sending a message, button prompt, select prompt, action, or none (for clearing placeholders or updating bot status). |
| Action | Specifies the action to perform when Type is 'Action': remove messages, add role to user, or remove role from user. |
| User ID | The ID of the user 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 (max 150, messages must be less than 4 weeks old). |
| Content | The text content of the message or prompt. Cannot be empty for button or select prompts. |
| Embed | If active, enables creation of rich embedded messages with additional formatting and media. |
| Color | Color of the embed message (shown if embed is active). |
| Title | Title of the embed message. |
| URL | URL associated with the embed title. |
| Author name | Name of the author shown in the embed. |
| Author icon URL or base64 | URL or base64 image for the author 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 for interactive button prompts, each with label, value, and style. |
| Select | Options for select dropdown prompts, 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 select prompt. |
| Max select | Maximum number of options that can be selected in a 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 execution; 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 the button or select prompt is active; can be replaced by another Discord Send node. |
| Bot customization | If active, allows 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). |
| Audit Log Reason | Reason for the action to be logged in Discord's audit log. |
Output
JSON
value- Value returned by the Discord API or interaction response.channelId- ID of the 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 updated.action- Type of action performed (e.g., message sent, role added).
Dependencies
- Discord API
- Bot token credential
Troubleshooting
- Ensure the bot has the necessary permissions in the Discord server and channels.
- Verify that the bot token credential is valid and has not expired.
- If using interactive prompts, ensure the workflow waits for user interaction and handles timeouts properly.
- Error messages related to invalid channel or role IDs indicate misconfiguration or missing permissions.
- If the node fails to send messages, check that the bot is online and connected to Discord.
Links
- Discord Developer Documentation - Official Discord API documentation for understanding message types, embeds, and interactions.
- n8n Discord Node Documentation - Documentation for using the Discord node in n8n workflows.