# 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](https://api.slack.com/apps) and click **Create New App**.
2. Select a creation method: From a manifest or From scratch.

   For a quick setup, select **From a manifest**.

   <figure><img src="/files/14P1cO2D1p8AcUn3JVSS" alt=""><figcaption></figcaption></figure>
3. Select the workspace to install the app and click **Next**.
4. Input the manifest content.&#x20;

   This manifest provides the complete description of the app.&#x20;

```yaml
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
```

5. 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.&#x20;

1. Open the app in Slack site, in **Install App**, click on **Install to \<workspace name>**.&#x20;
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.

<figure><img src="/files/Ut8qaWfbgs9882lbO5Md" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="/files/nf2OeiPVBcDeGcR4LeYO" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.reorc.com/connections/integrations/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.