Dispatch.IO Logo
Automations

Actions

Every action, by category: what the bot does, its settings and the permission it needs.

Updated on October 23, 2026#automatisations#reference

Search the documentation

Type a keyword: a command, a module, a dashboard page…

Actions are what the bot does. They run one after the other, in the order of the diagram. An action that needs something from the trigger (a message, a member) explains it in its settings; if the trigger can't give it, the run stops with a clear error.

Messages

Send a message

Posts a message (text and embed) in the trigger channel, a chosen channel or in DM.

SettingDetails
Where to sendTrigger channel = where the message, command or button happened. Choices: Trigger channel (default) · A chosen channel · In private message
Channel (required)One channel. shown when “Where to send” = A chosen channel
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable). shown when “Where to send” = In private message
Message (required)A text and an optional embed (title, description, color, image, footer…), with a preview

Bot permission: Send Messages

Send a studio message

Posts an embed or container made in Creation › Embeds / Containers.

SettingDetails
Where to sendChoices: Trigger channel (default) · A chosen channel · In private message
Channel (required)One channel. shown when “Where to send” = A chosen channel
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable). shown when “Where to send” = In private message
Studio message (required)A message saved in the studio (Creation › Embeds / Containers)

Bot permission: Send Messages

Message with buttons

Posts a message with buttons (or a menu) that start other automations.

SettingDetails
Where to sendChoices: Trigger channel (default) · A chosen channel · In private message
Channel (required)One channel. shown when “Where to send” = A chosen channel
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable). shown when “Where to send” = In private message
Message (required)A text and an optional embed (title, description, color, image, footer…), with a preview
Buttons or menu (required)Up to 5 buttons or one select menu (25 options), each one starting an automation

Bot permission: Send Messages

Send a banner

Posts a banner of Creation › Banners, drawn with the member's name, avatar and server.

SettingDetails
Where to sendChoices: Trigger channel (default) · A chosen channel · In private message
Channel (required)One channel. shown when “Where to send” = A chosen channel
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable). shown when “Where to send” = In private message
Banner (required)Drawn when it is sent: {user}, {server}, the avatar… take the values of the member who started it.
Text with the bannerOptional, shown above the picture. 2000 characters at most. Variables allowed

Bot permission: Attach Files

Reply

Replies to the trigger message, or to the command / button: a text with an embed, a studio message or a banner.

SettingDetails
Reply contentA text (with an optional embed), an embed or a container of Creation, or a banner drawn for the member. Choices: Text and embed (default) · Studio embed or container · Banner
Message (required)A text and an optional embed (title, description, color, image, footer…), with a preview. shown when “Reply content” = Text and embed
Studio message (required)A message saved in the studio (Creation › Embeds / Containers). shown when “Reply content” = Studio embed or container
Banner (required)A banner of Creation › Banners, drawn with the values of the member. shown when “Reply content” = Banner
Text with the bannerOptional, shown above the picture. 2000 characters at most. shown when “Reply content” = Banner. Variables allowed
Reply visible only to the memberFor a command or a button only (a message can't get an invisible reply). If the trigger has “Replies visible only to the member”, every reply already is.
Mention the author in the replyOn / off switch

Bot permission: Send Messages

React

Adds a reaction to the trigger message.

SettingDetails
Emoji (required)An emoji of Discord or of the server

Needs: a message

Bot permission: Add Reactions

Delete the message

Deletes the trigger message.

No setting.

Needs: a message

Bot permission: Manage Messages

Pin the message

Pins the trigger message.

No setting.

Needs: a message

Bot permission: Manage Messages

Create a thread

Opens a thread under the trigger message, or in a channel (public or private).

SettingDetails
Create the threadChoices: Under the trigger message (default) · In a channel
Thread channelOne channel. shown when “Create the thread” = In a channel
Thread name (required)A text. 100 characters at most. Variables allowed
Private threadOnly added members (including whoever started it) see it. shown when “Create the thread” = In a channel

Bot permission: Create Public Threads

Delete messages

Deletes the last X messages of a channel (under 14 days old).

SettingDetails
Channel (empty = the trigger's)One channel
Number of messagesBetween 1 and 100 (Discord doesn't bulk delete messages older than 14 days). Default: 10. From 1 to 100

Bot permission: Manage Messages

Warning

Moderation action: capped at 20 per minute on the server; it never touches the owner, the bot nor a member above the bot.

Edit a channel

Changes the name and/or topic of a channel (e.g. a member counter).

SettingDetails
Channel (empty = the trigger's)One channel
New nameA text. 100 characters at most. Variables allowed
Channel topicA long text. 1024 characters at most. Variables allowed

Bot permission: Manage Channels

Members

Give a role

Gives one or more roles to the member.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Roles (required)One or more roles (empty = all)

Bot permission: Manage Roles

Remove a role

Removes one or more roles from the member.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Roles (required)One or more roles (empty = all)

Bot permission: Manage Roles

Toggle a role

Gives the role if they don't have it, removes it if they do (button roles).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Roles (required)One or more roles (empty = all)

Bot permission: Manage Roles

Change the nickname

Changes the member's nickname on the server (empty = back to their name).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
New nickname32 characters at most. Empty = back to the member's name. 32 characters at most. Variables allowed

Bot permission: Manage Nicknames

Timeout

Times the member out (they can't write nor speak).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
DurationA duration. Default: 10 minutes. From 5 seconds to 28 days
Reason (audit log)A text. 400 characters at most. Variables allowed

Bot permission: Timeout Members

Warning

Moderation action: capped at 20 per minute on the server; it never touches the owner, the bot nor a member above the bot.

Lift the timeout

Ends the member's timeout.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Reason (audit log)A text. 400 characters at most. Variables allowed

Bot permission: Timeout Members

Kick

Kicks the member from the server.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Reason (audit log)A text. 400 characters at most. Variables allowed

Bot permission: Kick Members

Warning

Moderation action: capped at 20 per minute on the server; it never touches the owner, the bot nor a member above the bot.

Ban

Bans the member (and deletes their recent messages if you want).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Reason (audit log)A text. 400 characters at most. Variables allowed
Delete their messages from the last…Choices: Delete nothing (default) · Last hour · Last 24 h · Last 7 days

Bot permission: Ban Members

Warning

Moderation action: capped at 20 per minute on the server; it never touches the owner, the bot nor a member above the bot.

Warn

Adds a warning to the member's record (visible with /infractions).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Warning reason (required)A text. 400 characters at most. Variables allowed

Voice

Move in voice

Moves the member to another voice channel.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
Voice channel (required)One channel

Bot permission: Move Members

Disconnect from voice

Disconnects the member from the voice channel.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)

Bot permission: Move Members

Logic

Wait

Waits before the next steps (up to 7 days, even if the bot restarts).

SettingDetails
DurationWhat follows is saved: it runs even if the bot restarts meanwhile (7 days at most). Default: 1 minute. From 1 second to 7 days

Set a variable

Gives a value to one of your variables (for the server or the member).

SettingDetails
Variable (required)One of your variables
New valueA text. 500 characters at most. Variables allowed
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)

Add to a variable

Adds (or removes, with a negative number) an amount to a variable.

SettingDetails
Variable (required)One of your variables
Amount to addA number, or a variable. Default: 1. 50 characters at most. Variables allowed
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)

Run an automation

Starts another of your automations with the same member, channel…

SettingDetails
Automation to run (required)It starts with the same member and channel. 3 nesting levels at most.

Stop

Stops the run here (the next steps don't run).

No setting.

Bot

Give XP

Gives XP to the member (Levels module on); a level up is announced.

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
XP to giveA number, or a variable. Default: 100. 20 characters at most. Variables allowed

Remove XP

Removes XP from the member (Levels module on).

SettingDetails
Member concernedThe member who triggered, a member option of the command, or another member (ID or variable)
XP to removeA number, or a variable. Default: 100. 20 characters at most. Variables allowed

Send a log

Posts a message in a chosen log channel.

SettingDetails
Log channel (required)One channel
Message (required)A text and an optional embed (title, description, color, image, footer…), with a preview

Bot permission: Send Messages

Random branches

Random branches

Picks a branch at random (2 to 5), following the weights you give.

In the Logic tab of the step picker. Each branch has a weight (1 to 100): a branch's chance is its weight divided by the sum of the weights. Branches are numbered 1 to 5 on the diagram.

Updated on October 23, 2026