[Intum](https://intum.fr/aide.md) / [Mail](https://intum.fr/aide/mail.md)

# [Ustawienia Mail](https://intum.fr/aide/mail/ustawienia-mail.md) | [API](#api)

## Ustawienia modułu Mail

W ustawieniach modułu Mail (`/mail/settings`) można konfigurować ogólne zachowanie systemu pocztowego. Ustawienia dotyczą całego konta.

## Dostępne opcje

### Notatki

Pole tekstowe na wewnętrzne notatki dotyczące konfiguracji poczty — np. instrukcje dla zespołu, opis procedur obsługi.

## Regeneracja raportów

Możliwość wymuszenia regeneracji [raportów e-mail](raporty-e-mail) — system ponownie przetworzy dane statystyczne.

## Ustawienia indywidualne

Każdy użytkownik może dostosować moduł Mail do swoich preferencji:

- **Liczba e-maili na stronę** — ile wiadomości wyświetlać na liście
- **Domyślny widok** — skrzynka odbiorcza, wszystkie, itp.

## Ważne informacje

- Ustawienia Mail to **jeden rekord** na konto (automatycznie tworzony)
- Zmiany są natychmiastowe
- Dostęp wymaga uprawnień administratora modułu Mail

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

Ustawienia modułu Mail są zarządzane przez standardowy endpoint CRUD oraz `set_field`.

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/mail/settings.json` | Pobranie ustawień |
| PATCH | `/mail/settings.json` | Aktualizacja ustawień |
| POST | `/mail/settings/update_counters` | Reset liczników skrzynek |
| POST | `/mail/settings/update_all_reports` | Regeneracja raportów |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **mail**)

## Pola ustawień

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `notes` | string | nie | Notatki wewnętrzne |
| `fields` | object | nie | Pola konfiguracyjne (JSONB) |
| `secret_fields` | object | nie | Pola tajne (JSONB) |

## Aktualizacja ustawień

```
PATCH /mail/settings.json
Authorization: Bearer TOKEN
```

```json
{
  "setting": {
    "notes": "SMTP przez Sendgrid, weryfikacja co kwartał"
  }
}
```

## Ustawienia per użytkownik (via set_field)

```
POST /account/set_field?key=mail.inbox.per_page&value=50&target=user_setting
```

| Klucz | Wartości | Opis |
|-------|----------|------|
| `mail.inbox.per_page` | number | Liczba e-maili na stronę |