[Intum](https://intum.pl/pomoc.md) / [Mail](https://intum.pl/pomoc/mail.md)

# [Jak ustawić przekierowanie wiadomości, aby odbierać pocztę w Sugesterze?](https://intum.pl/pomoc/mail/e-maile.md) | [API](#api)

Uruchomienie odbierania wiadomości w Sugesterze opiera się na prostym mechanizmie przekierowania. Wystarczy skopiować unikalny adres wygenerowany w systemie i wkleić go w panelu swojego dostawcy poczty (np. Home.pl, Nazwa.pl czy Outlook). Dzięki temu cała korespondencja przychodząca automatycznie trafi do Twojego panelu w Sugesterze.

## Jak ustawić przekierowanie poczty krok po kroku?
1. Przejdź do menu nawigacyjnego i kliknij **ikronę czterech kropek** (Więcej opcji).
2. Wybierz z listy **Skrzynki e-mail**.
3. Upewnij się, że Twoja skrzynka została już dodana. Kliknij w nazwę wybranej skrzynki, aby wejść w jej podgląd
4. W sekcji **Przekierowanie i dostęp** odnajdziesz pole **Adres przekierowania**. Kliknij ikonę kopiowania obok adresu.

![](c3001b565c32-image - 2026-08-19T095410.062.png)
1. Zaloguj się do panelu administracyjnego swojego dotychczasowego dostawcy poczty i wklej skopiowany adres w ustawieniach przekierowań danej skrzynki e-mail.

## O czym warto pamiętać?
- **Kopie wiadomości:** Standardowe przekierowanie na poziomie skrzynki sprawia, że oryginał wiadomości pozostaje bezpieczny na serwerze Twojego dotychczasowego dostawcy poczty, a w Sugesterze masz kopię maili przychodzących
- **Przekierowanie z wielu skrzynek na jedną:** Jeśli chcesz odbierać wiadomości z kilku różnych adresów na jednej skrzynce w Sugesterze, możesz ustawić dla nich ten sam adres przekierowania.
- **Alternatywa - zmiana rekordów MX:** Jeśli wolisz, aby maile trafiały bezpośrednio do Sugestera (z pominięciem dotychczasowego serwera pocztowego), możesz skierować rekordy MX swojej domeny na nasze serwery. W takim modelu wszystkie wiadomości przychodzące do danej domeny będą automatycznie kierowane do Sugestera, a na serwerze u Twojego dotychczasowego dostawcy nie będą tworzone żadne kopie.
- **Limit wielkości wiadomości:** Maksymalny rozmiar przychodzącego e-maila (treść wraz z załącznikami) wynosi **40 MB**.
<h3>Film - jak ustawić przekierowanie</h3>
<p><iframe src="https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/2/65980b96d5b8c59dccf8ea428b0ef5fa841018a8?v=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2F59623f630f2a9efe283d886527e6ecce45b34f47&amp;poster=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2F4dbd0f850d9ffe4061b5a428e50e626aa6f70022&amp;start=0" style="width:100%;max-width:720px;aspect-ratio:16/9;height:auto;display:block;margin:0 auto;border:0" loading="lazy" frameborder="0" allowfullscreen></iframe></p>

---

## 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**

## API — E-maile

### Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/mail/emails.json` | Lista e-maili |
| GET | `/mail/emails/:id.json` | Pojedynczy e-mail |
| POST | `/mail/emails.json` | Utworzenie e-maila (wysłanie / szkic / zaplanowanie) |
| PATCH | `/mail/emails/:id.json` | Aktualizacja e-maila |
| DELETE | `/mail/emails/:id.json` | Usunięcie e-maila |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **mail**)

### Pola e-maila

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `subject` | string | tak\* | Temat wiadomości |
| `to` | string | tak\* | Adres odbiorcy (lub `cc`/`bcc` musi być podane) |
| `content` | string | tak\* | Treść wiadomości (HTML) |
| `mailbox_id` | integer | tak | ID skrzynki pocztowej |
| `from` | string | nie | Adres nadawcy (domyślnie: adres skrzynki) |
| `cc` | string | nie | Kopia (Dw) |
| `bcc` | string | nie | Ukryta kopia (Udw) |
| `reply_to` | string | nie | Adres do odpowiedzi |
| `send_status` | string | nie | Status: `sent` (wyślij), `draft` (szkic), `future` (zaplanuj) |
| `sent_at` | datetime | nie | Data wysyłki (dla `send_status: "future"`) |
| `priority` | number | nie | Priorytet (1-5) |
| `template_id` | integer | nie | ID szablonu |
| `email_id` | integer | nie | ID e-maila nadrzędnego (odpowiedź w wątku) |
| `tags` | array | nie | Tagi |
| `fields` | jsonb | nie | Własne pola |

\* Wymagane gdy `send_status` to `sent` lub `future`

### Wysyłanie e-maila

Aby e-mail został **faktycznie wysłany**, musisz podać `send_status: "sent"`. Bez tego parametru e-mail zostanie zapisany, ale nie wysłany.

```
POST /mail/emails.json
Authorization: Bearer TOKEN
Content-Type: application/json
```

```json
{
  "email": {
    "subject": "Witaj",
    "to": "klient@firma.pl",
    "content": "<p>Treść wiadomości</p>",
    "mailbox_id": 1,
    "send_status": "sent"
  }
}
```

E-mail jest kolejkowany w tle (SolidQueue) z 5-sekundowym opóźnieniem i wysyłany przez skonfigurowany serwis skrzynki (SMTP, AWS SES, EmailLabs, SendGrid).

### Zapisanie szkicu

```json
{
  "email": {
    "subject": "Szkic",
    "to": "klient@firma.pl",
    "content": "<p>Treść</p>",
    "mailbox_id": 1,
    "send_status": "draft"
  }
}
```

### Zaplanowanie wysyłki

```json
{
  "email": {
    "subject": "Zaplanowany",
    "to": "klient@firma.pl",
    "content": "<p>Treść</p>",
    "mailbox_id": 1,
    "send_status": "future",
    "sent_at": "2026-03-10T10:00:00Z"
  }
}
```

### Odpowiedź w wątku

```json
{
  "email": {
    "subject": "Re: Witaj",
    "to": "klient@firma.pl",
    "content": "<p>Odpowiedź</p>",
    "mailbox_id": 1,
    "email_id": 500,
    "send_status": "sent"
  }
}
```

### Dodatkowe endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| POST | `/mail/emails/:id/add_connected_task.json` | Powiąż z zadaniem |
| POST | `/mail/emails/:id/remove_connected_task.json` | Usuń powiązanie z zadaniem |
| POST | `/mail/emails/:id/change_priority.json` | Zmień priorytet |
| POST | `/mail/emails/:id/snooze.json` | Odłóż wątek |
| POST | `/mail/emails/:id/archive_and_next.json` | Archiwizuj i przejdź dalej |
| POST | `/mail/emails/set_as_spam.json` | Oznacz jako spam |
| POST | `/mail/emails/unspam.json` | Cofnij oznaczenie spam |
| POST | `/mail/emails/save_draft.json` | Zapisz szkic |
| GET | `/mail/emails/:id/get_content.json` | Pobierz treść e-maila |
| GET | `/mail/emails/:id/attachments.json` | Lista załączników |

### Błędy (422)

```json
{"subject": ["nie może być puste"]}
```

---

## Powiązane

- [Przekierowanie poczty z Gmaila do Intum](https://intum.pl/pomoc/mail/przekierowanie-poczty-z-gmaila.md)
