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

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

## Co to jest grupa

Grupa to zbiór [użytkowników](uzytkownik) połączonych wspólnym celem - najczęściej do zarządzania mailami i współdzielenia odpowiedzialności. Grupa musi mieć co najmniej jednego członka.

## Do czego służy grupa

- **Obsługa maili** - e-maile mogą być przypisane do grupy zamiast do konkretnej osoby. Każdy członek grupy widzi te wiadomości i może na nie odpowiedzieć
- **Współdzielone skrzynki** - grupa może być odpowiedzialna za skrzynkę pocztową, dzięki czemu kilka osób ma do niej dostęp
- **Foldery pocztowe** - foldery mogą należeć do grupy, a nie do pojedynczej osoby
- **Zadania** - zadanie można przypisać do grupy zamiast do jednego [użytkownika](uzytkownik)
- **Widget czatu** - grupa może odpowiadać za obsługę czatu na stronie

## Tworzenie grupy

1. Przejdź do **Ustawienia** → **Grupy**
2. Kliknij **+** (Nowa grupa)
3. Wypełnij:
   - **Nazwa** - unikalna nazwa grupy (np. "Programiści", "Obsługa klienta")
   - **Opis** - opcjonalny opis przeznaczenia grupy
   - **Użytkownicy** - wybierz członków grupy (minimum 1)
4. Zapisz

## Ważne informacje

- Grupa musi mieć **co najmniej jednego członka**
- Nazwa grupy musi być **unikalna** w ramach konta
- Grupę można dezaktywować bez usuwania
- **Powiadomienia nie są wysyłane do grup** - tylko do indywidualnych [użytkowników](uzytkownik). Członkowie grupy widzą przypisane elementy na swoim dashboardzie

---

## 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 | `/account/groups.json` | Lista grup |
| GET | `/account/groups/:id.json` | Pojedyncza grupa |
| POST | `/account/groups.json` | Utworzenie grupy |
| PATCH | `/account/groups/:id.json` | Aktualizacja grupy |
| DELETE | `/account/groups/:id.json` | Usunięcie grupy |

**Autoryzacja:** `Authorization: Bearer TOKEN`

## Pola grupy

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa grupy (unikalna) |
| `description` | string | nie | Opis grupy |
| `active` | boolean | nie | Czy aktywna |
| `user_ids` | array | nie | ID użytkowników — członków grupy |

## Tworzenie grupy

```
POST /account/groups.json
Authorization: Bearer TOKEN
```

```json
{
  "group": {
    "name": "Obsługa klienta",
    "description": "Grupa odpowiedzialna za wsparcie",
    "user_ids": [1, 2, 3]
  }
}
```

## Aktualizacja grupy

```
PATCH /account/groups/:id.json
```

Wysyłasz tylko zmieniane pola. `user_ids` zastępuje całą listę członków.

```json
{
  "group": {
    "name": "Support",
    "user_ids": [1, 2, 3, 4]
  }
}
```

## Błędy (422)

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