> For the complete documentation index, see [llms.txt](https://docs.messageflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.messageflow.com/pl/e-mail/e-mail-api/raport-e-maili.md).

# Raport e-maili

Zakładka **Raporty e-maili** umożliwia dostęp do szczegółowych logów wiadomości w czasie rzeczywistym. Dzięki tej funkcji można monitorować status każdej wiadomości na bieżąco, co jest niezwykle przydatne w śledzeniu jej drogi od momentu przekazania do MessageFlow, do momentu dostarczenia lub odrzucenia. Narzędzie to pozwala na dokładne zrozumienie, co dzieje się z każdą wiadomością na każdym etapie procesu dostarczania.

### Wyszukiwarka

W sekcji Wyszukiwarka można zdefiniować kryteria wyszukiwania logów wiadomości e-mail, co pozwala na precyzyjne znalezienie informacji o wysłanych wiadomościach. Użytkownik ma możliwość skorzystania z poniższych opcji filtracji.

<figure><img src="/files/2kycS1I0QoOcl91T6vvA" alt=""><figcaption></figcaption></figure>

#### **Opcje wyszukiwania**

* **Wybierz datę:** Funkcja umożliwia wybranie zakresu dat, w których szukane wiadomości zostały wysłane. Jest to kluczowy parametr, który zawęża wyniki do wiadomości wysłanych w określonym przedziale czasowym.
* **Status:** Opcja ta pozwala na filtrowanie wiadomości według ich aktualnego statusu, np. injected, ok, hardbounce, open itp.
* **E-mail do:** Umożliwia wyszukiwanie wiadomości na podstawie adresu e-mail odbiorcy. Jest to przydatne, gdy poszukuje się szczegółowych informacji dotyczących korespondencji z konkretnym odbiorcą.
* **Message ID:** Funkcja ta umożliwia precyzyjne wyszukiwanie wiadomości na podstawie jej unikalnego identyfikatora, przypisywanego do każdej wysłanej wiadomości e-mail.
* **Konto SMTP:** Pozwala na zawężenie wyników wyszukiwania do wiadomości wysłanych z wybranego subkonta SMTP.

Po zdefiniowaniu kryteriów wyszukiwania, należy kliknąć przycisk **Szukaj**, aby wyświetlić wyniki.

### Lista e-maili

Sekcja Lista e-maili prezentuje szczegółowe logi wiadomości spełniających wybrane kryteria wyszukiwania. Każda wiadomość jest przedstawiona w formie tabeli z podstawowymi informacjami, takimi jak: **Data injected**, **E-mail do**, **Message ID**, **Konto** i **Status**.

#### **Szczegółowe logi wiadomości**

Aby uzyskać dostęp do szczegółowych informacji dotyczących wybranej wiadomości, należy kliknąć na jej rekord w tabeli. Po rozwinięciu szczegółów wiadomości, widoczne są następujące informacje:

* **Czas przyjęcia i dostarczenia:** Dokładne daty zmiany statusów.
* **Dane nagłówkowe:** Nadawca, Odbiorca, Temat.
* **Statusy:** Ostateczny status (np. ok, hardbounce) oraz ewentualne komunikaty błędów z serwera odbiorczego (np. powód odrzucenia).
* **Zaangażowanie:** Informacje o otwarciu e-maila oraz kliknięciach w linki (wraz z datami).
* **Tagi:** Przypisane etykiety (jeśli stosowano tagowanie).
* **Rozmiar wiadomości:** Całkowita waga e-maila wraz z załącznikami.

<figure><img src="/files/3gpJTmsZuKSikz7ESsx5" alt=""><figcaption></figcaption></figure>

### Eksportowanie logów (CSV)

Panel MessageFlow umożliwia wygenerowanie raportu z logami do zewnętrznego pliku. Aby to zrobić, należy skorzystać z przycisku **Eksportuj**, znajdującego się nad wyszukiwarką.

Jak pobrać plik? Ze względu na dużą ilość danych, raport jest generowany w tle.

1. Kliknij przycisk **Eksportuj**.
2. Przejdź do zakładki **Lista operacji**.
3. Przy wygenerowanym raporcie kliknij przycisk **Pobierz**.

<figure><img src="/files/ee7aKmnKWVKW20tTg1Jb" alt=""><figcaption></figcaption></figure>

Pobrany plik w formacie `.csv` zawiera szczegółowe dane techniczne i statusowe dla każdej wiadomości, m.in. unikalny identyfikator wiadomości, czas utworzenia i ostatniej aktualizacji logu, tagi przypisane do wiadomości, odbiorcę, nadawcę, temat, wielkość wiadomości oraz wskaźniki KPI.