> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Slack

> Connect your Slack so your agent can alert the team when a conversation needs a person.

Slack is the **escalation** integration. When someone asks to speak to a person, or something happens that your team needs to know about right now, your agent posts the alert to the right channel while the conversation is still live.

It is how you avoid finding out the next day that an important customer left angry.

## What you need first

* A **Slack** workspace and permission to install apps in it. In many teams an administrator approves that.
* The **channel** where the alerts should land, already created.
* The **Starter** plan or higher in Ryvo, with the Engine module active.

## How to connect it

<Steps>
  <Step title="Open Settings › Integrations">
    In the portal, go to **Settings** and then **Integrations**. Find the **Slack** card.
  </Step>

  <Step title="Click Connect app">
    Slack's install screen opens in a new window. Meanwhile the card shows **In progress**.
  </Step>

  <Step title="Pick the workspace and authorize">
    Select the workspace where you want the alerts and accept the permissions.
  </Step>

  <Step title="Come back to Ryvo">
    You land back on the Integrations screen on your own and the card turns to **Connected**. Slack asks nothing else.
  </Step>

  <Step title="Invite the app to your channel">
    In Slack, open the channel where you want the alerts and type `/invite` followed by the app name. Without that step, the app can see the channel but cannot post to it.
  </Step>
</Steps>

## What your agent can do once it is connected

| Action             | What it does in the conversation                                                                                        |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Find channel**   | Finds the right channel before posting the alert.                                                                       |
| **Alert on Slack** | Posts the message to the team: when the person asks for a human, or when something happens they need to know about now. |

Actions are turned on one by one from **View actions** and the [**Tools**](/guides/agents/tools) section of the builder, with a cap of **10 integration actions per agent**.

<Note>
  Your agent does **not read** your team's Slack. It only posts to the channels you invited it to, on purpose: reading internal conversations mid-call with a customer would expose information that is none of its business.
</Note>

## What to do if something fails

| What you see                                          | What happened                                            | What to do                                                                          |
| ----------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| The alert never reaches the channel                   | The app is not invited to that channel                   | In Slack, open the channel and type `/invite` with the app name                     |
| The install ends with a permissions error             | Your workspace requires an administrator to approve apps | Ask a Slack administrator to approve it and click **Connect app** again             |
| **The account stopped responding. Connect it again.** | Someone uninstalled the app from Slack                   | Click **Reconnect**: Ryvo revokes the old access and opens the install from scratch |