The Send or Edit a Message action lets you send a message or edit an already existing message with content, embeds, or components.
Message Builder
The Message Builder allows you to create a message for your bot to send when the action is ran. Your message must have either content, valid embeds, or components.
Message Content
The message content is the plain text attached to your message, has a max of 2000 characters. It can contain mentions that will ping the user / role. However, if the Response Type is set to a reply, no ping will be issued.
Embeds
Embeds are a stylish way to show content with your bot. Below you may find information on each part of an embed.
Author
Author
The author text inside of your embed which appears at the top of your embed, has a limit of 256 characters.
Author URL
The link that users can press on the author text in order to be redirected to the URL.
Author Icon URL
The link that will display as the image next to the author, must be a valid URL of an image.
Basic Fields
Title
The title of your embed which appears as the largest text of all embed parts, has a limit of 256 characters.
Description
The main text of your embed which is in the center, has a limit of 4096 characters.
URL
The title URL for your embed, that users can press on the author text in order to be redirected to the URL.
Embed Color
Picker
The HEX color picker for your embed, you may insert a valid HEX code or select one using the small color menu.
Color
The decimal number for the color of your embed. You can use this if you want to use a variable as a color. When left blank, the color in the picker will be used.
Fields
Fields are a type of content you can add right below the description of your embed. You can add up to 25 fields per embed, and give each one a name and a value
Click "Add Field" in your embed's settings to add a new field. Below you may find a list of all settings you can use for your field.
Name
A title for your field. The maximum length is 256 characters.
Value
The value is basically the content to show inside the field. The max length is 1024 characters.
Inline Field
Enable this option to make the field appear inline with the previous one, instead of adding it below.
Images
Image URL
The URL for the image that will appear in the bottom of your embed.
Thumbnail URL
The URL for the image that will appear in the top right of your embed.
Footer
Footer Text
The text that will appear in the bottom of your embed, which has a limit of 2048 characters.
Footer Icon URL
The URL for the image that will appear in the bottom right of your embed, left of the footer text.
Time
Timestamp
The timestamp of your embed which will appear in the bottom next to your footer, you can select the time here with a menu.
Timestamp Variable
The timestamp variable of your embed which will appear in the bottom next to your footer, you can input a variable that is either ISO or UNIX in order to display a timestamp. You can use this if you want to use a variable as a timestamp, if you'd like to display the current time you can use the {time_now_unix} variable here.
Other
Hide Embed
Option to save embeds for later and not make them appear, input "true" in the text box in order to do this.
Response Type
The send or edit a message action offers multiple response types, which allow you to decide where and how your message should be sent. There are 4 categories of response types, all of them are listed and explained below.
The message will be sent to the channel where the command was used in, the event was triggered in or the last interaction was triggered in.
Reply to the command
The message will simply reply to the command / event or the most recent interaction.
Reply to a specific message
The message will reply to a specific message and ping the author of the message it replies to.
Channel ID
Here you can set the ID of the channel where the message you're replying to is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Message ID
Here you can set the ID of the message the message will reply to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a message ID. These can be easily added through the variable selector by clicking the Clipboard button.
Send the message to the channel the command was used in
The message will be sent to the channel where the command was used in, the event was triggered in or the last interaction was triggered in.
The message will be sent to the selected channel in a channel option.
Send the message to a specific channel
The message will be sent to a specific channel from an ID of a channel.
Channel ID
Here you can set the ID of the channel where the message will be sent to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Send the message to a channel option
The message will be sent to the selected channel in a channel option.
The message you created will edit another previously sent message with a channel and message ID.
Edit a message sent by another action
The message you created will be the edited version of a previous sent message in your command or event's tree.
Response Action
The message action from your tree that will be edited to the message you have setup.
Keep Components
This option allows you to keep the buttons or select menu options of the original message you're editing.
Edit a specific message
The message you created will edit another previously sent message with a channel and message ID.
Channel ID
Here you can set the ID of the channel where the message you're replying to is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Message ID
Here you can set the ID of the message the message will reply to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a message ID. These can be easily added through the variable selector by clicking the Clipboard button.
Keep Components
This option allows you to keep the buttons or select menu options of the original message you're editing.
Optional Variable
You can also create your own variable that can be used anywhere in the command to get the ID of the message sent by the action. This is useful when using Send an API Request in your command / event and you need the ID of the message. Make sure that the name of the variable does not correspond to the name of a default variable or of an another action.
You can copy the variable by clicking the clipboard icon in the section right below the optional variable field.
Adding Components
In order to add a button or select menu to your message, you must click on either of the buttons on your "Send or Edit a Message" action block.
Adding a Button
If you would like to add a button, you must press the button in the bottom left of your block with the plus sign titled "Button". After you press this, a button will be added to your message and will be attached to it. For more information about buttons, check out the Button page.
Adding a Select Menu
If you would like to add a select menu, you must press the button in the bottom right of your block with the plus sign titled "Menu". After you press this, a select menu will be added to your message and will be attached to it. For more information about Select Menus, check out the Select Menu page.
Requirements and Limits
Inside of your message, there are requirements and limits that Discord has in place. Your message must follow these requirements and limits in order for it to function properly.
General
Your message must include valid message content, an embed, or a component in order for your message to send.
Message
You may only have up to 10 embeds on your message.
The total number of characters in the title, description, field.name, field.value, footer.text, and author.name fields across all embeds in a message must not go above 6000 characters.
When adding an embed, at least one of the following fields is required: title, description, or author.
If you have a footer icon, you must have footer text.
If you have a author icon, you must have a author text.
Each embed field requires a title and some content.
Single spaces cannot bypass any of the requirements listed above.
Components
You can only have up to 5 action rows.
You can only have up to 5 buttons per row.
You can only have 1 select menu per row.
You can't have a select menu and a button in the same row.
