Slack Notifications

With the Slack plugin, you can receive Brightspot notifications to your Slack account. The messages Brightspot sends are similar to the following:

../../../_images/slack-delivery-option.png

Slack notifications can be delivered directly to users via Slackbot, as well as to specific channels configured at the role level.

The Slack plugin requires a Slack account. For more information, see Getting started for new members.

Configuring Slack Notifications

Administrators perform this task.

If your version of Brightspot is missing any of the following configuration options, contact your Brightspot developer.

  1. From the Navigation menu, select Admin > Sites & Settings.

  2. In the Sites widget, click Global. The Edit Global widget appears.

  3. Under Main, expand Slack. The Notification Settings appear.

    ../../../_images/slack-notification-options.png
  4. Under Webhooks, click add_circle_outline.

  5. In the selection field, click search.

  6. From the content picker, click New Slack Webhook. A content edit page appears.

  7. Set the fields with values from your Slack workspace. To obtain the Webhook URL, refer to the Slack documentation that is referenced in the field.

    ../../../_images/webhook-content-form.png
  8. Click Save, then click Back to Add to Delivery OptionsTeam.

  9. From the Content Picker, select the Slack team that you created.

  10. To disallow notifications delivered to Slack channels, turn off Allow Channel Notifications.

  11. To prevent users from creating Slack notifications without delivery confirmation, keep Allow Unconfirmed User Names turned off. With this option enabled, users begin receiving messages without an interim verification step.

  12. Click Save.

  13. If the Allow Channel Notifications option is turned on, and if you want to deliver notifications via Slack channels, see Creating Channel Notifications for additional Slack and Brightspot configuration.

  14. To deliver notifications via Slackbot, see Creating Slackbot Notifications.

Creating Channel Notifications

  1. If one does not already exist, create a channel in Slack to route Brightspot notifications. The channel name will be used in the Brightspot role configuration.

    Be sure to invite or to inform the applicable users to join the channel.

    ../../../_images/create-slack-channel.png
  2. From the Navigation menu, select Admin > Users & Roles.

  3. Select the role for which you want to configure a Slack channel notification. The Edit Tool Role widget appears.

  4. Under Notifications, under Delivery Options, click add_circle_outline. A list appears.

    ../../../_images/slack-pre-unconfirmed.png
  5. Select Slack.

  6. In the Team selection field, select an existing team.

  7. In the Username field, enter the name of the Slack channel that you created in step 1.

    ../../../_images/set-slack-channel.png
  8. Under Subscriptions, click add_circle_outline. A list appears.

  9. Select a subscription and configure it.

  10. Click Save.

All users who are in this role will receive Brightspot notifications in the Slack channel.

Creating Slackbot Notifications

The following procedure shows how individual users configure their profiles to receive Slackbot notifications. Alternatively, system administrators can set Slack notifications for users. See Managing users.

  1. In the header, click your username, then click Profile. The Profile widget appears.

  2. Under Notifications, under Delivery Options, click add_circle_outline. A list appears.

    ../../../_images/slack-pre-unconfirmed.png
  3. Select Slack.

  4. In the Team selection field, select an existing team.

  5. In the Username field, enter your Slack user name.

  6. Under Subscriptions, click add_circle_outline. A list appears.

  7. Select a subscription and configure it.

  8. Click Save.

See also: