Configure Slack alerts

Integrate W&B Server with Slack.

Create the Slack application

Follow the procedure below to create a Slack application.

  1. Visit https://api.slack.com/apps and select Create an App.

    Create an App button
  2. Provide a name for your app in the App Name field.

  3. Select a Slack workspace where you want to develop your app in. Ensure that the Slack workspace you use is the same workspace you intend to use for alerts.

    App name and workspace selection

Configure the Slack application

  1. On the left sidebar, select OAth & Permissions.

    OAuth & Permissions menu
  2. Within the Scopes section, provide the bot with the incoming_webhook scope. Scopes give your app permission to perform actions in your development workspace.

    For more information about OAuth scopes for Bots, see the Understanding OAuth scopes for Bots tutorial in the Slack API documentation.

    Bot token scopes
  3. Configure the Redirect URL to point to your W&B installation. Use the same URL that your host URL is set to in your local system settings. You can specify multiple URLs if you have different DNS mappings to your instance.

    Redirect URLs configuration
  4. Select Save URLs.

  5. You can optionally specify an IP range under Restrict API Token Usage, allow-list the IP or IP range of your W&B instances. Limiting the allowed IP address helps further secure your Slack application.

Register your Slack application with W&B

  1. Navigate to the System Settings or System Console page of your W&B instance, depending on your deployment

  2. Depending on the System page you are on follow one of the below options:

    • If you are in the System Console: go to Settings then to Notifications

      System Console notifications
    • If you are in the System Settings: toggle the Enable a custom Slack application to dispatch alerts to enable a custom Slack application

      Enable Slack application toggle
  3. Supply your Slack client ID and Slack secret then click Save. Navigate to Basic Information in Settings to find your application’s client ID and secret.

  4. Verify that everything is working by setting up a Slack integration in the W&B app.