# Use Ruam in Slack

Start and end your day with /ruam, and let your Slack status follow your day.

**Plans:** Every plan. **Who:** Owners and admins connect Slack for the team. Then each person links their own Slack.

An owner or admin connects Slack in **Settings > Integrations**. Then each person links their own Slack and can start, pause and end their day with **/ruam**.

## Before you start

Your team already connected Slack? Skip to **Link your own Slack** below.

When you connect Slack, Slack's install screen shows a red **App not approved by Slack** label. That's normal for a new Slack app that isn't in the Slack Marketplace yet, and it doesn't stop you from installing Ruam. Slack's Marketplace review usually takes a couple of months. The label goes away if Slack approves Ruam for the Marketplace.

Slack only ever sees your hours, your status and your breaks. Never sites, apps, page titles, notes or mood. Ruam never reads your Slack messages.

## Connect Slack for your team

### Step 1: Open Integrations

1. Click **Settings** at the bottom of the sidebar.
2. Click **Integrations**.
3. Click **Connect Slack**. To see what Ruam asks Slack for first, click **See what Ruam asks Slack for**.

### Step 2: Allow Ruam in Slack

1. Pick your workspace if Slack asks.
2. Slack asks to add the **/ruam** command and to send messages as Ruam. Nothing that reads messages or channels.
3. Click **Allow**.

Back in Ruam, the card says your team is connected to your workspace's Slack and shows how many people have linked theirs. You're linked too.

### Step 3: Choose what the team can use

1. **Start and end the day from Slack** turns on the **/ruam** command and Ruam's Home tab in Slack.
2. **Let people show their day in their Slack status** lets each person turn on their own status. It's off for each person until they turn it on, and by default it never replaces a status they set.

Both are on when you connect.

_Screenshot: Slack in Settings > Integrations, with the team's two switches_

## Link your own Slack

1. Type **/ruam** in Slack and click **Link your Slack**. Or click **Link your Slack** in **Settings > Connected accounts** (in **Settings > Integrations** on Free and Solo).
2. Sign in to Slack with the same account you use there.
3. You're linked. The command you typed runs now, and Ruam replies in your messages with Ruam.

**If something looks different**

- **Your team hasn't connected Slack yet:** Ruam says so. In **Settings > Connected accounts**, you can ask your team's owner to connect it.
- **A link from Slack stopped working:** links from Slack work for a short while. Type **/ruam** again for a new one.

## Use /ruam

Type these in any channel or in your messages with Ruam. Only you see the replies.

- **/ruam start**: start your day.
- **/ruam break**: take a break.
- **/ruam back**: end your break.
- **/ruam end**: end your day.
- **/ruam status**, or just **/ruam**: see today's hours.
- **/ruam help**: see this list.

If your hours count with the web clock, these start, pause and end it. The web clock counts while a Ruam tab is open, as it always does. If they count with the Chrome extension or Ruam for Mac or Windows, start your day and take breaks there; Slack tells you where. On a day without a shift, **/ruam end** ends your day. On a shift day, your shift ends it: **/ruam end** tells you when, and how to stop early in the app or the extension.

## Let your Slack status follow your day

1. In **Settings > Connected accounts** (**Settings > Integrations** on Free and Solo), turn on **Show when I'm working in my Slack status**.
2. Click **Continue in Slack** and allow Ruam to set and clear your Slack status.

Ruam sets your status when your day starts, changes it for a break, and clears it when your day ends. It says you're working or on a break, never why you're away. **Don't replace a status I set myself** is on unless you turn it off, so a status you set stays put.

## The Ruam Home tab

Open Ruam in Slack's sidebar to see today's counted hours, whether you're working, on a break or done, your breaks, the next thing you can do, and this week's hours by day. It also says whether your Slack status follows your day, with a link to change it in Ruam. Your days are only compared with each other, never with a target.

## Unlink or disconnect

- **Unlink** removes your own link and your status. Your team's connection stays. You can undo it right away. On Free and Solo there's no separate Unlink: **Disconnect** does both.
- **Disconnect**, for owners and admins, ends the connection for the whole team. You can undo it for a few minutes. Then Ruam ends its access at Slack and deletes its Slack tokens.

If someone removes Ruam from your workspace in Slack, Ruam stops working in Slack at once and deletes its token. Settings says when it stopped, and owners and admins get an update in Ruam. Slack statuses Ruam set may still show until people clear them. Nothing changes in Ruam: your hours stay as they are.

## What Ruam keeps from Slack

- Your workspace's name, id and address, who connected it and when, and which Slack user is linked to which person in Ruam. These stay after a disconnect, so a reconnect picks up where it left off.
- The Slack access tokens, stored encrypted. A person's status token is kept while they're linked, and deleted when they unlink, the team disconnects, or Slack takes it back.
- The last status Ruam set for you, so it never overwrites yours.

Ruam doesn't read or store Slack messages or channel contents.

## Common questions

**Q:** Why does Slack say "App not approved by Slack"?
Ruam isn't in the Slack Marketplace yet. That's normal for a new Slack app and doesn't stop you from installing it. Slack's review usually takes a couple of months.

**Q:** Which plans include Slack?
Every plan.

**Q:** Does my manager see what I do in Slack?
No. Ruam never reads Slack. Your team sees your hours in Ruam as always.

**Q:** Can Slack start Ruam on my Mac or in Chrome?
No. Start your day in Ruam for Mac or Windows or the extension. On a day without a shift, **/ruam end** can end it. On a shift day, your shift ends it, or you stop early in the app or the extension. Starting your day from Slack in any app [is on our roadmap](https://ruam.ai/roadmap#slack-start-anywhere).

**Q:** Slack says commands are off for my team. Why?
An owner or admin turned off **Start and end the day from Slack** in **Settings > Integrations**.

## Coming to Slack

[Approvals](https://ruam.ai/roadmap#slack-approvals), a [team summary](https://ruam.ai/roadmap#slack-team-summary), [starting your day from any app](https://ruam.ai/roadmap#slack-start-anywhere) and [time off](https://ruam.ai/roadmap#slack-time-off). See the [roadmap](https://ruam.ai/roadmap) for where each one stands.

## What's next?

- [How does Ruam count my time?](https://help.ruam.ai/articles/how-does-ruam-count-my-time)
- [Take a break](https://help.ruam.ai/articles/take-a-break)

Source: https://help.ruam.ai/articles/use-ruam-in-slack
Updated: Nov 14, 2026
