# Slack

:::tip Available
This integration is active and ready to use on all Pro plans.
:::

Connect Slack to Frihet. Receive notifications of important financial events directly in your workspace.

## What does it do?

With Slack integrated:

- **Invoice notifications** — When an invoice is paid
- **Due date alerts** — Invoices due in the coming days
- **Collection reminders** — Clients with overdue invoices
- **Daily summaries** — Daily KPIs
- **Milestones achieved** — Monthly invoicing goal

## Requirements

- **Active Slack workspace** — Where you work
- **Admin permissions in Slack** — To install the app
- **Frihet Pro or higher**

## Install the Frihet app in Slack

### Step 1: Open Frihet

1. Go to **Settings** → **Integrations**
2. Search for **Slack**
3. Click **"Connect with Slack"**

### Step 2: Authorize in Slack

1. You will be redirected to Slack
2. Log in with your workspace
3. You will see the required permissions:
   - Send messages
   - Access basic information
   - Create connections
4. Click **"Authorize"**

### Step 3: Choose notification channel

1. Back in Frihet, choose **where to receive notifications**:
   - Channel **#finance** (if it exists)
   - Channel **#general**
   - Direct message with you
   - Custom channel

2. Save

## Available notifications

### Payments received

```
✅ Invoice paid
ABC Company paid €2,500
Invoice #1042 - 100% collected
Total collected this month: €15,340
```

Sent **instantly** when payment is detected.

### Overdue invoices

```
⚠️ Overdue invoice
Juan García owes €1,200
Invoice #1038 - Overdue by 5 days
Send reminder: Yes / No
```

Sent **every morning** with an overdue summary.

### Upcoming due dates

```
📅 Upcoming due dates (7 days)
- Company SL: €3,500 (due Feb 15)
- María García: €800 (due Feb 18)
Total: €4,300
```

Sent **every Monday** or every morning (configurable).

### Goals achieved

```
🎯 Goal achieved!
February invoicing: €12,000
Goal: €10,000 ✅ (20% exceeded)
```

Sent when you reach your monthly goal.

### Daily summary

```
📊 Frihet Summary - Feb 9, 2025
New invoices: 2 (€1,500)
Invoices paid: 1 (€2,000)
Expenses recorded: 3 (€340)
Net balance: +€3,160
```

Sent **every morning at the time you configure**.

### Expenses recorded

```
💰 Expense recorded
Juan García spent €45 on office supplies
(You recently spent this yourself)
```

Optional, to keep you updated.

## Configure notifications

### Open the notifications panel

1. **Settings** → **Integrations** → **Slack**
2. Click **"Configure notifications"**

### What to enable/disable

| Event | Recommendation |
|--------|-------------|
| **Payments received** | ✅ Always yes |
| **Upcoming due dates** | ✅ Very useful |
| **Overdue invoices** | ✅ Critical |
| **Goals achieved** | ✅ Motivating |
| **Daily summary** | ✅ Recommended |
| **New invoices created** | ⚪ Optional |
| **Expenses recorded** | ⚪ Only if working in a team |

### Configure frequency

```
Daily summary:
- At 08:30 (morning)
- At 18:00 (afternoon)
- Both (recommended)

Due date alerts:
- Every morning
- Only on Mondays
- Manual (on demand)
```

## Team mentions

If you work in a team on Slack, you can:

1. Mention someone in a notification
2. E.g.: "⚠️ @juan_manager: Overdue invoice of €2,500"

Configure in **Settings** → **Slack** → **Automatic mentions**.

## Quick commands in Slack

With Frihet in Slack, you can type commands:

### Quick summary

```
/frihet resumen
```

**Response:**
```
Total invoicing: €15,340
Total expenses: €2,100
Margin: €13,240 (86%)
Pending invoices: 3 (€4,500)
```

### Latest payments

```
/frihet pagos
```

**Response:**
```
Latest 5 payments:
1. ABC Company - €2,500 (Feb 8)
2. Juan García - €800 (Feb 6)
3. Startup XYZ - €1,200 (Feb 4)
...
```

### Clients with debt

```
/frihet vencidas
```

**Response:**
```
Overdue invoices:
- Juan García: €800 (5 days)
- Company SL: €2,100 (12 days)
Total: €2,900
```

### View goal

```
/frihet objetivo
```

**Response:**
```
February goal: €10,000
Invoiced to date: €8,340 (83%)
Remaining: €1,660 (7 days)
```

## Automatic reminders

### Send collection reminder

When an invoice is overdue, Frihet asks:

```
⚠️ Overdue invoice: Juan García €1,200

Actions:
[Send reminder] [Mark as paid] [Ignore]
```

Click **"Send reminder"** and Slack:

1. Creates a reminder email
2. Asks you if you want to send it
3. Sends it to the client

### Payment confirmation

When you mark an invoice as paid from Slack:

```
✅ Invoice #1042 marked as paid
ABC Company - €2,500
Updated in Frihet 2 seconds ago
```

## Disconnect Slack

1. Go to **Settings** → **Integrations** → **Slack**
2. Click **"Disconnect"**
3. Confirm

Afterwards:
- You will no longer receive notifications
- `/frihet` commands stop working
- You can reconnect at any time

## Privacy

- **No access to conversations** — Frihet only sends notifications
- **Encrypted data** — Between Frihet and Slack
- **No message history** — Messages are not saved in Frihet
- **Revocable at any time** — Disconnect whenever you want

## Troubleshooting

### "I'm not receiving notifications"

- Verify that Slack is connected ✅
- In **Configure notifications**, enable the events you want
- Check that you chose the correct channel
- Reload Frihet (F5)

### "Can I receive notifications in another channel?"

Yes. In **Settings** → **Slack** → **Notification channel**, change to another.

Options:
- Public channel (#finance)
- Private channel (#secret-projects)
- Direct message with you
- Subchannel (@frihet-bot)

### "The `/frihet` commands are not working"

- The app must be installed in your workspace ✅
- In Slack, search in the notification channel and mention @frihet
- It should then respond with command options

### "I work in a team and everyone receives notifications?"

Yes. If this is a problem, you can:

1. Use a private channel just for yourself
2. Or disable certain notifications that seem like spam
3. Mention specific people in **Settings** → **Automatic mentions**

## Next steps

- [Automate with n8n](./n8n)
- [Connect Google Calendar for important dates](./google-calendar)

---

**Previous:** [Clockify](./clockify)