Skip to main content
Each Chert project binds to one Slack channel. Install through the Settings page in the Chert console — the OAuth flow handles workspace authorization and writes a per-project bot token.

Before You Begin

Each project gets its own bot token. Installing into multiple projects from the same workspace means the workspace sees the same Chert app installed once, with the bot present in each bound channel.

Install Chert Notifications

1

Open Settings in the Chert console

Open your project at https://console.trychert.com/?project=<uuid>, then click Settings.
2

Click Connect Slack

The button kicks off the OAuth v2 flow. You will be redirected to slack.com/oauth/v2/authorize with the scopes listed below.
3

Authorize the app in Slack

Pick the workspace, review the requested scopes, and click Allow. Slack redirects back to Chert with an OAuth code.
4

Confirm the install

Settings shows Connected to <workspace>. The bot token is stored server-side and never exposed to the browser.
5

Pick a channel

The channel picker lists every public channel and every private channel the bot is a member of. Select the target channel and save.
6

Invite the bot to private channels

For private channels, run /invite @Chert Notifications in Slack so the bot can post.

Requested scopes

Install Chert Agent

Chert Agent is a separate Slack app with its own bot user. Install it through the same Settings page.
1

Open the Chert Agent connector

On Settings, scroll to Chert Agent. Click Connect.
2

Authorize and pick a channel

OAuth flow mirrors Chert Notifications. Pick the channel where you want @Chert Agent mentions to be answered.
3

Try it

In the channel: @Chert Agent how are we doing today?
Both apps can live in the same channel. Chert Notifications posts reply cards; Chert Agent responds to @-mentions and posts proactive alerts.

Channel binding

See Also

Configuration

Notification routing, feature flags, and the Nth-reply filter.

Security

What scopes are used for what, and how tokens are stored.