Direct Message a User

While the Direct Message a User action block is still available for use in all commands and events, it is considered old and has been replaced by the Send or Edit a Message action block. We advise you to use the Send or Edit a Message block instead, which offers more functionalities and possibilities for your message.

If you cannot see the Direct Message a User action block in your actions list, disable the Hide Legacy Reply Actions setting.

When triggered, the Direct Message a User action responds with a DM to a user of your choosing. This message can either be sent to the user who triggered the block, a user option, or a user ID. All variables and options can be used in the content of the reply.

User to DM

To receive a direct message, the user must have Direct Messages enabled.

The Direct Message a User action has three options that change to whom the message of the action is sent. Below you can find detailed information about each option and how it can be used.

User who used the command

By selecting this option your Direct Message will be sent to the user who used the most recent interaction; for example, the most recent button press, select menu choice, command run or the user who triggered the custom event.

User option

In commands, by selecting this option your Direct Message will be sent to a user selected in a user option.

User Option

Here you can set the option variable for the User option (purple blocks) you are using. These can be easily added through the variable selector by clicking the Clipboard button.

User ID

By selecting this option your Direct Message will be sent to a user specified via their user ID.

User ID

Here you can set the ID of the user to DM. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a user ID. These can be easily added through the variable selector by clicking the Clipboard button.

Message

In the Direct Message a User action, you have the choice for each message to be plain text, or an embed.

Plain Text

Content

The content of the action is the actual message that the bot should reply with when the action is triggered. You can use any variable or option in the content of this reply. These can be easily added through the variable selector by clicking the Clipboard button.

Embed

Author

The author is displayed in the top left of the embed. This can be the author who used the command or any information you wish to display.

Thumbnail URL

You can include a thumbnail embedded into the Embed Reply. This will display in the top right of the Embed.

Title

This is the title you wish to display in your Embed Reply. This will be centered above your Content Block.

Description

The description is the actual message that the bot should reply with when the action is triggered. You can use any variable or option in the content of this reply. These can be easily added through the variable selector by clicking the Clipboard button.

Image URL

This will display an image in full view under the Content Block.

Footer

This is the small text at the bottom left of the embed.

Embed URL

This will display the Title of the embed in blue text, you can click this to open an external page or image.

Color

This is the color shown on the Left Side of the Embed Reply.

Reactions

Reactions can also be added to the reply. These can be added by clicking the reactions dropdown and selecting emojis.

These reactions will be automatically added to the reply.

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.