> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Konwersacje

> Monitoruj i zarządzaj konwersacjami agentów AI we wszystkich kanałach

## Przegląd

Strona Konwersacje to ujednolicony panel dla wszystkich interakcji między Twoimi agentami AI a klientami — niezależnie od tego, który agent prowadził rozmowę i z jakiego kanału korzystał odwiedzający (widget, telefon, Telegram, WhatsApp itp.).

Ta strona działa tak samo dla wszystkich trybów pracy agenta. W trybie **Active** widzisz konwersacje obsługiwane przez AI. W trybie **Passive** widzisz konwersacje obsługiwane przez Twój zespół z dołączonymi danymi audytu i analizy agenta. W trybie **Hybrid** oba typy pojawiają się w jednym ujednoliconym widoku.

Przejdź do **Conversations** w menu bocznym, aby otworzyć tę stronę.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-list-light.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=4527306470f26f1db5dd45c393b515e4" alt="Lista konwersacji" width="2878" height="1547" data-path="images/conversations-list-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-list-dark.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=d609cf875b44ceb6af5ca9a6f936a817" alt="Lista konwersacji" width="2872" height="1549" data-path="images/conversations-list-dark.png" />
</Frame>

## Tabela konwersacji

Tabela wyświetla wszystkie konwersacje ze wszystkich agentów, posortowane według daty (najnowsze najpierw). Każdy wiersz zawiera:

| Kolumna        | Opis                                                                                 |
| -------------- | ------------------------------------------------------------------------------------ |
| **Agent**      | Nazwa agenta i firma z ikoną kanału                                                  |
| **Sesja**      | Identyfikator sesji odwiedzającego                                                   |
| **Kanał**      | Plakietka kanału komunikacji — Widget, Web, Telegram, WhatsApp, VoIP, Messenger, CRM |
| **Status**     | Aktualny stan — Active (trwająca), Closed (zakończona) lub Archived                  |
| **Wiadomości** | Łączna liczba wiadomości w konwersacji                                               |
| **Ocena**      | Ocena klienta od 1 do 5 lub `—` jeśli nie oceniono                                   |
| **Data**       | Kiedy rozpoczęła się konwersacja                                                     |
| **Akcje**      | Przycisk usuwania                                                                    |

Kliknij nagłówek dowolnej kolumny (Agent, Status, Wiadomości, Ocena, Data), aby zmienić kolejność sortowania.

### Filtrowanie

Kliknij przycisk **Filter**, aby dodać filtry. Każdy filtr zawęża wyniki:

| Filtr          | Opcje                                                 |
| -------------- | ----------------------------------------------------- |
| **Status**     | Active, Closed, Archived                              |
| **Kanał**      | Web, Widget, Telegram, WhatsApp, VoIP, Messenger, CRM |
| **Agent**      | Wybierz spośród wszystkich swoich agentów             |
| **Min. ocena** | 1+, 2+, 3+, 4+, 5                                     |
| **Data od**    | Wybór daty z kalendarza                               |
| **Data do**    | Wybór daty z kalendarza                               |

Wiele filtrów działa jednocześnie (logika AND). Usuń filtr klikając `×` na jego etykiecie.

### Wyszukiwanie

Pole wyszukiwania wykonuje wyszukiwanie bez rozróżniania wielkości liter w trzech wymiarach jednocześnie:

* **ID sesji** — częściowe dopasowanie
* **Nazwa agenta** — częściowe dopasowanie
* **Treść wiadomości** — przeszukuje wszystkie wiadomości konwersacji

## Szczegóły konwersacji

Kliknij dowolny wiersz, aby otworzyć panel szczegółów — boczny panel wysuwający się z prawej strony. Panel ma dwie kolumny: główny obszar treści (lewy) i pasek boczny z metadanymi (prawy).

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-detail-light.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=eab190fe48e0ea0e5917eea752ac62ed" alt="Szczegóły konwersacji" width="2871" height="1548" data-path="images/conversations-detail-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-detail-dark.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=fb3ea5c5a0e93cc29849cf00675cf28a" alt="Szczegóły konwersacji" width="2874" height="1549" data-path="images/conversations-detail-dark.png" />
</Frame>

### Odtwarzacz audio

Dla konwersacji głosowych (VoIP, widget głosowy) na górze panelu pojawia się wbudowany odtwarzacz audio. Funkcje:

* **Odtwarzanie/Pauza** z wizualną falą dźwiękową
* **Prędkość odtwarzania** — przełączanie między 0.5×, 1.0×, 1.5×, 2.0×
* **Przeskakiwanie** do przodu i do tyłu o 5 sekund
* **Przewijanie** przez kliknięcie w dowolne miejsce na fali dźwiękowej
* **Automatyczne przechodzenie** — gdy jedna wiadomość się kończy, następna wiadomość audio odtwarza się automatycznie

Pliki audio są przechowywane na serwerze dla każdej konwersacji i ładowane na żądanie po otwarciu panelu szczegółów.

Dla konwersacji tekstowych odtwarzacz jest zastępowany wskaźnikiem „tylko tekst".

### Pasek boczny z metadanymi

Zawsze widoczny po prawej stronie panelu:

| Pole             | Opis                                                      |
| ---------------- | --------------------------------------------------------- |
| **Data**         | Kiedy rozpoczęła się konwersacja                          |
| **Tylko tekst**  | Czy konwersacja zawiera wiadomości głosowe                |
| **Kanał**        | Kanał komunikacji                                         |
| **Czas trwania** | Łączny czas konwersacji lub „Ongoing" jeśli nadal aktywna |
| **Wiadomości**   | Łączna liczba wiadomości                                  |
| **Tokeny**       | Łączna liczba tokenów LLM (prompt + completion)           |
| **Ocena**        | Ocena klienta w gwiazdkach (1–5) lub „No rating"          |
| **Agent**        | Który agent prowadził konwersację                         |

## Trzy zakładki

Główny obszar treści zawiera trzy zakładki:

### Przegląd

Szybkie podsumowanie konwersacji:

* **Status rozmowy** — Active, Closed lub Archived
* **Jak zakończyła się rozmowa** — powód zakończenia lub „Completed"
* **Sentyment** — ton konwersacji analizowany przez AI (pozytywny, negatywny, neutralny) lub „Not analyzed"
* **ID sesji** — unikalny identyfikator sesji odwiedzającego

### Transkrypcja

Pełna historia wiadomości wyświetlana jako dymki czatu. Pokazywane są tylko wiadomości użytkownika i asystenta — wiadomości systemowe i narzędziowe są ukryte. Wiadomości użytkownika pojawiają się jako zwykły tekst; wiadomości asystenta obsługują bogate formatowanie (pogrubienie, linki, listy, tabele, bloki kodu, obrazy).

<Note>
  Wiadomości są paginowane po 50 na stronę. Dla długich konwersacji najnowsze wiadomości wyświetlane są jako pierwsze.
</Note>

### Dane klienta

Najbardziej szczegółowa zakładka — łączy metadane konwersacji, pamięć wyodrębnioną przez AI oraz powiązaną analitykę śledzenia.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-client-data-light.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=d3728f8df91a4f15d2dc2082266eeebc" alt="Zakładka danych klienta" width="2874" height="1547" data-path="images/conversations-client-data-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/4EfgP7VsUm0A5Y8o/images/conversations-client-data-dark.png?fit=max&auto=format&n=4EfgP7VsUm0A5Y8o&q=85&s=755bb4cd2095380de1abdcc84b2d4dcb" alt="Zakładka danych klienta" width="2880" height="1544" data-path="images/conversations-client-data-dark.png" />
</Frame>

#### Konwersacja

Siatka informacyjna z 8 komórkami: Kanał, Status, Czas trwania, Wiadomości, Sentyment, Konwersja (Tak/Nie), ID sesji i Data rozpoczęcia.

#### Pamięć

<Tip>
  Pola pamięci są wyodrębniane przez agenta AI podczas konwersacji na podstawie instrukcji w prompcie systemowym. Mogą zawierać dowolne dane, które agent jest skonfigurowany do zbierania — imię klienta, telefon, e-mail, numer zamówienia, zainteresowanie produktem, status kwalifikacji itp.
</Tip>

Jeśli konwersacja ma wyodrębnione dane pamięci, pojawiają się jako siatka kart klucz-wartość. Klucze i wartości są wyświetlane dokładnie tak, jak zapisał je AI. Dane pamięci są przechowywane jako JSON w rekordzie konwersacji i aktualizowane w czasie rzeczywistym w miarę wyodrębniania nowych informacji przez agenta.

#### Sesja (z Trackera)

Jeśli konwersacja odwiedzającego jest powiązana z sesją śledzenia (przez widget na stronie), panel pokazuje analitykę sesji:

* **Urządzenie** — komputer, telefon lub tablet
* **Przeglądarka** i **System operacyjny**
* **Kraj** i **Miasto** — geolokalizacja odwiedzającego
* **Strona docelowa** — pierwszy URL otwarty przez odwiedzającego
* **Źródło ruchu** — skąd przyszedł odwiedzający
* **UTM source** i **UTM medium** — parametry atrybucji kampanii
* **Czas sesji** — łączny czas na stronie
* **Odwiedzone strony** — liczba wyświetlonych stron
* **Odrzucenie** — czy odwiedzający opuścił stronę po jednej stronie

#### Odsłony stron

Jeśli powiązana sesja ma odsłony, każda strona jest wyświetlana z tytułem, czasem spędzonym i procentem przewinięcia.

#### Zdarzenia

Zdarzenia nie-wyzwalające zarejestrowane podczas sesji — kliknięcia, przesłania formularzy, zdarzenia niestandardowe — z ich nazwami, typami i znacznikami czasu.

#### Wyzwalacze

Zdarzenia wyzwalające, które zebrały dane formularza lub inne ustrukturyzowane informacje. Każdy wyzwalacz pokazuje nazwę, typ akcji, znacznik czasu i rozwijany blok JSON z zebranymi polami danych. Przycisk kopiowania pozwala skopiować surowy JSON.

## Ocena

### Ocena klienta

Odwiedzający mogą ocenić konwersację od 1 do 5 gwiazdek przez widget. Ocena i opcjonalny komentarz wyświetlane są zarówno w tabeli, jak i w panelu szczegółów. W razie potrzeby można usunąć ocenę klienta z panelu szczegółów.

### Zużycie tokenów

Każda konwersacja śledzi zużycie tokenów LLM — tokeny promptu (wejściowe) i tokeny odpowiedzi (wyjściowe). Suma jest pokazywana na pasku bocznym z metadanymi. Pomaga to monitorować koszty AI na konwersację.

## Usuwanie konwersacji

Kliknij ikonę kosza w wierszu tabeli, aby usunąć konwersację. Przed usunięciem pojawia się okno potwierdzenia. Usunięcie konwersacji trwale usuwa:

* Wszystkie wiadomości i ich treść
* Wszystkie pliki audio przechowywane na serwerze
* Wszystkie powiązane oceny

<Warning>
  Usunięcie jest nieodwracalne. Nagrań audio i historii wiadomości nie można odzyskać.
</Warning>