Slack

You can create a Slack app and integrate with ReOrc to send notifications to your Slack workspace upon certain pipeline execution event, such as job completion or failure.

ReOrc uses Slack APIs and bot authentication token to connect with your Slack app. This allows you to flexibly select the channels and users to send the notifications.

Create a Slack app

1. Go to the Slack API page and click Create New App.

2. Select a creation method: From a manifest or From scratch.

   For a quick setup, select From a manifest.

   
3. Select the workspace to install the app and click Next.

4. Input the manifest content.

   This manifest provides the complete description of the app.

display_information:
  name: ReOrc Notifications
features:
  bot_user:
    display_name: ReOrc Notifications
    always_online: true
oauth_config:
  scopes:
    bot:
      - channels:manage
      - channels:read
      - chat:write
      - chat:write.public
      - groups:read
      - groups:write
      - im:write
      - mpim:read
      - mpim:write
      - users:read
      - users:read.email

1. Review the scope and click Create.

Install the app to workspace

Once you've created the app, you need to install it to your workspace.

1. Open the app in Slack site, in Install App, click on Install to <workspace name>.

2. In the opened confirmation page, click Allow.

   This will install the app to your workspace and create a Bot User OAuth Token which you can use to authenticate the app in ReOrc.

Bot User OAuth Token

After installing the app to the workspace, Slack will navigate you back to the Install App section. Here under Bot User OAuth Token, you can find the generated bot user authentication token. You need to copy this token to use in ReOrc.

Configure Slack integration

1. In your ReOrc organization, go to Connections > Integrations, locate Slack option and click Connect.

2. Input the bot authentication token that you copied and click Confirm.

   ReOrc will try to authenticate the app.

Add Slack notification to jobs

With the Slack app integrated, you can select the Slack option as notification destination for a job execution.

Upon job failure, ReOrc will send the notifications to the designated Slack user or channel.