Moderator messages
The Moderator messages feature allows moderators to easily manage their messages and interact effectively within their communities. The moderators can do the following:
- Create and send a moderator message
- Schedule a message
- Interval scheduling
- Multi-template support
- Retry logic
- Create a poll
- Pin a message
Note: This is one of Sendbird's premium features. Contact our sales team for further assistance.
Create a moderator message
Follow the steps below to create a new moderator message.
Step 1 Go to Moderator messages
-
Log in to your Sendbird Dashboard.
-
Go to your Application > Moderation > Advanced moderation > Moderator messages, and click on Create +.
Step 2 Fill in the Basic information
Start by filling in the basic information section. The table below lists descriptions of each field.
| Field | Description |
|---|---|
Name | A label used within the dashboard to identify the moderator message. |
Message sender | There are two types of message senders available: |
Targeted channels | You can select and add up to 30 open channels to send the moderator message to. |
Set send type | There are two ways to send the moderator message: |
Repeat message | Available when Set send type is |
Step 3 Fill in the Message section
Continue by completing the message section. The table below lists descriptions of each field.
| Field | Description |
|---|---|
Message type | There are two types of moderator message available: |
Message text | Enter the moderator message containing a string of text. Only available when the Message type is |
Poll | Create a poll with question and options to send as a moderator message. Only available when the Message type is |
Pin a message | An option to pin the moderator message in the targeted channels. For further information, see pinning a message. |
Step 4 Save, send or schedule
Once you're done, you can take one of the following actions:
- Click Save to save as a draft in the moderator messages list.
- Click Send to send the message to the targeted channels immediately.
- Click on Schedule to schedule the message to be sent at a later time. This option is only available when the Send type is set to Set schedule.
Finished View the list of moderator messages
Once the moderator message is successfully created, you can view it in the Moderator messages list. Click a message to open the detail panel, which shows basic information, message content, and the sent log.
The Sent log tracks the delivery status of each send. For recurring messages, each interval creates a separate log entry showing the timestamp, message sequence, and status. Expand a log entry to see per-channel results. If a send fails for a specific channel, the failed channel is displayed in the log while other channels continue to receive messages normally.
Key features
The following shows the highlighted features of the Moderator message.
Schedule a message
The scheduled messages feature allows moderators to select a date and time in the future for the message to be sent. Scheduling a message can be useful when an important message must be sent at a later time.
You can set the Set send type to Scheduling message delivery and select the date and time for the message to be sent.
Interval scheduling
Interval scheduling allows you to send a moderator message multiple times at a regular interval. This is useful for recurring broadcasts, such as posting chat rules every 10 minutes during a live event so late-joining viewers still see the rules.
To set up interval scheduling:
- Set the Set send type to
Scheduling message delivery. - Set the start date and time under Set message sending time.
- Check Repeat message and configure the following:
- Repeat interval (minute): The time between each send, in minutes.
- Duration (minute): The total duration over which the message repeats. For example, an interval of 5 minutes with a duration of 60 minutes sends the message 12 times.
Each scheduled send creates an individual execution record that you can track in the moderator messages list. If any send attempt fails, the system automatically retries up to three times. For more information, see Retry logic.
Multi-template support
When Repeat message is enabled, you can add up to four message templates per moderator message. Click + Add template in the Message section to add more templates.
Messages are sent in sequence — Message 1 on the first interval, Message 2 on the second, Message 3 on the third, Message 4 on the fourth, then the cycle repeats from Message 1. At least one message is required.
Note: When editing a text message in an active repeating schedule, changes apply only to messages sent after the edit. Messages already sent are not affected.
Retry logic
When a send attempt fails due to a transient error such as a network timeout or a temporarily unavailable channel, the system automatically retries up to three times. Each retry attempt is logged with its timestamp, attempt number, and error code.
If all retries are exhausted, the execution is marked as failed and surfaced in the dashboard. Non-retryable errors, such as a channel not found or permission denied, are not retried.
Create polls
A poll usually consists of a question and at least one poll option that users can vote on. The functionality provides an easier way to gather feedback from groups of all sizes, collect data from customers, and drive user engagement. You can configure various settings for your poll, including when the poll will close and whether to allow users to add poll options or vote on multiple poll options.
To create a poll, select the Polls message type and fill in the question and options.
Note: Poll messages cannot be scheduled. They can only be sent immediately.
Pin a message
The pinned messages feature allows users to mark or highlight specific messages which can be announcements, updates, instructions, or any other messages deemed important in a channel. This makes it easier for channel members to find and access important information, even in large or active channels where there may be a high volume of incoming messages.
To pin a message, select the Pinned option when creating a moderator message. Pinned messages will be displayed in channels as shown in the image below.
Settings
You can configure the maximum number of pinned messages allowed per channel under your Application > Settings > Moderation > Advanced moderation > Moderator message. Sendbird allows up to 10 pinned messages per channel. Once this limit is reached, the oldest pinned message will be deleted when a new message is pinned.