# Slack Integration {#slack-integration}


Receive notifications and interact with Gauzy from Slack.


## Overview {#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 {#setup}



### 1. Create Slack App {#1-create-slack-app}


1. Go to [api.slack.com/apps](https://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 {#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 {#3-connect-in-gauzy}


1. Navigate to **Integrations** → **Slack**
2. Click **Connect**
3. Select the Slack workspace
4. Choose the notification channel


## Notification Types {#notification-types}


| Event              | Slack Message              |
| ------------------ | -------------------------- |
| Timer started      | "🟢 John started tracking" |
| Timer stopped      | "🔴 John stopped (2h 30m)" |
| Timesheet approved | "✅ Timesheet approved"    |
| Task assigned      | "📋 New task assigned"     |


## Related Pages {#related-pages}


- [Microsoft Teams Integration](https://sourcey-gauzy.pages.dev/integrations/teams-integration/index.md) — Teams alternative
- [Employee Notifications](https://sourcey-gauzy.pages.dev/features/employee-notifications/index.md) — notification settings