[Intum](https://intum.fr/aide.md) / [Organizacja](https://intum.fr/aide/organizacja.md)

# [Tagi](https://intum.fr/aide/organizacja/tagi.md) | [API](#api)

## Tagi

Tagi to kolorowe etykiety, które można przypisywać do różnych obiektów w systemie. Ułatwiają kategoryzację, filtrowanie i szybkie odnajdywanie powiązanych elementów.

## Gdzie można używać tagów?

Tagi są dostępne w następujących modułach:

- **Zadania** — oznaczanie zadań np. typem pracy, projektem, priorytetem nieformalnym
- **Połączenia VoIP** — kategoryzacja rozmów telefonicznych
- **Klienci CRM** — segmentacja klientów (np. branża, wielkość, region)
- **Emaile** — oznaczanie wiadomości (np. pilne, do odpowiedzi, newsletter)
- **Tickety helpdesku** — kategoryzacja zgłoszeń (np. awaria, reklamacja, pytanie). Szczegóły: [Tagi w ticketach](../helpdesk/tagi-w-ticketach)

## Zarządzanie tagami

Tagi zarządzane są w jednym miejscu: **Organizacja → Tagi** (`/organize/tags`).

Każdy tag ma:

- **Nazwę** — unikalna w ramach konta (automatycznie małe litery)
- **Kolor** — wyświetlany jako tło etykiety na listach i w widokach szczegółowych
- **Dostępność** — można wybrać w których modułach tag jest widoczny:
  - **Używaj wszędzie** — tag dostępny we wszystkich modułach
  - Lub wybrane moduły: zadania, rozmowy, klienci, emaile, tickety

## Dodawanie tagów do obiektów

Tagi można dodać:

- **Na formularzu** tworzenia/edycji (np. nowe zadanie, edycja ticketa) — pole wielokrotnego wyboru z wyszukiwaniem
- **Inline na widoku** (np. show zadania) — przycisk + z selectem tagów
- **Przez API** — parametr `tag_names` z tablicą nazw tagów

Przy wpisywaniu nazwy taga, która nie istnieje, system automatycznie utworzy nowy tag (jeśli użytkownik ma uprawnienia do edycji tagów).

## Filtrowanie po tagach

W zaawansowanym wyszukiwaniu (zadania, tickety) dostępny jest filtr **Tagi**. Kliknięcie taga na liście również filtruje wyniki — wyświetla tylko obiekty z danym tagiem.

## Widoczność tagów

Tagi wyświetlają się jako kolorowe etykiety:

- **Na listach** — pod tytułem obiektu (np. pod tytułem zadania, ticketa)
- **Na widoku szczegółowym** — w sekcji z informacjami
- **W wyszukiwarce** — jako aktywne filtry (chipy)

## Łączenie tagów

Jeśli powstały duplikaty tagów (np. bug i bugs), można je połączyć — wszystkie powiązania zostaną przeniesione na jeden tag, a drugi zostanie usunięty.

## Dostęp z ustawień modułów

Link do tagów dostępny jest również z poziomu ustawień poszczególnych modułów, np.:

- **Helpdesk → Ustawienia** → link Tagi (filtruje tagi używane w ticketach)

---

## 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 | `/organize/tags.json` | Lista tagów |
| GET | `/organize/tags/:id.json` | Pojedynczy tag |
| POST | `/organize/tags.json` | Utworzenie tagu |
| PATCH | `/organize/tags/:id.json` | Aktualizacja tagu |
| DELETE | `/organize/tags/:id.json` | Usunięcie tagu |

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

## Pola tagu

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa tagu (unikalna, lowercase) |
| `description` | string | nie | Opis tagu |
| `color` | string | nie | Kolor hex (domyślnie `#d3d3d3`) |
| `all_modules` | boolean | nie | Dostępny we wszystkich modułach (domyślnie true) |
| `use_in_tasks` | boolean | nie | Dostępny w zadaniach |
| `use_in_emails` | boolean | nie | Dostępny w mailach |
| `use_in_clients` | boolean | nie | Dostępny w klientach CRM |
| `use_in_calls` | boolean | nie | Dostępny w rozmowach VoIP |

## Tworzenie tagu

```
POST /organize/tags.json
Authorization: Bearer TOKEN
```

```json
{
  "tag": {
    "name": "pilne",
    "color": "#EF4444",
    "description": "Sprawy wymagające natychmiastowej reakcji"
  }
}
```

## Aktualizacja tagu

```
PATCH /organize/tags/:id.json
```

```json
{
  "tag": {
    "color": "#F59E0B",
    "use_in_tasks": true,
    "use_in_emails": true,
    "all_modules": false
  }
}
```

## Dodatkowe endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| POST | `/organize/tags/find_or_create` | Znajdź lub utwórz tag po nazwie |
| GET | `/organize/tags/search_names.json?q=pilne` | Wyszukiwanie tagów po nazwie |
| POST | `/organize/tags/join_tags` | Scalenie wielu tagów w jeden |

## Błędy (422)

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