xSale Caller (aplikacja mobilna)

xSale Caller to aplikacja mobilna (Android), która podczas połączenia pokazuje kontekst klienta: kto dzwoni oraz jego ostatnie zamówienia i statusy. aplikacja dodaje też pulpit dzienny oraz widget na pulpit.

Cel aplikacji

xSale Caller to lekka aplikacja towarzysząca dla systemu xSale. Jej zadaniem jest:

• podczas połączeń: szybkie pokazanie kontekstu klienta i jego zamówień,
• w ciągu dnia: pulpit dzienny z podglądem sprzedaży i statusów zamówień (dla właścicieli i managerów e-commerce).

Najważniejsze założenia:

• szybki podgląd podczas połączenia (bez przejmowania dialera),
• najlepiej działa przy aktywnym Wi‑Fi (na części telefonów transmisja danych LTE/5G bywa ograniczana podczas rozmowy),
• minimalne uprawnienia i brak nagrywania rozmów,
• czytelny i krótki przekaz informacji.

Wymagania

• Android 8+ (minSdk 26), rekomendowane Android 10+ (ograniczenia identyfikacji numerów).
• Dostęp do internetu. Rekomendowane Wi‑Fi podczas rozmów (część urządzeń ogranicza LTE/5G w trakcie połączeń).

Dostępność aplikacji

• Aplikacja jest dostępna w ramach otwartych testów w Google Play (bez zaproszeń).
• Do dołączenia do testów wymagane jest konto Google (adres e-mail używany w Google Play).
• Docelowo aplikacja będzie dostępna publicznie w Google Play.

Otwarty test w Google Play

Instalacja

1. Otwórz stronę testu w Google Play.
2. Upewnij się, że na telefonie jest zalogowane konto Google używane w Google Play.
3. Zainstaluj aplikację z Google Play.

Pierwsze uruchomienie

1. Otwórz aplikację xSale Caller.
2. Jeśli konfiguracja nie jest kompletna, aplikacja otworzy ekran Konfiguracja.
3. Przejdź do sekcji Logowanie i kliknij Zaloguj.
4. Zaloguj się przez Auth0 (okno przeglądarki).
5. Jeśli masz wiele organizacji, wybierz ją z listy Organizacja.
6. Zamknij konfigurację — zobaczysz Pulpit.

Uwaga: jeśli jesteś już zalogowany, masz wybraną organizację i masz wymagane uprawnienia, aplikacja otwiera od razu Pulpit.

Pulpit

• Na górze widzisz wybraną organizację i status API (zielona kropka = OK, czerwona = problem).
• Karty: Dzisiejsza sprzedaż oraz Do obsługi ręcznej.
• Pod kartami widzisz drzewko statusów zamówień (grupy → statusy → liczba).
• Przycisk odświeżenia (↻) odświeża dane oraz aktualizuje czas „ostatniego odświeżenia”.

Widget na pulpit

1. Dodaj widget xSale na ekran główny (pulpit telefonu).
2. Widget pokazuje: dzisiejszą sprzedaż, liczbę „Do obsługi ręcznej” oraz czas ostatniego odświeżenia.
3. Kliknięcie w widget otwiera aplikację.
4. Przycisk ↻ w prawym górnym rogu widgetu uruchamia odświeżenie danych.

Uwaga: odświeżanie w tle może działać co ok. 15 minut, ale bywa ograniczane przez oszczędzanie baterii producenta lub brak internetu.

Uprawnienia

• W sekcji Uprawnienia kliknij Nadaj uprawnienia.
• Wymagane (runtime): odczyt stanu połączeń (READ_PHONE_STATE) + powiadomienia (POST_NOTIFICATIONS, Android 13+).
• Dodatkowe (runtime): Kontakty (READ_CONTACTS) — jeśli chcesz widzieć nazwę osoby z książki telefonicznej w tytule powiadomień.
• Aplikacja nie wymaga dostępu do nagrywania ani blokowania połączeń.
• Dodatkowo (ustawienia systemowe): Dostęp do powiadomień telefonu — konieczny, żeby aplikacja mogła odczytać numer z powiadomienia o połączeniu na nowszych Androidach.

Identyfikacja numeru (Android 10+)

Na nowszych Androidach system często ukrywa numer w trakcie dzwonienia. Żeby aplikacja mogła pobrać numer i pokazać zamówienia w czasie połączenia:

1. Wejdź w sekcję Dostęp do powiadomień telefonu i kliknij Włącz dostęp do powiadomień.
2. Wróć do aplikacji i sprawdź, czy status jest Włączone.
3. Jeśli numer nadal się nie pojawia, sprawdź w ustawieniach telefonu, czy aplikacja nie jest ograniczana w tle (oszczędzanie energii / ograniczenia producenta).
4. (Opcjonalnie) Wejdź w Identyfikacja numeru (Android 10+) i kliknij Włącz identyfikację numeru (Call Screening) — na części urządzeń nie działa dla kontaktów.

Uwaga: tytuł powiadomienia pokazuje najpierw nazwę z kontaktów (jeśli dostępna), a gdy aplikacja pobierze dane z API — aktualizuje treść o podsumowanie zamówień. Jeśli nie ma internetu, zobaczysz stan „Czekam na internet…”.

Testy powiadomień

• Test powiadomienia na połączenie przychodzące — pokazuje full‑screen UI podczas połączenia.
• Test powiadomienia w trakcie połączenia — stała notyfikacja z akcją otwarcia kontekstu.
• Wyczyść powiadomienia — usuwa notyfikacje testowe.

Tryb demo (bez logowania)

• Jeśli nie jesteś zalogowany, testowe powiadomienia pokażą dane mockowane.
• Po zalogowaniu testy pobierają realne dane z API.

Najczęstsze problemy

• Brak powiadomień: sprawdź uprawnienia i czy aplikacja ma dostęp do powiadomień.
• Błąd API: sprawdź połączenie internetowe oraz czy użytkownik jest zalogowany.
• „Brak danych” na pulpicie: upewnij się, że wybrana jest organizacja i API ma status OK, następnie użyj odświeżenia (↻).
• „Nieznany numer” / brak numeru mimo że Telefon go pokazuje: upewnij się, że włączony jest Dostęp do powiadomień telefonu (ustawienie systemowe) i aplikacja nie ma ograniczeń w tle.
• „Czekam na internet…” podczas połączenia: telefon może chwilowo rozłączać transmisję danych w trakcie rozmowy (zwłaszcza bez Wi‑Fi). Aplikacja odświeży notyfikację, gdy internet wróci.
• Sesja wygasła / 401: aplikacja powinna automatycznie odświeżyć tokeny; jeśli błąd wraca, wyloguj i zaloguj się ponownie.
• „Not found” po zalogowaniu: zaktualizuj aplikację do najnowszej wersji (poprawki logowania dla nowszych Androidów).

Prywatność i bezpieczeństwo

• Aplikacja nie jest dialerem i nie przejmuje obsługi połączeń.
• Tokeny logowania są przechowywane bezpiecznie (EncryptedSharedPreferences / Keystore).
• Wyświetlane dane są ograniczone do kontekstu sprzedażowego i nie są zapisywane poza cache aplikacji.
• Szczegóły: Polityka prywatności.