# Slack Integration

Argos integrates with Slack to keep your team aligned on visual changes and reviews.

It sends notifications and also unfurls Argos build URLs directly inside Slack.

{% hint style="info" %}
Slack integration is available on Pro and Enterprise plans
{% endhint %}

### What you get

* Automatic Slack notifications when builds are created, reviewed, approved, or rejected
* Rich previews when pasting an Argos build URL in Slack
* Fine grained control using Automations conditions

### Slack notifications

Use Automations to post messages in the right channels at the right time.

Typical signals you may want to route to Slack:

* A build is ready for review
* Changes are requested
* A build is auto approved on main
* Only failed or blocking builds

Notifications include build status, branch, author, and a direct link to the build.

![Slack notification sent by Argos](/files/997eda32874de8f5ed75771e5a72928ed8f9537e)

*Example of a Slack notification sent by Argos*

### URL unfurling in Slack

When you paste an Argos build URL into Slack, Argos automatically unfurls it.

The preview includes:

* Build status and outcome
* Project and branch
* Direct shortcut to open the build in Argos

This works in messages, threads, and shared links, which makes reviews and handoffs easier without extra clicks.

### Set up Slack integration

Set up a Slack integration to unfurl Argos build URLs.

1. Verify that you have selected the correct team in the top, if not click the double arrow icon to select the right team.
2. Go to the team’s **Settings** tab.
3. Select the **Integrations** section.
4. Click on **Connect to Slack**.

### Set up Slack notifications

Set up a Slack notification rule using Argos automations.

1. Select a project in your Argos team.
2. Go to the **Automations** tab in your Argos project and click on **New Automation**.
3. Name your automation, e.g., "Notify Slack on build completion".
4. Under **WHEN**, select one or several events that will trigger the notification.
5. (Optional) Under **IF**, add conditions such as "Build type is check".

   ![Automation conditions example](/files/1497994cbc5651b74d13450af9bd27e5a8eaead7)
6. Under **THEN**, choose the action **Send notification to Slack**.

   If this is your first time using Slack with Argos, click **Connect to Slack** and follow the connection flow.
7. Select the Slack channel and optionally provide the channel ID.

   ![Locate Slack channel ID](/files/990d849cd23027cf3053641e14d251d17f3e239a)\
   \&#xNAN;*Finding the ID of a Slack Channel*
8. Click **Send test notification** to verify the connection. A test message will be sent to the selected channel.
9. Click **Create Rule** to activate it.

### Troubleshooting and Tips

* Make sure the Argos app is authorized in your Slack workspace.
* For private channels, manually invite the bot with `/invite @Argos`.
* Only Argos team admins can configure Slack integrations.
* You can test notifications anytime using **Send test notification**.

Need help setting up Slack integration? Reach out via [Discord](https://argos-ci.com/discord) or [contact support](mailto:contact@argos-ci.com).


---

# 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://argos-ci.com/docs/learn/integrations/slack-integration.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.