[Intum](https://intum.pl/pomoc.md) / [Automatyzacja](https://intum.pl/pomoc/automatyzacja.md)

# [Wyszukiwanie zaawansowane - filtruj po dowolnym polu z warunkami](https://intum.pl/pomoc/automatyzacja/wyszukiwanie-zaawansowane-filtruj-po-dowolnym-polu-z-warunkami.md) | [API](#api)

Zaawansowany filtr pozwala znaleźć rekordy po dowolnym polu z warunkiem: pole, operator i wartość, łączone w grupy. Zamiast "wszyscy klienci" możesz wyciągnąć dokładnie „klientów bez kontaktu od 30 dni" albo „firmy z regionu X, które wpłaciły ponad 10 tys.". Na start działa na liście klientów (/crm/clients), stopniowo w innych modułach.

## Gdzie to jest

Na liście klientów rozwiń wyszukiwanie i kliknij **Filtr zaawansowany**. Panel dosuwa się na żądanie - dopóki go nie otworzysz, nie obciąża listy. Zbudowany filtr uruchamiasz przyciskiem Szukaj razem z resztą pól wyszukiwania.

## Jak zbudować warunek

Każdy warunek to trzy elementy:

1. **Pole** - np. Nazwa, Status, Data utworzenia, Suma wpłat.
2. **Operator** - lista zależy od typu pola:
   - tekst: zawiera, jest, różne od, zaczyna się od, kończy się na, jest wypełnione,
   - liczba: równe, różne, większe, większe lub równe, mniejsze, mniejsze lub równe,
   - data: po (większe lub równe), przed (mniejsze lub równe), równe,
   - tak/nie: równe.
3. **Wartość** - to, z czym porównujemy.

Przyciskiem **Dodaj warunek** dokładasz kolejne. U góry wybierasz, czy mają być spełnione **wszystkie warunki** (AND) czy **dowolny z nich** (OR).

## Warunki dynamiczne (daty względne)

W polu daty nie musisz wpisywać konkretnej daty - możesz użyć wyrażenia, które przelicza się w momencie wyszukiwania. Wpisujesz je w podwójnych klamrach:

- `{{today}}` - dziś,
- `{{now}}` - teraz (z godziną),
- `{{7 days ago}}` - 7 dni temu (działa też weeks, months, years),
- `{{30 days ago}}` - 30 dni temu,
- `{{1 month ago}}`, `{{1 year ago}}`,
- `{{2 hours ago}}` - dokładnie 2 godziny temu (godziny i minuty bez zaokrąglania),
- `{{3 days from_now}}` - za 3 dni (w przyszłość).

Pole daty ma podpowiedzi z najczęstszymi wyrażeniami. Przykład użycia: warunek „Ostatnia aktywność | przed | `{{30 days ago}}`" znajduje klientów, z którymi nie było kontaktu od miesiąca. Zaletą wyrażeń względnych jest to, że zapisany filtr zawsze liczy od dziś - nie trzeba go co miesiąc poprawiać.

## Filtrowanie „po powiązaniach" bez czekania

Część pól to podsumowania z powiązanych danych, zapisane wprost na kliencie i dzięki temu szybkie w filtrowaniu: **Ostatnia aktywność**, **Pierwszy kontakt**, **Liczba kontaktów**, **Suma wpłat**. Pozwalają np. wyciągnąć „klientów z więcej niż 3 kontaktami" albo „z wpłatami powyżej 5 tys." bez budowania skomplikowanych zapytań.

## Tryb zaawansowany (własny JSON)

Dla bardziej złożonej logiki - np. zagnieżdżonych grup „A oraz (B lub C)" - jest przycisk **Zaawansowane (JSON)**. Otwiera pole, w które można wpisać warunek w formacie JSON, np.:

```
{ "any": [ { "status_id": 5 }, { "kind": { "contains": "vip" } } ] }
```

To samo pole wykorzystuje asystent AI - możesz opisać, czego szukasz, a on ułoży warunek. Nie musisz znać składni, żeby korzystać z prostego buildera; JSON to opcja dla zaawansowanych i dla AI.

## Bezpieczeństwo i ograniczenia

Filtrować można tylko po polach udostępnionych dla danej listy - pola spoza tej listy są ignorowane (także we wpisanym ręcznie JSON). To celowe zabezpieczenie. Filtr zawsze działa w obrębie Twojego konta i uprawnień - nie pokaże rekordów, do których nie masz dostępu.

## Zapisane segmenty

Zbudowany filtr można zapisać jako segment (nazwany zestaw warunków) - prywatny albo współdzielony z zespołem - i wracać do niego jednym kliknięciem. Segment jest przypisany do konkretnej listy (np. klientów).

## Wskazówki

- Zacznij od jednego warunku i dokładaj kolejne - łatwiej sprawdzić, czy zawęża tak jak chcesz.
- Do „nie kontaktowani od X" użyj daty względnej `{{X days ago}}` na polu ostatniej aktywności - filtr zostanie aktualny na przyszłość.
- Gdy warunek robi się skomplikowany („to oraz tamto, albo jeszcze coś"), przełącz się na tryb JSON albo poproś asystenta AI.

---

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



---

## Powiązane

- [Automatyzacje - reguły typu "kiedy, jeśli, to"](https://intum.pl/pomoc/automatyzacja/automatyzacje-reguly-typu-kiedy-jesli-to.md)