[Intum](https://intum.fr/aide.md) / [Helpdesk](https://intum.fr/aide/helpdesk.md)

# [Kategorie](https://intum.fr/aide/helpdesk/kategorie.md) | [API](#api)

## Kategorie zgłoszeń

Kategorie pozwalają klasyfikować [zgłoszenia](obsluga-zgloszen) w ramach [desku](desk). Klient może wybrać kategorię przy tworzeniu zgłoszenia przez [widget](support-widget), co ułatwia priorytetyzację i kierowanie zgłoszeń do odpowiednich osób.

## Zastosowanie

- **Klasyfikacja** — np. "Błąd", "Pytanie", "Propozycja funkcji", "Rozliczenia"
- **Automatyczne przydzielanie** — kategoria może mieć domyślną osobę lub grupę odpowiedzialną
- **Priorytetyzacja** — kategorie mają priorytet, który wpływa na kolejność wyświetlania

## Ustawienia kategorii

- **Nazwa** — widoczna dla klienta w widgecie
- **Kod** — identyfikator wewnętrzny
- **Kolor** — kolor wyróżniający kategorię
- **Priorytet** — kolejność wyświetlania (wyższy = wyżej na liście)
- **Desk** — do którego desku należy kategoria
- **Osoba odpowiedzialna** — domyślna osoba lub grupa przydzielana do zgłoszeń w tej kategorii
- **Treść pomocy** — tekst wyświetlany w widgecie gdy klient wybierze tę kategorię
- **Instrukcja AI** — wskazówki dla asystenta AI dotyczące obsługi zgłoszeń w tej kategorii


---

## 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 | `/helpdesk/categories.json` | Lista kategorii |
| GET | `/helpdesk/categories/:id.json` | Pojedyncza kategoria |
| POST | `/helpdesk/categories.json` | Utworzenie kategorii |
| PATCH | `/helpdesk/categories/:id.json` | Aktualizacja kategorii |
| DELETE | `/helpdesk/categories/:id.json` | Usunięcie kategorii |

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

## Pola category

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa kategorii |
| `code` | string | nie | Kod wewnętrzny |
| `description` | text | nie | Opis kategorii |
| `color` | string | nie | Kolor kategorii |
| `priority` | integer | nie | Priorytet (domyślnie `0`) |
| `desk_id` | integer | nie | ID desku |
| `selected_responsible_id` | string | nie | ID domyślnej osoby/grupy odpowiedzialnej |
| `ai_instruction` | text | nie | Instrukcja dla AI |
| `help_content` | text | nie | Treść pomocy wyświetlana w widgecie |

## Przykład utworzenia

```json
{
  "api_token": "TOKEN",
  "category": {
    "name": "Błąd techniczny",
    "code": "bug",
    "color": "#ef4444",
    "desk_id": 1,
    "priority": 10,
    "help_content": "Opisz kroki do odtworzenia błędu."
  }
}
```

## Odpowiedź

```json
{
  "id": 5,
  "name": "Błąd techniczny",
  "code": "bug",
  "color": "#ef4444",
  "priority": 10,
  "desk_id": 1,
  "help_content": "Opisz kroki do odtworzenia błędu.",
  "ai_instruction": null
}
```

---

## Powiązane

- [Konfiguracja AI do obsługi użytkowników](https://intum.fr/aide/helpdesk/ai-w-helpdesk.md)