Slack Integration

The DevClocked Slack integration is a global Slack app installed with OAuth. It does not use a DevClocked API key. Workspace admins install the Slack app once, choose channels and posting rules, and each Slack user links their own DevClocked account when they want personal reports.

What gets connected

• Slack workspace app install — a DevClocked owner or admin installs the global DevClocked Slack app into a Slack workspace.
• DevClocked workspace mapping — DevClocked maps that Slack workspace to the current DevClocked workspace.
• Channel settings — admins choose which Slack channels can receive digests or public team report responses.
• Personal Slack user links — each user runs /devclocked connect once so DevClocked can answer their personal reports privately.

Slack workspace membership alone never grants access to DevClocked data. DevClocked always checks the linked DevClocked user and workspace role before returning reports.

Normal setup for a new DevClocked workspace

1. A DevClocked owner or admin opens Settings > Integrations > Slack.
2. Click Install Slack or Connect Slack.
3. DevClocked redirects to Slack OAuth.
4. Choose the Slack workspace and click Allow.
5. Slack redirects back to DevClocked.
6. DevClocked stores the Slack bot token encrypted server-side and maps the Slack workspace to the DevClocked workspace.
7. Back in DevClocked, open Manage channels and choose the channels that should receive digests or allow public team command responses.
8. In Slack, team members can run /devclocked to see available commands.
9. Each member runs /devclocked connect once to link their Slack user to DevClocked.

There is no manual Slack API dashboard setup for customers, no copying client secrets, and no DevClocked API key.

Add DevClocked to a new Slack channel

If the Slack workspace app is already installed, adding DevClocked to another channel is lightweight:

1. Open Settings > Workspace or Settings > Integrations > Slack > Manage channels.
2. Select the Slack channel.
3. Enable the options you want:
   • Daily team pulse
   • Weekly manager summary
   • Allow public team command responses
4. If Slack requires it, invite the app into the channel with /invite @DevClocked.
5. Run /devclocked team in that channel to test the team pulse.

Install DevClocked into a new Slack workspace

Each Slack workspace needs one OAuth install:

1. A DevClocked owner or admin opens Settings > Integrations > Slack.
2. Click Install Slack.
3. Choose the Slack workspace in Slack.
4. Click Allow.
5. Return to DevClocked and choose the channels for digests and public team reports.
6. Ask members to run /devclocked connect once in Slack.

Useful Slack commands

Command	What it does
/devclocked	Show the command menu and privacy notes.
/devclocked connect	Link your Slack user to your DevClocked account.
/devclocked me	Show your private weekly DevClocked report.
/devclocked today	Show your private report for today.
/devclocked active	Show your current active session, if one is running.
/devclocked projects	Show your enabled DevClocked projects.
/devclocked team	Show an aggregate team pulse from shared project rollups.
/devclocked project <name>	Show an aggregate pulse for one shared project.
/devclocked cost	Show the admin-only AI cost summary for the workspace.

Privacy rules

• Personal reports are private and visible only to the requester.
• Team and project reports use sanitized aggregate shared project rollups.
• Public channel responses only happen in channels approved by a DevClocked workspace admin.
• Cost reports are available only to DevClocked owners and admins.
• Slack membership is never treated as DevClocked authorization.

Troubleshooting

I see no team activity in Slack.

Team reports only use shared project rollups. Create or share a DevClocked team project, add members, and make sure there is shared activity in that project.

Team reports are only visible to me.

The Slack channel has not been approved for public team report posting. A DevClocked workspace admin can enable public team command responses in Manage channels.

A user sees a connect prompt.

They need to run /devclocked connect and open the one-time DevClocked link. The Slack workspace install and the personal Slack user link are separate on purpose.

I see two DevClocked slash commands.

The Slack workspace likely has an old test app installed alongside the global DevClocked app. Remove the duplicate app from Slack app management and keep the canonical DevClocked app.