# Slack

## Overview

The Slack integration brings Sola AI directly into Slack, enabling it to provide insights, escalate issues, and participate in security conversations.

The Slack integration allows you to join public channels, read messages, and send messages to help teams stay informed and take action in context.

With the Slack integration, you can:

* Enable real-time collaboration and assistance directly from Sola inside Slack.
* Receive security alerts and insights without switching tools.
* Keep teams aligned on security actions, investigations, and decisions.

{% hint style="warning" %}
**Sola can only perform the actions you approve.**

Connectors require explicit permission to access or act on external systems. Permissions are securely managed at the workspace, app, and chat level to ensure control at every step.
{% endhint %}

## Set up Slack connector integration with Sola

{% columns %}
{% column width="75%" %}
Go to ***Integrations*** > [***Connectors***](https://app.sola.security/integrations/connectors) > click ***New connector*** > select ***Slack***.

*The Sola wizard will take you through the steps.*
{% endcolumn %}

{% column width="25%" %} <a href="https://app.sola.security/integrations/connectors?connector=slack" class="button primary">Set up Slack -></a>

{% endcolumn %}
{% endcolumns %}

### Connect Slack to Sola

To connect Slack, you’ll need a Slack account with a full member Slack role or higher.

{% tabs %}
{% tab title="Slack App" %}
Recommended for secure, production use.\
This method uses a Slack App to grant Sola scoped, permission-based access to your Slack workspace. It reduces the risks associated with user tokens and long-lived credentials by enforcing granular permission scopes and using Slack’s OAuth-based authentication.

* Slack App (Recommended)\
  Install Sola’s Slack App to securely and easily grant access to your organization’s Slack workspace.
* Custom Slack App\
  Create and install your own Slack App for full control over permissions and configuration\
  (see how-to guide below)

*Not sure which method to choose?* We recommend starting with the Slack App for the fastest and most reliable setup.
{% endtab %}
{% endtabs %}

<details>

<summary>How do I set up a Slack connector using custom Slack App? </summary>

Complete the following steps to set up and configure your Slack App to integrate Sola with Slack.

{% hint style="info" %}
[Learn more about creating Slack Apps](https://api.slack.com/quickstart).
{% endhint %}

#### 1. Create your Slack App

* In your Slack [apps page](https://api.slack.com/apps), click ***Create New App***, and select ***From scratch***.
* Set an ***App Name*** (Sola Integration), select a workspace, and click ***Create App***.

#### 2. Configure permissions

* Go to ***OAuth & Permissions*** > ***Scopes*** > ***Bot Token Scopes***, select ***Add an OAuth Scope***.
* Add the following required scopes:
  * `assistant:write` - Allow Sola to act as an app agent.
  * `channels:history` - View messages and other content in public channels that Sola has been added to.
  * `channels:join` - Join public channels in a workspace.
  * `channels:read` - View basic information about public channels in a workspace.
  * `chat:write` - Send messages as @Sola App.
  * `emoji:read` - View custom emoji in a workspace.
  * `files:write` - Upload, edit, and delete files as Sola.
  * `groups:read` - View basic information about private channels that Sola has been added to.
  * `im:read` - View basic information about direct messages that Sola Security has been added to.
  * `reactions:read` - View emoji reactions and their associated content in channels and conversations that Sola Security has been added to.
  * `reactions:write` - Add and edit emoji reactions.
  * `remote_files:write` - Add, edit, and delete remote files on a user's behalf.
  * `users.profile:read` - View profile details about people in a workspace.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.
  * `users:write` - Set presence for Sola.

#### 3. Install the Slack App

* Go to ***Install App***, click ***Install to Workspace***, and copy your ***Bot User OAuth Token***.

#### 4. Paste the *Bot User OAuth Token* in the Sola wizard.

#### 5. Click *Test Connection* to validate the details and continue.

</details>


---

# 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.sola.security/integrations/connectors/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.