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

# Connect Slack

> Connect Slack to enable @ewake mentions, alert routing, and proactive reports in your workspace.

<Info>
  **What you'll get:** Once connected, your team can mention `@ewake` in any channel for on-demand investigation help. Ewake will also deliver On-Call Agent alerts and Scheduled Task reports directly in Slack.
</Info>

***

## Two ways to connect

| Option                      | When to use it                                                                               |
| --------------------------- | -------------------------------------------------------------------------------------------- |
| **From Ewake organisation** | Default. One-click OAuth — simplest.                                                         |
| **From a manifest**         | Slack admin blocks non–first-party / Marketplace apps; org requires internally-created apps. |

***

## Option 1 — From Ewake organisation

Recommended unless your Slack admin policy blocks third-party apps.

<Steps>
  <Step title="Open your Ewake dashboard">
    In your Ewake instance, go to **Integrations** → **Slack** → **Connect Slack**.
  </Step>

  <Step title="Choose From Ewake organisation">
    Select **From Ewake organisation**. You'll be redirected to Slack's OAuth authorization page.

    <img src="https://mintcdn.com/ewakeai/M1QmRrA-jDM2VkcE/images/slack/connect-modal.png?fit=max&auto=format&n=M1QmRrA-jDM2VkcE&q=85&s=e9ec5fe740f5dd3ecaa6a4881e9a4cbf" alt="Connect Slack button in Ewake dashboard" style={{ maxHeight: "320px", objectFit: "cover", objectPosition: "top", borderRadius: "8px" }} width="2421" height="1686" data-path="images/slack/connect-modal.png" />
  </Step>

  <Step title="Review and authorize">
    Review the requested permissions and click **Allow**.

    Ewake requests the following Slack permissions:

    * Read messages in channels where Ewake is added
    * Post messages and replies in channels
    * Send direct messages to users
    * Read workspace member list

    See the [full scope list](/security/permissions#slack) for details.
  </Step>

  <Step title="Redirected back to Ewake">
    After authorizing, you'll be automatically redirected back to the Ewake dashboard.

    <Check>
      Slack is connected. You can now mention `@ewake` in any channel where the bot is present.
    </Check>
  </Step>
</Steps>

***

## Option 2 — From a manifest (custom app)

Use this when your Slack admins only allow apps your own workspace owns (i.e. they block apps that aren't listed in the Slack Marketplace). Instead of installing Ewake's shared Slack app via OAuth, you create your own internal Slack app from a manifest Ewake provides and hand Ewake its bot token.

Functionally it's identical to the standard install — Ewake reads channels and posts messages using the bot token, and Slack's API doesn't care which app issued it.

<Steps>
  <Step title="Open Connect Slack in Ewake">
    In your Ewake dashboard, go to **Integrations** → **Slack** → **Connect Slack**, then choose **From a manifest**.
  </Step>

  <Step title="Copy the manifest">
    Copy the manifest shown in the dialog. It's pre-filled for your environment — don't use a manifest from another source.
  </Step>

  <Step title="Create the app in Slack">
    Open [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From a manifest**. Select your workspace, paste the manifest, and create the app.
  </Step>

  <Step title="Add the app icon">
    Manifests can't set the icon. Under **Basic Information** → **Display Information**, upload the Ewake icon (otherwise the app shows a blank icon).
  </Step>

  <Step title="Install to your workspace">
    Under **OAuth & Permissions**, click **Install to Workspace** and approve.
  </Step>

  <Step title="Copy the bot token">
    Copy the **Bot User OAuth Token** (starts with `xoxb-`) from **OAuth & Permissions**.
  </Step>

  <Step title="Paste the token in Ewake">
    Back in the Ewake dialog (**Paste bot token** step), paste the token and click **Install**.

    <Check>
      Ewake verifies the token, checks it has the required permissions, and activates the integration. Invite `@ewake` to the channels you want it to work in.
    </Check>
  </Step>
</Steps>

### What Ewake does with the token

* Verifies the token and reads the workspace identity (`auth.test`)
* Confirms the app was granted the required bot scopes. If any are missing, the install is rejected and the missing scopes are listed.
* Stores the bot token securely and binds Ewake to your workspace

The bot only reads channels it's been added to — invite `@ewake` to the channels you want it to work in.

### Troubleshooting

**"Missing required Slack scopes"** — add the listed scopes under **OAuth & Permissions**, click **Reinstall to Workspace**, then paste the new `xoxb-` token.

**"Invalid Slack token"** — make sure you copied the **Bot User OAuth Token** (`xoxb-…`), not an App-Level token (`xapp-…`) or user token (`xoxp-…`).

**Ewake isn't responding in a channel** — invite `@ewake` to that channel; the bot only reads channels it's a member of.

***

## Add Ewake to a channel

Ewake needs to be invited to each Slack channel where you want it to operate.

<Steps>
  <Step title="Open the channel">
    Go to the Slack channel where you want Ewake active (e.g. `#alerts`, `#incidents`).
  </Step>

  <Step title="Open channel settings">
    Click the **channel name** at the top to open settings.
  </Step>

  <Step title="Go to Integrations tab">
    Navigate to the **Integrations** tab → click **Add apps**.
  </Step>

  <Step title="Add Ewake">
    Search for **Ewake** and click **Add**.

    <Check>
      Ewake is now in this channel. Mention `@ewake` to start a conversation.
    </Check>
  </Step>
</Steps>

***

## Next step

<Card title="Connect Datadog →" icon="chart-line" href="/integrations/observability/datadog" horizontal />

<Card title="What does Ewake access in Slack? →" icon="shield-halved" href="/security/permissions#slack" horizontal />