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

# Set up the Slack integration

> Install the Chamelio Slack app for your organization, connect your own Slack account, and fix common Slack connection problems.

For what the Slack integration does, see [Chamelio for Slack](https://docs.chamelio.ai/guides/integrations/slack.md).

## Installation

**1. Access Integrations**

Go to **Settings > Org Integrations** in [Chamelio](https://app.chamelio.ai)

**2. Connect Slack**

On the **Slack** card, click **Connect**.

**3. Sign in to Slack**

Sign in to your Slack account when prompted in the browser

**4. Choose Workspace**

In the Slack pop-up dialog, use the menu at the upper right to select your workspace

**5. Get Admin Approval (if needed)**

If you're not a Slack admin, click **"Request"** in the "Request to install" tab. You can continue setup while the request is pending.

**6. Review Permissions**

Review the required permissions and click **Approve**

> [!NOTE]
>
> Your Slack connection is only used to link your Chamelio and Slack accounts. No personal information from Slack is accessed or used without explicit permission. All use is subject to our privacy policy.

## Connect your own Slack account

After an Admin installs Slack for your organization, each person who wants to use Chamelio in Slack should also connect their own Slack account. This tells Chamelio which Chamelio user you are when you message it in Slack.

**1. Open My integrations**

Go to **Settings > My integrations** in [Chamelio](https://app.chamelio.ai).

**2. Connect Slack**

On the **Slack** card, click **Connect**.

If you skip this step, Chamelio tries to match you by email instead. This only works if your Slack email is the same as your Chamelio email.

## Troubleshooting

**Installation issues** - Ensure you have the necessary permissions in both Slack and Chamelio. Contact your Slack workspace administrator for approval if needed.

**Integration not working** - Verify the app is properly installed in your workspace and that permissions haven't been changed. Share results in channels or DMs to confirm the app is responding.

**Chamelio doesn't respond, or replies "Could not identify your workspace."** - Chamelio couldn't link your Slack user to a Chamelio user who can use the AI Agent. Check the following:

1. Connect your own Slack account in **Settings > My integrations**. See [Connect your own Slack account](#connect-your-own-slack-account).
2. Make sure you're an [Agent User](https://docs.chamelio.ai/guides/user-management.md#agent-users). Ask an Admin if you're not sure.
3. Make sure your Slack email matches your Chamelio email. Connecting your own account in step 1 avoids this issue.
