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

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

## Deski (Desks)

Desk to osobna linia obsługi klienta. Każdy desk działa jak niezależna skrzynka [zgłoszeń](obsluga-zgloszen) z własnymi ustawieniami, kategoriami i numeracją.

## Kiedy używać wielu desków

- **Różne produkty** — osobny desk dla każdego produktu/usługi
- **Różne zespoły** — np. desk dla wsparcia technicznego i osobny dla sprzedaży
- **Różne języki** — desk polski i desk angielski
- **Różni klienci** — np. desk dla klientów premium i standardowych

## Konfiguracja desku

### Podstawowe ustawienia

- **Nazwa** — wyświetlana w widgecie i panelu
- **Opis** — dodatkowy tekst pod nazwą
- **Kolor** — kolor marki widoczny w [widgecie](support-widget)
- **Aktywny** — czy desk przyjmuje nowe zgłoszenia
- **Język** — język komunikacji z klientem

### Numeracja zgłoszeń

Każdy desk ma własny wzorzec numeracji — np. `#T-001`, `#SUP-2026-001`. Numery są unikalne w ramach desku.

### Skrzynka pocztowa

Desk można powiązać ze skrzynką e-mail. Dzięki temu system automatycznie wysyła powiadomienia do klientów:

- Po utworzeniu zgłoszenia
- Po dodaniu komentarza przez zespół

Treść e-maili (temat i treść) konfiguruje się bezpośrednio w ustawieniach desku.

### Załączniki

Można włączyć lub wyłączyć możliwość dodawania załączników przez klientów w widgecie.

### Bezpieczeństwo

Każdy desk ma klucz tajny używany do weryfikacji podpisów HMAC w [widgecie](support-widget). Można go wygenerować ponownie w razie potrzeby.

### Treść pomocy

Tekst informacyjny wyświetlany nad formularzem w widgecie — np. instrukcja jak opisać problem.

## Kod widgetu

W ustawieniach desku dostępny jest gotowy kod JavaScript do osadzenia [widgetu](support-widget) na stronie klienta.

## Statystyki

Każdy desk pokazuje liczniki:

- Wszystkich zgłoszeń
- Otwartych zgłoszeń
- Nieprzydzielonych zgłoszeń

---

## 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/desks.json` | Lista desków |
| GET | `/helpdesk/desks/:id.json` | Pojedynczy desk |
| POST | `/helpdesk/desks.json` | Utworzenie desku |
| PATCH | `/helpdesk/desks/:id.json` | Aktualizacja desku |
| DELETE | `/helpdesk/desks/:id.json` | Usunięcie desku |

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

## Pola desk

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa desku |
| `description` | text | nie | Opis desku |
| `color` | string | nie | Kolor HEX (np. `#3b82f6`) |
| `active` | boolean | nie | Czy aktywny (domyślnie `true`) |
| `attachments_enabled` | boolean | nie | Czy załączniki włączone (domyślnie `true`) |
| `locale` | string | nie | Język desku (`pl`, `en`, `uk`, `de`, `fr`, `es`, `cs`, `sk`) |
| `mailbox_id` | integer | nie | ID skrzynki pocztowej |
| `security_level` | string | nie | `"signature"` = wymagaj HMAC |
| `ticket_pattern` | string | nie | Wzorzec numeracji zgłoszeń |
| `help_content` | text | nie | Treść pomocy w widgecie |
| `email_ticket_created_subject` | string | nie | Temat e-maila przy utworzeniu |
| `email_ticket_created_body` | text | nie | Treść e-maila przy utworzeniu |
| `email_comment_added_subject` | string | nie | Temat e-maila przy komentarzu |
| `email_comment_added_body` | text | nie | Treść e-maila przy komentarzu |
| `default_send_on_create` | boolean | nie | Domyślnie wysyłaj e-mail przy tworzeniu |
| `default_send_on_comment` | boolean | nie | Domyślnie wysyłaj e-mail przy komentarzu |

## Przykład utworzenia

```json
{
  "api_token": "TOKEN",
  "desk": {
    "name": "Support techniczny",
    "color": "#3b82f6",
    "locale": "pl",
    "mailbox_id": 5,
    "help_content": "Opisz swój problem jak najdokładniej."
  }
}
```

## Odpowiedź

```json
{
  "id": 1,
  "name": "Support techniczny",
  "token": "abc123...",
  "color": "#3b82f6",
  "active": true,
  "attachments_enabled": true,
  "tickets_count": 0,
  "open_tickets_count": 0,
  "unassigned_tickets_count": 0
}
```

## Regeneracja klucza

Aby wygenerować nowy `secret_key` (dla podpisów HMAC widgetu):

```json
{
  "api_token": "TOKEN",
  "desk": {
    "regenerate_secret_key": "1"
  }
}
```

---

## Powiązane

- [Źródła wiedzy dla agenta AI](https://intum.fr/aide/noe-ai/zrodla-wiedzy-dla-agenta-ai.md)
- [Automatyczne odpowiedzi AI w Widgecie Helpdesk](https://intum.fr/aide/helpdesk/automatyczna-obsluga-uzytkownikow-z-ai.md)
- [Konfiguracja AI do obsługi użytkowników](https://intum.fr/aide/helpdesk/ai-w-helpdesk.md)