Obsługa Klienta

Centralne miejsce odpowiedzi na wiadomości z 7 platform sprzedażowych oraz skrzynek email. Zastępuje konieczność logowania się osobno na każdą platformę.

Co zostało dostarczone

• Agregacja wiadomości z platform (Allegro, eBay, Amazon, Erli, Joom, Temu, WooCommerce) oraz wszystkich skrzynek email (IMAP).
• Odpisywanie z poziomu panelu — bez logowania na platformę.
• Przypisanie skrzynek do opiekunów — w konfiguracji konta email można wskazać odpowiedzialnego operatora.
• Wizualny edytor scenariuszy automatycznych w /cs/scenarios — patrz Automatyzacje.
• Klasyfikacja AI wiadomości na kategorie (zwroty, pytania o produkt, reklamacje, ogólne) — przekazywane do scenariuszy.

Jak korzystać

1. Wejdź w Obsługa Klienta w bocznym menu panelu.
2. Filtruj według platformy lub skrzynki email.
3. Kliknij wątek, aby zobaczyć całą historię.
4. Wpisz odpowiedź i wybierz z którego konta chcesz odpowiedzieć.

Znane ograniczenia i naprawy w toku

Zgłoszenie #5 — Brak widocznej odpowiedzi na email

Status: 🟡 W naprawie (TASK-267).

Wiadomości wysłane z panelu do email (np. test gmail → gmail) nie pojawiają się w historii wątku. Naprawa polega na włączeniu pobierania kopii z folderu Wysłane (IMAP) oraz korelacji po Message-ID.

Zgłoszenie #6 — Brak widocznych wiadomości wysłanych w panelu

Status: 🟡 W naprawie (TASK-267).

To samo zjawisko co #5 dla wiadomości wysyłanych przez API platform (np. Allegro). Naprawa: zapis każdej wysyłki do cs_messages natychmiast po sukcesie API, tak by wątek odświeżał się bez czekania na powtórny pull z platformy.

Zgłoszenie #9 — Brak filtrowania po opiekunach

Status: 🟡 W naprawie (TASK-267).

Po przypisaniu skrzynek do opiekunów, pracownicy nadal widzą wszystkie wątki. Naprawa: filtr w widoku wątków po assigned_user_id + domyślne ustawienie filtra na zalogowanego użytkownika.

Zgłoszenie #10 — Załączniki do zgłoszeń

Status: 🟡 W naprawie (TASK-267).

Załączniki (zdjęcia produktów, dokumenty) z wiadomości platformowych nie są wyświetlane w wątku. Naprawa: pobieranie URL załącznika i jego renderowanie inline w widoku wątku.

Zgłoszenie #24 — Link do platformy źródłowej

Status: 🟠 Częściowe.

Wiadomość wyświetlana w panelu obecnie nie zawiera linku zwrotnego do platformy (np. „Otwórz w Allegro"). Częściowe rozwiązanie: dla każdej platformy istnieje już deep-link na poziomie danych (source_url w tabeli cs_issues). Brakuje jedynie wyświetlenia tego linku w UI wątku — element finałowego sprintu.

Drugi punkt zgłoszenia (oznaczanie wiadomości jako przeczytane na platformie po odpowiedzi z panelu) zależy od wsparcia API każdej platformy z osobna. Aktualnie wspierają to: Allegro (auto-mark on reply). Pozostałe platformy nie udostępniają tego endpointu publicznie.

Architektura modułu (techniczna)

Dla osób które chcą zrozumieć działanie:

• Pobieranie: windmill/f/cs/imap_fetcher.py (poczta) + per-platform fetchers w windmill/f/<mp>/...
• Klasyfikacja: windmill/f/cs/classify.py (Claude API)
• Dyspozytor scenariuszy: windmill/f/cs/dispatcher.flow/ — co minutę sprawdza nowe wydarzenia i uruchamia pasujące scenariusze
• Tabele Convex: cs_issues, cs_messages, cs_threads, cs_issue_events, cs_issue_runs, cs_dead_letters

Pełna dokumentacja techniczna: windmill/docs/support/architecture.md (rozwijana w ramach TASK-262.16).