## Set up
### Navigate to the Integration settings view
1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar
### **Connect Slack**
* Find the **Slack** integration module under the **Notifications** section
* Click the **Connect** button
* You’ll be taken through a standard [Slack app](https://api.slack.com/authentication/oauth-v2) OAuth flow
{% hint style="warning" %}
You must be logged into Slack as a member of the workspace you want to integrate with; approval from Workspace Owners may be required if that setting is turned on.
{% endhint %}
* Slack redirects you back to Runway
1. Select the **Primary channel** you want notifications to go to. You can select or enter multiple channels.
{% hint style="info" %}
Runway can send notifications to a **private** Slack channel once it has access to the channel, via one of these methods:
* In Slack, send a message to the private channel using the @Runway Slack handle
* In Slack, click on the user count icon at the top right of the private channel, then **Integrations** > **Add an app**. Search for Runway and click **Add**
Once the Runway app has been added, return to Runway, and the private channel name will now be available as an option in Runway integration settings for Slack.
{% endhint %}
{% hint style="info" %}
Runway syncs users to their Slack accounts by matching email addresses. If an email match isn’t found, Runway will fall back to matching by first/last name and email address.
{% endhint %}
{% hint style="success" %}
Runway is on Slack Marketplace. You can learn more about features, permissions, and security & compliance information by visiting our marketplace page:
Privacy policy:
{% endhint %}
## Slack slash commands
If you have the Slack integration installed, you can perform various release-related tasks right from within Slack using Runway **slash commands**.
{% hint style="info" %}
Use the `/runway help` command to see a complete list of available commands.
{% endhint %}
{% hint style="warning" %}
Note that slash commands obey the same access control rules as the Runway app.
{% endhint %}
### Update the regression testing status of a release
Command:
`/runway regression status`
Update the regression status of the current release for an app. Choose from a list of available builds, and then select a regression testing status.
### Update the status of a checklist item
Command:
`/runway checklist`
Update the status of a step checklist item for the current release of an app. Select the checklist item you want to update, then select the status.
### Update the status of a regression testing item
Command:
`/runway regression item`
Update the status of a regression testing item for the current release of an app. Select the regression testing item you want to update, then select the status.
### Update the status of an approval item
Command:
`/runway approval`
Update the status of an approval item for the current release of an app. Select the approval item you want to update, then select the status.
### View the status of a release
Command:
`/runway status`
To see the status of a specific release version:
`/runway status [appId] [releaseVersion]`
{% hint style="info" %}
You can find your app's ID in **App settings > General > App identifier.**
{% endhint %}
Completed release status
You can also use the following shortcuts to get the status of live, next, or upcoming releases for your iOS and Android apps:
```
/runway status [ios|android] [live|next|complete]
```
For example:
`/runway status ios live` will output the status of your live release.
### Add a fix to a release
Command:
`/runway add fix`
Add a fix to the current release of an app. You can provide written context on why the fix is needed, and then select the commit that you want added to the release as a fix.
Once a fix has been added, it will appear in the list of pending work items for the release branch. You can either manually cherry-pick the work item into your release branch, or if you have the [Pull (cherry-pick) fixes](https://docs.runway.team/automations/types-of-automations#pull-cherry-pick-fixes-into-the-release) into the release automation enabled, Runway will automatically take care of pulling the fix into the release via cherry-pick.
## Automations
Runway offers a number of Slack-related automations, including:
* [Create (and archive) release-specific channels](https://docs.runway.team/automations/types-of-automations#create-release-specific-channel-s)
* [Sync Runway user groups with Slack user groups](https://docs.runway.team/automations/types-of-automations#sync-slack-groups)
## Runway Release ATC
Runway Release ATC is an AI-powered agent that you can chat with in your Slack workspace, either via DM with the Runway Slack app or by @-mentioning the Runway Slack app in any channel it has access to. Ask for info about your releases, take actions, and get other Runway-related questions answered.
{% hint style="info" %}
The access and actions available to a user interacting with Runway Release ATC are automatically scoped based on that user's permissions within Runway.
{% endhint %}
{% hint style="warning" %}
As with any LLM, responses from Runway Release ATC may contain inaccurate information. Please use your best judgement and cross-reference info where needed.
{% endhint %}
---
# 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.runway.team/integrations/notifications/slack.md?ask=
```
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.
### Update the status of a checklist item
Command:
`/runway checklist`
Update the status of a step checklist item for the current release of an app. Select the checklist item you want to update, then select the status.
### Update the status of a regression testing item
Command:
`/runway regression item`
Update the status of a regression testing item for the current release of an app. Select the regression testing item you want to update, then select the status.
### Update the status of an approval item
Command:
`/runway approval`
Update the status of an approval item for the current release of an app. Select the approval item you want to update, then select the status.
### View the status of a release
Command:
`/runway status`
To see the status of a specific release version:
`/runway status [appId] [releaseVersion]`
{% hint style="info" %}
You can find your app's ID in **App settings > General > App identifier.**
{% endhint %}
