[Intum](https://intum.fr/aide.md) / [Mail](https://intum.fr/aide/mail.md)

# [Skrzynki e-mail](https://intum.fr/aide/mail/skrzynki-e-mail.md) | [API](#api)

## Czym jest skrzynka e-mail?

Skrzynka e-mail to adres pocztowy skonfigurowany w systemie do odbierania i wysyłania wiadomości. Każdy [e-mail](e-maile) należy do jednej skrzynki. Skrzynka określa z jakiego adresu wychodzi poczta i jaką stopkę dołączać.

## Tworzenie skrzynki

1. Przejdź do **Mail** > **Skrzynki**
2. Kliknij **+** (Nowa skrzynka)
3. Wypełnij:
   - **Nazwa** - nazwa wyświetlana (np. "Biuro", "Support")
   - **Adres e-mail** - adres pocztowy skrzynki
   - **Opis** - opcjonalny opis przeznaczenia
   - **Osoba odpowiedzialna** - domyślny odpowiedzialny za e-maile
   - **[Dział](../organizacja/dzial)** - opcjonalne przypisanie do działu
   - **Stopka** - HTML dołączany do każdego wysyłanego e-maila (patrz niżej)
4. Skonfiguruj SMTP (serwer wysyłki)
5. Zapisz i zweryfikuj skrzynkę

## Konfiguracja SMTP

Aby wysyłać e-maile, skrzynka musi mieć skonfigurowany serwer SMTP:

- **Dostawca** - Sendgrid, EmailLabs lub własny serwer SMTP
- **Adres SMTP** - adres serwera
- **Port** - port serwera
- **Login / Hasło** - dane uwierzytelniające
- **SSL** - szyfrowanie połączenia

## Weryfikacja

Nowa skrzynka wymaga weryfikacji. System wysyła kod weryfikacyjny na podany adres - po potwierdzeniu skrzynka staje się aktywna.

## Stopka

Stopka to blok HTML dołączany automatycznie na końcu każdego e-maila wysyłanego z danej skrzynki. Można w niej używać zmiennych w formacie `{{ zmienna }}`, które system podmieni na aktualne dane nadawcy.

Najprostsza stopka:

```html
<p>
  {{ first_name }} {{ last_name }}<br>
  {{ email }}
</p>
```

Dla użytkownika Jan Kowalski (jan@firma.pl) wygeneruje:

```
Jan Kowalski
jan@firma.pl
```

### Zmienne nadawcy

| Zmienna | Co wstawia |
|---------|------------|
| `{{ name }}` | Pełna nazwa |
| `{{ first_name }}` | Imię |
| `{{ last_name }}` | Nazwisko |
| `{{ email }}` | Adres e-mail |
| `{{ phone }}` | Telefon |
| `{{ domain }}` | Domena z adresu (np. firma.pl) |
| `{{ description }}` | Opis użytkownika |
| `{{ avatar }}` | Avatar (mały) |
| `{{ avatar_medium }}` | Avatar (średni) |
| `{{ avatar_large }}` | Avatar (duży) |

### Zmienne skrzynki i działu

| Zmienna | Co wstawia |
|---------|------------|
| `{{ mailbox_name }}` | Nazwa skrzynki |
| `{{ mailbox_email }}` | Adres skrzynki |
| `{{ department_name }}` | Nazwa działu (shortcut jeśli ustawiony, inaczej name) |
| `{{ department_description }}` | Opis działu |
| `{{ department_phone }}` | Telefon działu |
| `{{ department_email }}` | E-mail działu |

**Własne pola w dziale.** W ustawieniach działu możesz dodać dowolne własne pola, np. `facebook`, `mastodon`, `slack`. Każde wpisane pole od razu staje się zmienną w stopce - dla pola `facebook` użyjesz `{{ department_facebook }}`, dla `mastodon` - `{{ department_mastodon }}` itd. Wygodny sposób na dodanie social mediów albo własnych etykiet.

Własnymi polami nie nadpiszesz pól standardowych - telefon, e-mail i pozostałe pola z formularza działu zawsze trafiają do swoich zmiennych (`{{ department_phone }}`, `{{ department_email }}` itd.).

### Zmienne firmowe

Dane firmy (nazwa, NIP, adres, logo) pochodzą z **głównego działu konta**. Każde konto może mieć kilka działów; jeden z nich jest oznaczony jako główny i to z niego pobierane są dane firmowe do stopek.

| Zmienna | Co wstawia |
|---------|------------|
| `{{ company_name }}` | Nazwa firmy (shortcut działu lub nazwa) |
| `{{ company_email }}` | E-mail firmowy |
| `{{ company_phone }}` | Telefon |
| `{{ company_logo }}` | URL logo firmy |
| `{{ company_street }}` | Ulica |
| `{{ company_street_number }}` | Numer budynku |
| `{{ company_post_code }}` | Kod pocztowy |
| `{{ company_city }}` | Miasto |
| `{{ company_country }}` | Kraj |
| `{{ company_website }}` | Strona WWW |
| `{{ company_tax_no }}` | NIP |
| `{{ company_register_number }}` | REGON (numer rejestrowy) |
| `{{ company_court_number }}` | KRS (numer w rejestrze sądowym) |
| `{{ company_bank }}` | Nazwa banku |
| `{{ company_bank_account }}` | Numer konta bankowego |

Dla zgodności ze starymi szablonami nadal działają aliasy `{{ company_regon }}` (= `company_register_number`) oraz `{{ company_krs }}` (= `company_court_number`). W nowych stopkach używaj nowych nazw.

**Dodatkowe pola firmowe** (np. Facebook, LinkedIn, Mastodon). Wpisz je jako własne pola w głównym dziale konta - dla pola `facebook` w stopce zadziała `{{ company_facebook }}`, dla `linkedin` - `{{ company_linkedin }}` itd. Pola z listy powyżej edytuj w odpowiednich miejscach formularza działu - własne pola nie nadpisują pól standardowych.

**Priorytet źródeł danych firmy** (od najmniej do najbardziej istotnego):

1. Główny dział konta - dane domyślne dla całego konta
2. Dział skrzynki - jeśli skrzynka ma przypisany dział, jego dane nadpisują dane konta
3. Profil użytkownika - dane firmy wpisane w ustawieniach użytkownika nadpisują pozostałe

### Rozbudowana stopka

```html
<table>
  <tr>
    <td>{{ avatar_medium }}</td>
    <td>
      <strong>{{ first_name }} {{ last_name }}</strong><br>
      {{ email }} | {{ phone }}<br>
      {{ department_name }}
    </td>
  </tr>
</table>
<hr>
<p>
  <strong>{{ company_name }}</strong><br>
  {{ company_street }} {{ company_street_number }}<br>
  {{ company_post_code }} {{ company_city }}<br>
  NIP: {{ company_tax_no }}
</p>
```

Zmienne nadawcy będą inne dla każdego użytkownika wysyłającego e-mail z tej skrzynki. Te same zmienne dostępne są też w [szablonach](szablony) wiadomości.

## Autoresponder

Skrzynka może automatycznie odpowiadać na przychodzące wiadomości:

- **Włącz autoresponder** - aktywuje autoodpowiedź
- **Temat** - temat automatycznej odpowiedzi
- **Treść** - treść odpowiedzi
- **Godziny działania** - przedział czasowy, w którym autoresponder jest aktywny

Autoresponder można włączyć/wyłączyć zbiorczo dla wszystkich skrzynek jednocześnie z poziomu [ustawień maila](../mail/ustawienia).

## Ograniczenie nadawców

Można ograniczyć kto może wysyłać e-maile z danej skrzynki - opcja **Ogranicz nadawców** pozwala wybrać konkretnych użytkowników.

## Skrzynka prywatna

Skrzynka oznaczona jako **prywatna** jest widoczna tylko dla osób z odpowiednim uprawnieniem.

## Ważne informacje

- Adres e-mail musi być unikalny wśród aktywnych skrzynek w koncie
- Skrzynka musi być zweryfikowana aby wysyłać e-maile
- Stopka jest automatycznie dołączana do każdego wysyłanego e-maila
- Skrzynkę można dezaktywować bez usuwania


---

## 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 | `/mail/mailboxes.json` | Lista skrzynek |
| GET | `/mail/mailboxes/:id.json` | Pojedyncza skrzynka |
| POST | `/mail/mailboxes.json` | Utworzenie skrzynki |
| PATCH | `/mail/mailboxes/:id.json` | Aktualizacja skrzynki |
| DELETE | `/mail/mailboxes/:id.json` | Usunięcie skrzynki |

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

## Pola skrzynki

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa skrzynki |
| `email` | string | tak | Adres e-mail |
| `description` | string | nie | Opis |
| `active` | boolean | nie | Czy aktywna |
| `private` | boolean | nie | Czy prywatna (wymaga uprawnień admin) |
| `footer` | string | nie | Stopka HTML |
| `responsible_id` | integer | nie | ID odpowiedzialnego |
| `responsible_type` | string | nie | Typ: `Account::UserSetting`, `Account::Group`, `Organize::Team` |
| `department_id` | integer | nie | ID działu |
| `smtp_kind` | string | nie | Dostawca: `sendgrid`, `emaillabs`, `own` |
| `smtp_address` | string | nie | Adres serwera SMTP |
| `smtp_port` | integer | nie | Port SMTP |
| `smtp_username` | string | nie | Login SMTP |
| `smtp_password` | string | nie | Hasło SMTP |
| `smtp_ssl` | boolean | nie | SSL |
| `use_autoresponse` | boolean | nie | Włącz autoresponder |
| `autoresponse_subject` | string | warunkowo | Temat autoodpowiedzi (wymagany gdy autoresponder włączony) |
| `autoresponse_content` | string | warunkowo | Treść autoodpowiedzi |
| `select_senders` | boolean | nie | Ogranicz nadawców |
| `sender_ids` | array | nie | ID dozwolonych nadawców |

## Tworzenie skrzynki

```
POST /mail/mailboxes.json
Authorization: Bearer TOKEN
```

```json
{
  "mailbox": {
    "name": "Biuro",
    "email": "biuro@firma.pl",
    "footer": "<p>Pozdrawiamy, Zespół Firma</p>",
    "smtp_kind": "sendgrid",
    "smtp_username": "apikey",
    "smtp_password": "SG.xxx"
  }
}
```

## Dodatkowe endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/mail/my_mailboxes.json` | Skrzynki bieżącego użytkownika |
| POST | `/mail/mailboxes/turn_on_autoresponders` | Włącz autoresponder we wszystkich skrzynkach |
| POST | `/mail/mailboxes/turn_off_autoresponders` | Wyłącz autoresponder we wszystkich skrzynkach |

## Błędy (422)

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

---

## Powiązane

- [Autoresponder w skrzynce e-mail](https://intum.fr/aide/mail/autoresponder.md)