Connect Slack

Connect your Slack workspace so Tokenize can post alerts to a channel and send digests and coaching tips as direct messages.

Connecting Slack lets Tokenize post alerts to a channel you choose. It also lets Tokenize send weekly digests and coaching tips to people as direct messages.

Who can do this: Admins.

Connect your workspace

  1. Go to Settings → Integrations.
  2. On the Slack card, click Connect Slack.
  3. Slack opens. Review the permissions, choose the channel alerts should post to, and approve the install. Slack's channel picker searches your whole workspace.
  4. You return to Settings → Integrations with "Slack connected." The card shows your workspace name and the alert channel.

If you connected Slack before the channel picker moved into Slack, you don't need to reconnect. Your channel stays as it is.

Change the alert channel

There are two ways to change the channel:

  • In Slack. On the Slack card, click Change channel in Slack. Slack opens, where you can search every channel. Pick the channel and approve. If no channel is saved yet, the button reads Choose channel in Slack.
  • On the card. Click the channel field (Search channels), search, and pick a channel. You'll see "Alerts will be sent to #channel-name."

Private channels show up in the card's list once you invite Tokenize to them in Slack. Invite the app from the channel, then reload the page. Alerts need a channel, not a direct message.

In a large workspace the card's list may be incomplete or missing. If you see "Slack didn't send the channel list. Choose the channel in Slack instead." click Change channel in Slack.

Send a test message

Click the settings button on the Slack card and choose Send Test. Tokenize posts "Test alert from the dashboard — your channel is wired up." to the alert channel. Nothing is added to alert history.

You'll see "Test message sent to Slack." when it works. Send Test is available only after you've chosen a channel.

Coaching DMs

Coaching tips about people's own sessions are no longer set on the Slack card. The card says "Usage alerts are set on the Enablement page." and links there. See Send coaching tips in Slack and Share playbooks with Enablement. Alerts and weekly digests keep their own settings.

Disconnect Slack

  1. Click the settings button on the Slack card and choose Disconnect.
  2. Confirm Disconnect.

Alerts, digests, and coaching tips stop going to Slack until an admin connects it again.

Troubleshooting

"Slack connection was canceled." The install was declined in Slack. Click Connect Slack and approve it.

"Slack could not be connected. Try again." Something went wrong during the install. Click Connect Slack again.

"Slack connected, but Tokenize can't post in the channel you picked. For a private channel, invite Tokenize to it in Slack, then choose it again." Slack is connected, but the channel wasn't saved. Any channel you had before stays. Invite Tokenize to the channel in Slack, then choose it again.

"Slack connected, but the channel you picked wasn't saved. Choose it again." Slack is connected. Choose the channel again from the card or with Change channel in Slack.

"Slack connected, but alerts need a channel, not a direct message. Choose a channel." You picked a direct message in Slack. Choose a public or private channel instead.

"Slack can't find that channel. For a private channel, invite Tokenize to it in Slack first." Invite Tokenize to the channel in Slack, then pick it again.

"Slack did not accept the test message. Check the connection and channel." The channel may have been archived or deleted, or Tokenize may not have access to it. Pick another channel, or invite Tokenize to a private channel, and try again.

"Slack authorization was revoked. Reconnect to resume alert delivery." Someone removed the app from your Slack workspace. Click Reconnect Slack and approve the install again.

A manager doesn't get alert DMs. Tokenize finds people in Slack by email. Check that their Tokenize email matches their Slack email. See Alerts.