Przejdź do treści

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ę.

Pełny przewodnik operacyjny

Ta strona jest jednolinijkowym statusem zgłoszeń. Pełen podręcznik modułu (wizualny edytor scenariuszy, source-setup per platforma, reference 18 typów węzłów, dwa gotowe szablony) — patrz Obsługa Klienta — przewodnik szczegółowy.

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ć.

Stan zgłoszeń

Zgłoszenie #5 — Brak widocznej odpowiedzi na email

Status: ✅ Naprawione (TASK-267 + TASK-316.03, Sprint 2026-W18).

Pobieracz IMAP teraz dociąga folder Wysłane obok skrzynki INBOX i scala je w jeden wątek. Lokalizacja Sent zweryfikowana dla polskich Gmaili ([Gmail]/Wysłane, nie [Gmail]/Sent Mail) i Mailcow (Wysłane / INBOX/Wysłane); dodatkowo wykrywanie folderu przez SPECIAL-USE \Sent tam gdzie serwer IMAP go raportuje. Wiadomości wychodzące mają w panelu znacznik „My" (niebieskie tło).

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

Status: ✅ Naprawione (TASK-267 + TASK-316.03).

Każda odpowiedź wysłana z panelu (Allegro / eBay / email) jest teraz dodatkowo wpisywana do wątku natychmiast po sukcesie API — nie znika już z widoku przez kilka minut do czasu powtórnego pull-a z platformy.

Zgłoszenie #9 — Brak filtrowania po opiekunach

Status: ✅ Naprawione (TASK-267 + TASK-316.04).

Filtr „Moje (Imię Nazwisko)" pojawia się w obsłudze klienta i domyślnie pokazuje tylko zgłoszenia przypisane do zalogowanego opiekuna. W tym samym sprincie naprawiono też auto-przypisywanie: pobieracz emaili przekazuje account_id do reguł (poprzednio gubione), więc reguły typu „skrzynka X → opiekun Y" działają na nowych zgłoszeniach. Stare zgłoszenia bez assignee_label można doczyścić z poziomu Reguł przydziału (jednorazowy backfill na żądanie właściciela).

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

Status: 🟠 Częściowe.

Zgłoszenie obejmowało dwie sprawy:

  • ✅ Wiadomości wysłane / odebrane widoczne w wątku — naprawione w ramach TASK-267 + TASK-316.03 (patrz #5/#6).
  • 🟡 Full inline rendering załączników (zdjęcia, PDF) — odroczone do bug-fix mode jako TASK-287. Aktualnie wątek pokazuje fakt obecności załącznika i nazwę pliku; pobranie wymaga otwarcia źródła w platformie / mailu.

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).