ื“ืœื’ ืœืชื•ื›ืŸ ื”ืจืืฉื™

Slack Integration

Receive notifications and interact with Gauzy from Slack.

Overviewโ€‹

The Slack integration enables:

  • Timer notifications in Slack channels
  • Task status updates
  • Time tracking from Slack commands
  • Daily digest messages
  • Timesheet approval notifications

Setupโ€‹

1. Create Slack Appโ€‹

  1. Go to api.slack.com/apps
  2. Create a new app from scratch
  3. Enable Incoming Webhooks
  4. Add Bot Token Scopes: chat:write, commands
  5. Install to workspace

2. Configureโ€‹

Set environment variables:

GAUZY_SLACK_CLIENT_ID=your-client-id
GAUZY_SLACK_CLIENT_SECRET=your-client-secret
GAUZY_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...

3. Connect in Gauzyโ€‹

  1. Navigate to Integrations โ†’ Slack
  2. Click Connect
  3. Select the Slack workspace
  4. Choose the notification channel

Notification Typesโ€‹

EventSlack Message
Timer started"๐ŸŸข John started tracking"
Timer stopped"๐Ÿ”ด John stopped (2h 30m)"
Timesheet approved"โœ… Timesheet approved"
Task assigned"๐Ÿ“‹ New task assigned"