Messages and announcements

Permissions

These commands require the Administrator permission (or an Admin role registered for your server in Dispatch.IO, if you opened them to it in Server Settings → Integrations). Without it, the command doesn't reply. See Permissions and roles.

The bot must be able to write in the target channel: View Channel, Send Messages, plus Embed Links for embeds or Attach Files for images.

Where is the message posted?

• /create-embed, /create-container and /create-banner post in the channel where you run the command. Run them directly in your announcements channel.
• /say lets you choose: current channel, another channel or a direct message.
• /create-embed, /edit-embed, /create-container and /edit-container also work in direct messages with the bot: the message is then posted in that conversation.

Builders and confirmations are only visible to you. Only the final message is public.

Finding a message ID

To edit a message (/say, /edit-embed, /edit-container), you need its ID:

1. Turn on Developer Mode: User Settings → Advanced → Developer Mode.
2. Right-click the message (or long-press on mobile) → Copy Message ID.

/say makes the bot write a message (text, image or both), in the channel of your choice or by direct message. With the message_id option, it edits or deletes a message the bot has already sent.

/say

Sends a message as the bot in a channel or by direct message, or edits or deletes a bot message.

Syntax

/say content:[text] image:[file] message_id:[ID]

Options

Option	Type	Required	Description
content	String	No	The message text, up to 2,000 characters. Markdown and mentions are supported.
image	Attachment	No	An image to attach to the message.
message_id	String	No	The ID of a bot message to edit or delete.

Member permission

Administrator

Where to use it

Server only

Rate limit

2 uses / 10 s

Examples

• /say content:📢 Game night starts on Friday at 9 pm! See you in #general.
• /say image:schedule.png
• /say content:📢 Game night is moved to Saturday, 9 pm! message_id:1300000000000000250

Displayed in French Discord as /dire contenu: image: id_du_message:.

Give at least one option, otherwise the bot replies "You must provide content, an image, or a message ID.".

Result on Discord

Sending a message

1. Run /say with content, image or both.
2. In the Choose a destination menu, pick within 60 seconds:
   • Current channel: the message is sent right away in this channel;
   • Specific channel: a second menu lets you pick a text channel;
   • Direct message: a menu lets you pick the member who will receive it.
3. The bot posts the message and confirms it ("Message sent in #general." or "Message sent privately to @Alex.").

• Mentions written in content notify the people involved, just like a regular message.
• If the member has closed their direct messages, the bot replies "Unable to send or edit a private message.".
• Cancel, or 60 seconds without a choice, stops the operation.

Editing or deleting a bot message

1. Run /say message_id:<ID> with the new content and/or the new image. To delete the message, only give message_id.
2. In the menu, say where the message is: current channel, specific channel, or Direct message (then pick the member who received it).
3. The bot shows a Message edit summary: old and new content, old and new image.
4. Click Confirm within 30 seconds (Cancel to give up).

Every message sent, edited or deleted is logged in General Server Logs (with the message ID and, for an edit, the old and new text).

/create-embed opens a builder, only visible to you, to put an embed together step by step and post it in the current channel.

/create-embed

Opens a builder to create a custom embed and post it in the current channel.

Syntax

/create-embed

Member permission

Administrator

Where to use it

Server and direct messages with the bot

Rate limit

2 uses / 30 s

Examples

• /create-embed

Displayed in French Discord as /création-embed.

Result on Discord

Step 1: the welcome screen

The bot shows the instructions (supported Markdown, mention syntax, color, images) and three buttons:

• Create Embed: opens the input window;
• Edit Images: greyed out while the embed is empty;
• Cancel: closes the builder.

Step 2: fill in the window

The Create an embed message window has five fields, all optional:

Step 3: check the preview

Once submitted, the builder shows Preview and the embed as it will be posted, with five buttons:

Step 4 (optional): add images

The Add or edit images to the embed window has two fields for direct image links (https://…/image.png):

• Thumbnail: small image at the top right;
• Image: large image at the bottom of the embed.

Empty a field to remove the image. If a link isn't valid, Discord rejects the update and the preview doesn't change.

Step 5: post it

Click Send: the embed is posted in the channel where you ran the command and the builder disappears. The result looks like the first image on this page.

• The builder closes by itself after 5 minutes without any action.
• Mentions in an embed are clickable but don't notify anyone (a Discord rule). To notify people, use /say.
• To edit the embed later, use /edit-embed.

/edit-embed reopens the builder on an embed already posted by the bot, so you can fix it.

/edit-embed

Edits an embed posted by the bot.

Syntax

/edit-embed message_id:<ID> channel:[channel]

Options

Option	Type	Required	Description
message_id	String	Yes	The ID of the message containing the embed.
channel	Channel	No	The channel where the message is. Defaults to the current channel.

Member permission

Administrator

Where to use it

Server and direct messages with the bot

Rate limit

2 uses / 30 s

Examples

• /edit-embed message_id:1300000000000000260
• /edit-embed message_id:1300000000000000260 channel:#general

Displayed in French Discord as /édition-embed id_du_message: salon:.

Result on Discord

1. The bot finds the message and loads its first embed: title, link, description, color, footer text, thumbnail and image.
2. Click Edit Embed: the window opens already filled in. Edit Images is available right away.
3. The rest works exactly like /create-embed (preview, images).
4. Send replaces the embed in the original message. The message's text and any buttons stay as they are.

A container is a newer Discord message format: a block with a colored bar in which you stack elements (texts, sections with a thumbnail, image galleries, separators, link buttons). /create-container opens a builder, only visible to you, to assemble it element by element.

/create-container

Opens a builder to put a container together (texts, sections, images, separators, link buttons) and post it in the current channel.

Syntax

/create-container

Member permission

Administrator

Where to use it

Server and direct messages with the bot

Rate limit

2 uses / 30 s

Examples

• /create-container

Displayed in French Discord as /création-conteneur.

Result on Discord

Step 1: the empty builder

The builder shows the instructions and seven buttons: Add Section, Add Text, Edit Color, Add Image, Add Separator, Add Button (Link) and Cancel.

Step 2: add elements

Each button adds an element at the end of the container. All of them open a window, except the separator.

• Several buttons on one row: when the container's last element is a row with fewer than 5 buttons, the window shows one more field, Same row (1 for yes, 0 for no). Type 1 to add the button to that row, 0 to start a new one.
• Images uploaded as files: the bot hosts them online (on ImgBB) so they can be displayed. A public image link is therefore created.
• If an image or link is rejected, a message only you can see explains why ("The image URL must be valid and end with an image extension…", "The button URL must be valid…"). Fix it and try again.

Step 3: the preview

From the first element on, the builder shows your container as it will be posted. Below it:

Step 4: post it

Click Send: the container is posted in the channel where you ran the command and the builder disappears.

• During the preview, mentions don't notify anyone. Once posted, the container notifies the mentioned members and roles.
• After 5 minutes without any action, the builder stops responding: close it (Dismiss message) and run the command again.
• To edit the container later, use /edit-container.

/edit-container reopens the builder on a container already posted by the bot.

/edit-container

Edits a container posted by the bot.

Syntax

/edit-container message_id:<ID> channel:[channel]

Options

Option	Type	Required	Description
message_id	String	Yes	The ID of the message containing the container.
channel	Channel	No	The channel where the message is. Defaults to the current channel.

Member permission

Administrator

Where to use it

Server and direct messages with the bot

Rate limit

2 uses / 30 s

Examples

• /edit-container message_id:1300000000000000270
• /edit-container message_id:1300000000000000270 channel:#general

Displayed in French Discord as /édition-conteneur id_du_message: salon:.

Result on Discord

1. The bot finds the message and loads its container: elements and color.
2. The builder opens straight on the preview. Add, edit or delete elements just like with /create-container.
3. Send replaces the content of the original message with the new container.

Two differences from /create-container:

• the Section window has no file upload field: paste an image link (required);
• the Image window offers five link fields, prefilled with the current images.

/create-banner generates a 1200 × 400 px image with a stylized title, to use at the top of an announcement or a channel.

/create-banner

Generates a banner with a stylized title.

Syntax

/create-banner title:<text> right_text:[True/False] server_icon:[True/False] text_effect:[effect] font:[font] text_alignment:[alignment] opacity_overlay:[True/False] text_color:[#hex]

Options

Option	Type	Required	Description
title	String	Yes	The banner title, up to 25 characters. Emojis are drawn.
right_text	Boolean	No	Shows the server name, uppercased and repeated, along the right edge. Default: no.
server_icon	Boolean	No	Shows the server icon in a band on the left. Default: no.
text_effect	Choice	No	Gradient (default), Neon or Without effect.
font	Choice	No	Octosquares (default), Horizon, Roboto, Montserrat or Open Sans.
text_alignment	Choice	No	Left, Center (default) or Right.
opacity_overlay	Boolean	No	Darkens the background so the title is easier to read. Default: no.
text_color	String	No	The title color in hexadecimal (e.g. #48D1E1). Default: white (#FFFFFF).

Member permission

Administrator

Where to use it

Server only

Rate limit

2 uses / 30 s

Examples

• /create-banner title:Game night server_icon:True
• /create-banner title:Welcome! text_effect:Neon text_color:#FC7753 opacity_overlay:True

In English Discord, the options are written with a hyphen: right-text, server-icon, text-effect, text-alignment, overlay-opacity, text-color. In French Discord: /création-bannière titre: texte-droite: icon-serveur: effet-texte: police: alignement-texte: opacité-overlay: couleur-texte:.

Result on Discord

What it looks like

• Background: the server's welcome image if you set one (see Welcome and goodbye), otherwise a dark gradient.
• Effects: Gradient draws the title with a gradient and a drop shadow in the server's color; Neon adds a glow in the server's color; Without effect shows plain text.
• Title size: it adjusts automatically to the title's length so it fits on the banner.
• An invalid text color is replaced with white, with no error message.

Sending the banner

1. The bot shows a preview (only visible to you) with the image link, hosted online on ImgBB. You can reuse this link elsewhere, for example in the Image field of /create-embed. This link is public.
2. Within 5 minutes, choose:
   • Send in message: posts the image alone in the current channel;
   • Send in container: posts the image inside a container in the server's color.
3. The preview stays after sending. With no click after 5 minutes, it is replaced with an expiry message.

• Server management: clean up channels, protection mode, roles, emojis.
• Permissions and roles: who can use what.
• Welcome and goodbye: the welcome image, also used as the banner background.
• Logs: where to find the messages sent with /say.
• All commands