Skip to main content
  1. Assembled
  2. Integrations
  3. Slack

Slack integration

Updated

Plans and permissions:

  • Connect or reconnect Slack: Admin role, or a custom role with Configure third-party integrations set to Can configure third-party integrations
  • Use /assembled commands in Slack: Any role
  • The person who connects Slack needs permission to install apps in your Slack workspace.

Use the Slack integration to check who’s working without leaving Slack, and to send Assembled notifications to Slack channels and direct messages. Once it’s connected, anyone in your Slack workspace can type /assembled now to see who’s staffed, and you can choose Slack as a destination for real-time alerts and schedule change notifications.

To connect it, go to Configure > Third-party integrations and find the Slack card.

How the Slack integration works

  • Assembled connects to one Slack workspace. To reach a channel in another workspace, share the channel with the connected workspace.
  • Assembled can post notifications to public channels. To post to a private channel, add the Assembled app to that channel in Slack.
  • To send someone a direct message, Assembled needs their Slack ID. It matches people in Slack to people in Assembled by email once a day, so allow up to 24 hours after you connect. If someone’s email in Slack is different from their email in Assembled, set their Slack ID with a Slack ID column when you update people with a CSV file.
  • Replies to /assembled commands are visible only to the person who typed them.
  • To choose what Assembled sends to Slack, set up notifications in Configure > Notifications. See Notifications.

Connect Slack

You need a Slack account in the workspace you’re connecting, with permission to install apps. Depending on your workspace’s settings, a Workspace Owner or Admin may need to approve the app. See Slack’s guide to adding apps.

  1. Go to Configure > Third-party integrations, find the Slack card, and select Configure integration.
  2. If you want Assembled to post only in channels it’s been added to, select Only post in channels Assembled has been added to. Otherwise, leave it cleared.
  3. Select Connect integration.
  4. In Slack, review the permissions Assembled asks for, and allow them.

You’re returned to Assembled. The Slack card shows your Slack team, the Permissions you granted, who it was Authorized by, and when.

The connected Slack card in Assembled showing the Slack team, permissions, who authorized it, and a Connected status

Use /assembled commands

Type these commands in any Slack conversation or direct message.

Command What it does
/assembled now Lists who’s staffed right now, with each person’s event type and its times, and a View in Assembled button
/assembled now team "Team A" Lists who’s staffed right now in one queue, team, site, or skill. Start with queue, team, site, or skill, then the name, in quotes if it has spaces.
/assembled event Chat Lists who’s scheduled for an event type, such as Chat, over the next hour
/assembled help Lists the commands you can use

Each person in the list appears as their name, their event type, and the event’s start and end times.

Note: To filter /assembled now by queue, team, site, or skill, your Slack account must be linked to your person in Assembled. If it isn’t, Assembled asks you to connect your account first.

If the reply says nobody is staffed when people are scheduled, check that Slack is connected with the current permissions. See Reconnect Slack.

Reconnect Slack

Reconnect Slack when notifications stop posting, when the Permissions on the Slack card don’t include permissions such as chat:write and users:read.email, or when you want a different Slack account to own the connection. The Authorized by account on the card is the Slack account that connected the app, and it changes only when you reconnect.

  1. Go to Configure > Third-party integrations.
  2. On the Slack card, select the Edit integration menu, then Disable integration.
  3. In Disable Slack integration?, select Disable.
  4. Have the person who should own the connection, with permission to install Slack apps, connect Slack again as described in Connect Slack.

Disconnecting removes the Slack app’s authorization. It doesn’t change your schedules or other settings in Assembled.

Check the reconnection

After you reconnect, check that:

  • Authorized by on the Slack card shows the account that just reconnected.
  • /assembled now lists the people who are staffed.
  • Notifications post to your Slack channels.

Check a connection that still doesn’t work

  1. Check that the person who reconnected can install apps in your Slack workspace, not only manage a channel.
  2. Check the Permissions on the Slack card. If permissions are missing, the authorization in Slack wasn’t completed: reconnect, and allow every permission Slack shows.
  3. If you chose Only post in channels Assembled has been added to, add the Assembled app to each channel you want notifications in.

If it still doesn’t work, chat with our team and include a screenshot of the Permissions on the Slack card.

Related articles

Still have questions?