Skip to main content
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.

Two ways to connect

OptionWhen to use it
From Ewake organisationDefault. One-click OAuth — simplest.
From a manifestSlack 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.
1

Open your Ewake dashboard

In your Ewake instance, go to IntegrationsSlackConnect Slack.
2

Choose From Ewake organisation

Select From Ewake organisation. You’ll be redirected to Slack’s OAuth authorization page.Connect Slack button in Ewake dashboard
3

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 for details.
4

Redirected back to Ewake

After authorizing, you’ll be automatically redirected back to the Ewake dashboard.
Slack is connected. You can now mention @ewake in any channel where the bot is present.

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.
1

Open Connect Slack in Ewake

In your Ewake dashboard, go to IntegrationsSlackConnect Slack, then choose From a manifest.
2

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.
3

Create the app in Slack

Open api.slack.com/appsCreate New AppFrom a manifest. Select your workspace, paste the manifest, and create the app.
4

Add the app icon

Manifests can’t set the icon. Under Basic InformationDisplay Information, upload the Ewake icon (otherwise the app shows a blank icon).
5

Install to your workspace

Under OAuth & Permissions, click Install to Workspace and approve.
6

Copy the bot token

Copy the Bot User OAuth Token (starts with xoxb-) from OAuth & Permissions.
7

Paste the token in Ewake

Back in the Ewake dialog (Paste bot token step), paste the token and click Install.
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.

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.
1

Open the channel

Go to the Slack channel where you want Ewake active (e.g. #alerts, #incidents).
2

Open channel settings

Click the channel name at the top to open settings.
3

Go to Integrations tab

Navigate to the Integrations tab → click Add apps.
4

Add Ewake

Search for Ewake and click Add.
Ewake is now in this channel. Mention @ewake to start a conversation.

Next step

Connect Datadog →

What does Ewake access in Slack? →