# Slack

## Can I connect multiple Slack accounts to Relay.app?

Due to limitations of the Slack API, unfortunately no—each Relay.app workspace can only be connected to a single Slack workspace. You'll see in your apps page that our "Add connection" feature is therefore unavailable for Slack.

## Can I connect a single Slack workspace to multiple Relay.app workspaces?

Unfortunately, no. Slack limits us to a one:one mapping of Relay.app and Slack workspaces.

Each Relay.app workspace can only be connected with one Slack workspace, and each Slack workspace can only be connected with one Relay.app workspace.

## How do I disconnect one Slack workspace and connect another?

You may find you need to disconnect and reconnect Slack if you want to connect your Relay.app workspace to a different Slack workspace. To do this, you'll need to both disconnect Slack in Relay.app and uninstall it from your Slack workspace.

First, disconnect Slack from your Relay.app workspace. Navigate to **Apps**, select **Slack**, and **delete** the connection.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-d03cde50d2f5ea34d54422b75040ce988cffab90%2Fimage.png?alt=media" alt="Relay.app Apps page showing Slack connection with delete option in the connection menu"><figcaption><p>Delete an existing Slack workspace connection</p></figcaption></figure>

Second, you need to uninstall Relay.app from your Slack workspace. This is important to avoid errors that your Slack workspace is already connected to another Relay.app workspace.

1. Open Slack and navigate to **Tools & settings** → **Manage apps**

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-b4b11c921659d7270f74ead4b500d362736fa9f0%2FScreenshot%202024-11-20%20at%207.49.04%E2%80%AFPM.png?alt=media" alt="Slack workspace menu showing Tools &#x26; settings dropdown with Manage apps option highlighted" width="563"><figcaption></figcaption></figure>

2. Select **Relay.app** and click **Uninstall**.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-2484a2d8f27d4511bd2ea66aed91fa1b09226434%2FScreenshot%202024-11-20%20at%207.51.09%E2%80%AFPM.png?alt=media" alt="Slack app management page showing Relay.app with Uninstall button to remove the app from workspace" width="563"><figcaption><p>Uninstalling the Relay.app app from Slack</p></figcaption></figure>

## I’m getting this request to "send or receive channel invitations" error message when I try to connect Slack. How do I resolve it?

The error says that apps that offer a Slack "send channel invitation" feature can only be installed by users who have permission to send and receive shared channel invitations.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf5FJit75xt77jcHXYCjDnnrlz_r8TrbOPJwOMBjuiLpqEbXU_d22942u5KPLXYvGNhM8mmYL2JxhSgCeeIv__iXh-C_jaPelG_aPeA49PvYqOd0QXX9cbG0auGNglV2RClyURa?key=VdLtxiEFHz6Sd5pY0M22GzM3" alt="Slack error dialog showing Need admin approval message for send or receive channel invitations permission"><figcaption><p>Slack permission error caused by limited user permissions</p></figcaption></figure>

You’ll need your admin to enable "Slack Connect" for your workspace and give you the ability to send and receive shared channel invitations. To do so, have your admin follow these steps:

1\. In Slack, navigate to the admin settings area.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-60bde982e7616684517d5f496bee940564a4f330%2FScreenshot%202024-12-16%20at%203.56.09%E2%80%AFPM.png?alt=media" alt="Slack admin settings navigation showing the path to configure workspace permissions and Slack Connect settings" width="563"><figcaption></figcaption></figure>

2\. Locate the option to configure who can manage Slack Connect Channels.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-8b0c6af8915bb8925b115016c80367be8f36b26e%2FScreenshot%202024-12-16%20at%203.57.09%E2%80%AFPM.png?alt=media" alt="Slack Connect channel management settings showing options to configure who can manage shared channels and invitations" width="563"><figcaption></figcaption></figure>

3\. Toggle the setting to enable your account.

Once enabled, your workspace will be able to connect with external channels and share invitations through bots. If you encounter any issues, please ensure you have the necessary permissions and that the feature is supported in your Slack plan.

## I can't find my Slack channel.

If you are trying to search for a Slack channel but it isn't showing up, you may need to provide the channel link directly.

In Slack, right-click on the channel in the sidebar, hover over **Copy**, and select **Copy link**.

<div data-full-width="false"><figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-f34348cb8070184b4218d365338bedf74535dac0%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

Then, in Relay.app, you can paste this link into any channel picker and select your channel.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-a29232a8ecf2c7e480f381cd04e611f8884db635%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

## I'm getting an error when trying to send messages to a private channel.

In order for the Relay.app bot to send messages to a private channel, it needs to be a member of that channel. You can do so in Slack by clicking on the **channel name > Integrations > Add an app** and select Relay.app.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-81b769b8b1a6f1adbe2b919577233867e41cd3cb%2FSlack%20-%20Add%20Relay%20bot%20to%20private%20channel.gif?alt=media" alt="Animated demonstration of adding Relay.app bot to a private Slack channel through the channel integrations menu" width="563"><figcaption></figcaption></figure>

## How can I nicely format AI-generated text in messages?

If you've tried to insert plain text into a Slack message, you may have noticed the formatting doesn't look right. To address this, you can add a markdown data transformation step. This will tell Relay.app to process the text as markdown and format it correctly.

<figure><img src="https://647519108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkKoEy3xMIYaIwd4mRAB%2Fuploads%2Fgit-blob-635debf7f5ad8b1582c2c8c1e9749b739b28fcca%2Fimage.png?alt=media" alt="Data transformation step configuration showing Markdown selected as the transformation type to format AI-generated text" width="563"><figcaption><p>Data transformation step applying a Markdown transformation</p></figcaption></figure>


---

# 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.relay.app/app-specific-faqs/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.