Notifications Guide v1
Notifications
Version 1

Send a notification on Sendbird Dashboard

Copy link

In order to send a notification from the Dashboard, you must first have a template. If you do not already have a template created, go to the Templates page on Sendbird Dashboard. To learn why you need a template and how to create one, see the Templates guide.

Once we have a template, we have two ways to send notifications: by navigating to the Send page on the dashboard and selecting a template to use; by navigating to the Templates page on the dashboard and use the Send option on the template itself.

This guide provides a three-step tutorial on sending a notification through the Send page.


Three-step guide

Copy link

Once on the Send page, we’ll complete three steps:

  1. Determine Template and Targets
  2. Compose the Notification
  3. Review

Step 1: Set a target

Copy link

Template information

Copy link

On the Target screen, we’ll first complete the Template information section by selecting the template we wish to send, if not already selected.

  • Template: Select a template to use for the notification. The notification channel associated with the template will be automatically specified in the Channel field.
  • Title: This feature offers an effective way for teams to categorize and manage notifications. This title is for internal use and won't be exposed to the target users. You can find the information on the Logs page on Sendbird Dashboard.
  • Tag: Allow for teams to enforce tags to prevent disorganization by requiring tags as well as preventing on-the-fly tag creation. To learn more about tags, see the Tags guide.
  • Priority: Set the priority for messages, ensuring that high priority notifications are sent before ones with lower priorities. This is available only for the batch mode notifications, not real-time. Because batch notifications, more than a single target, are typically sent in a First In First Out order, Priority allows us to push certain notifications to the front of the line. This should be utilized only when a batch of notifications needs to be sent out ahead of normal priority notifications already in queue.

Recipients

Copy link

When sending a notification, we have two options to generate a list of recipients. You can either manually enter user_id or upload a CSV containing user IDs and corresponding data.

When using the CSV method, users do not need to exist prior to sending the notification. However, when manually entering user IDs, they need to be existing in your Sendbird application.

  • User ID: Specify the ID of your target users. You can search users by their ID or nickname and add up to 10,000 users.
  • CSV file: Upload a list of target users, up to 100,000, in a CSV file. When uploading a file, note the following:
    • The first row in the file must contain the column names.
    • Only alphabets, numbers, underscores, hyphens, and periods are allowed in column names.
    • One column must be named user_id and it must contain user IDs of the recipients.
    • You can add more columns containing additional user information such as user name, nickname, or image URLs.
    • After uploading the CSV file, you can add user information to the notification message in the next step.
    • If you wish to import image URLs from the CSV file, the images must have the same width and height in order to be displayed properly.

Step 2: Compose a message

Copy link

In the compose screen, we’ll determine how our Notifications should look. This consists of filling in any variable information and overriding the push notification preferences on the template, if necessary.

Template variables

Copy link

When the template selected for the notification has variables, you can set the value to them here. Depending on the method you chose for Recipients in Step 1, Template variables offers different functionalities:

  • Specifying User ID: variables cannot be differentiated between users, and thus the notification will be the same for all users. You can preview the notification as a specific user by selecting the user from the dropdown above the Notification preview.

  • Uploading a CSV file with variable data: you can use a column from the CSV as the value of a variable. Select the Add data from file {...} button above each input box and select the corresponding column. The column name in the CSV does not need to match the variable name.

Push notifications

Copy link

Finally, we can determine whether we want to override the preset push notification settings on the template. This is a single time override and the overridden settings can't be saved for future use.

  • Title: Specify the title to display on a push notification for this Notification. This will override the preset title you specified for the template.
  • Body: Specify the body message to display on a push notification for this Notification. This will override the preset message you specified for the template.

Step 3: Review the look

Copy link

Finally, the review section offers one final opportunity to ensure all of the information matches what you anticipate. Double check the number of users as well as the compose section to confirm the Notification will be sent as you expect.

Once ready, press Send in the top-right corner of your screen.