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

# [Filtry](https://intum.fr/aide/mail/filtry.md) | [API](#api)

## Czym są filtry?

Filtry automatycznie wykonują akcje na przychodzących [e-mailach](e-maile) na podstawie zdefiniowanych warunków. Np. e-maile od konkretnego klienta mogą być automatycznie przypisywane do odpowiedniej osoby i przenoszone do [folderu](foldery).

## Jak działają filtry

Gdy przychodzi nowy e-mail, system sprawdza filtry od najwyższego priorytetu. Jeśli e-mail spełnia warunki filtra — wykonywana jest akcja.

## Warunki filtra

Filtr może sprawdzać:

- **E-mail nadawcy** — konkretny adres e-mail
- **Domena nadawcy** — wszystkie adresy z danej domeny
- **Temat** — zawiera określoną frazę
- **[Skrzynka](skrzynki-e-mail) odbiorcza** — e-mail trafił do konkretnej skrzynki
- **Osoba odpowiedzialna** — aktualnie przypisany odpowiedzialny

Filtr musi mieć **co najmniej jeden warunek**.

## Akcje filtra

Gdy warunki są spełnione, filtr może:

- **Zmienić odpowiedzialnego** — przypisać e-mail do [użytkownika](../organizacja/uzytkownik), [grupy](../organizacja/grupa) lub [zespołu](../organizacja/zespol)
- **Przekierować** — wysłać kopię na inny adres e-mail
- **Zmienić priorytet** — ustawić priorytet od 1 do 5
- **Przenieść do folderu** — przypisać do [folderu](foldery)
- **Zarchiwizować** — automatycznie zarchiwizować e-mail

Filtr musi mieć **co najmniej jedną akcję**.

## Tworzenie filtra

1. Przejdź do **Mail** → **Filtry**
2. Kliknij **+** (Nowy filtr)
3. Wypełnij:
   - **Nazwa** — nazwa filtra
   - **Priorytet** — kolejność sprawdzania
   - **Warunki** — co musi spełnić e-mail
   - **Akcje** — co zrobić z e-mailem
4. Zapisz

Filtr można też utworzyć **bezpośrednio z e-maila** — system automatycznie wypełni warunki na podstawie nadawcy.

## Testowanie filtra

Po utworzeniu filtra można uruchomić **test** — system sprawdzi istniejące e-maile i pokaże które pasują do warunków, bez wykonywania akcji.

## Priorytet filtrów

Filtry są sprawdzane od najwyższego priorytetu. Pierwszy pasujący filtr wykonuje swoją akcję.

## Ważne informacje

- Filtr musi mieć co najmniej **1 warunek** i co najmniej **1 akcję**
- Adres w polu **Przekieruj na** musi być poprawnym adresem e-mail
- Priorytet e-maila musi być liczbą od **1 do 5**
- Filtr można **dezaktywować** bez usuwania

---

## 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**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/mail/filters.json` | Lista filtrów |
| GET | `/mail/filters/:id.json` | Pojedynczy filtr |
| POST | `/mail/filters.json` | Utworzenie filtra |
| PATCH | `/mail/filters/:id.json` | Aktualizacja filtra |
| DELETE | `/mail/filters/:id.json` | Usunięcie filtra |

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

## Pola filtra

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa filtra |
| `description` | string | nie | Opis |
| `active` | boolean | nie | Czy aktywny (domyślnie true) |
| `priority` | number | nie | Priorytet sprawdzania |
| `condition_email_from` | string | nie | Warunek: e-mail nadawcy |
| `condition_domain_from` | string | nie | Warunek: domena nadawcy |
| `condition_subject` | string | nie | Warunek: temat zawiera |
| `condition_email_to_id` | integer | nie | Warunek: ID skrzynki odbiorczej |
| `condition_responsible_id` | integer | nie | Warunek: ID odpowiedzialnego |
| `condition_responsible_type` | string | nie | Warunek: typ odpowiedzialnego |
| `responsible_to_id` | integer | nie | Akcja: ID nowego odpowiedzialnego |
| `responsible_to_type` | string | nie | Akcja: typ nowego odpowiedzialnego |
| `forward_to` | string | nie | Akcja: przekieruj na adres e-mail |
| `email_priority_to` | number | nie | Akcja: nowy priorytet (1-5) |

## Tworzenie filtra

```
POST /mail/filters.json
Authorization: Bearer TOKEN
```

```json
{
  "filter": {
    "name": "VIP klienci",
    "condition_domain_from": "vip-firma.pl",
    "responsible_to_id": 5,
    "responsible_to_type": "Account::UserSetting",
    "email_priority_to": 3
  }
}
```

## Testowanie filtra

```
POST /mail/filters/:id/run_test_filter.json
```

Sprawdza istniejące e-maile bez wykonywania akcji.

## Błędy (422)

```json
{"name": ["nie może być puste"]}
```