Skip to main content

​
Overview & Benefits

Connect Timetracker with Slack to track time without leaving your team’s communication platform. Use slash commands, interactive buttons, and automated notifications to streamline your time tracking workflow.

​
What You Can Do

  • Start Timers: Begin time tracking with /timetracker start commands
  • Stop Timers: End active timers with /timetracker stop commands
  • Log Time: Record time entries manually with /timetracker log commands

​
Key Benefits

  • ⚡ Track time instantly without switching apps
  • 📱 Mobile-friendly commands work on all devices
  • 🎯 Project-focused tracking with task organization
  • 🔄 Real-time sync with your main Timetracker dashboard

​
Quick Setup Guide

​
Step 1: Install the Slack App

  1. Make sure you have a free or paid Timetracker account
  2. Navigate to Settings → Integrations → Slack → Connect
  3. Follow the OAuth flow to authorize Timetracker in your Slack workspace
The Slack app requires workspace admin approval. If you don’t have admin rights, ask your workspace administrator to install the app.

​
Step 2: Configure User Mapping

Critical: Unmapped users will not be able to use the /timetracker commands. You must complete this step for the integration to work.
  1. Navigate to Settings → Integrations → Slack → Configure button
  2. This will take you to the /slack-config page where you’ll see three sections to manage user connections:
  • Unmapped Slack Users: Find your Slack username in this list
  • Unmapped Team Members: Find your Timetracker account in this list
  • Currently Mapped Users: Shows successfully connected accounts
How user mapping works:
  • Each Slack user must be linked to a corresponding Timetracker team member account
  • This mapping tells the system which Timetracker account should receive the time entries from each Slack user
  • Without this mapping, commands will fail because the system doesn’t know where to save the time data
To connect your accounts:
  1. Use the dropdown menu next to your Slack username to select your corresponding Timetracker account
  2. Click Sync Users to refresh the user list if needed
  3. Test the connection by running /timetracker help in any Slack channel
Success: You’ll see the help message with available commands when the connection is working properly.

​
Step 3: Try Your First Command

Let’s start with a simple time tracking command: Example: Start a timer
  1. In any Slack channel, type: /timetracker start description:"Working on project documentation"
  2. Press Enter to execute the command
  3. You’ll see a confirmation message with your active timer
  4. Check your Timetracker dashboard to see the running timer

​
Step 4: Explore More Commands

Try these essential commands to get familiar with the integration: 
/timetracker start description:"Meeting with client"

​
What’s Next?

Now that you have the basics working, explore these features:

Commands Reference

Complete reference for all available commands and parameters.

Command Examples

See practical examples and real-world usage scenarios.

Interactive Features

Learn about buttons, modals, and other interactive elements.

Best Practices

Tips for effective time tracking and troubleshooting common issues.

​
Quick Start Commands

Try these essential commands to get familiar with the integration: 
/timetracker start description:"Meeting with client"

​
Need Help?