Advanced Moderation Guide v1
Advanced Moderation Guide
Advanced Moderation Guide
Version 1

Moderator messages

Copy link

The Moderator messages feature allows moderators to easily manage their messages and interact effectively within their communities. The moderators can do the following:

Note: This is one of Sendbird's premium features. Contact our sales team for further assistance.


Create a moderator message

Copy link

Follow the steps below to create a new moderator message.

Step 1 Go to Moderator messages

Copy link
  • 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

Copy link

Start by filling in the basic information section. The table below lists descriptions of each field.

FieldDescription

Name

A label used within the dashboard to identify the moderator message.

Message sender

There are two types of message senders available:
-Channel manager: The moderator message is sent displaying the channel manager's name.
-Admin message: The moderator message is sent without displaying the sender's name, in a non-personalized system message.

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:
-Send immediately: The moderator message is sent to all targeted channels once Send button on the top-right is clicked.
-Scheduling message delivery: The moderator message is sent to all targeted channels at the scheduled time. For more information on scheduling a message, see this section.

Repeat message

Available when Set send type is Scheduling message delivery. Check this option to send the message multiple times at a regular interval. Configure the repeat interval and duration in minutes. For more information, see Interval scheduling.



Step 3 Fill in the Message section

Copy link

Continue by completing the message section. The table below lists descriptions of each field.

FieldDescription

Message type

There are two types of moderator message available:
-Text: A message type containing a string of text.
-Polls: A message type containing a poll.

Message text

Enter the moderator message containing a string of text. Only available when the Message type is Text. When Repeat message is enabled, you can add up to four messages that are sent in sequence. For more information, see Multi-template support.

Poll

Create a poll with question and options to send as a moderator message. Only available when the Message type is Polls. For further information, see polls.

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

Copy link

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

Copy link

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

Copy link

The following shows the highlighted features of the Moderator message.

Schedule a message

Copy link

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

Copy link

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:

  1. Set the Set send type to Scheduling message delivery.
  2. Set the start date and time under Set message sending time.
  3. 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

Copy link

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

Copy link

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

Copy link

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

Copy link

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

Copy link

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.