xSale Caller to aplikacja mobilna (Android), która podczas połączenia pokazuje kontekst klienta: kto dzwoni oraz jego ostatnie zamówienia i statusy.
Cel aplikacji
xSale Caller to lekka aplikacja towarzysząca dla systemu xSale. Jej zadaniem jest szybkie podanie kontekstu klienta w momencie, gdy ktoś dzwoni: kto to jest, jakie ma ostatnie zamówienia i w jakich są statusach. Dzięki temu handlowiec nie musi szukać informacji w panelu www podczas rozmowy.
Najważniejsze założenia:
- szybki podgląd podczas połączenia (bez przejmowania dialera),
- minimalne uprawnienia i brak nagrywania rozmów,
- czytelny i krótki przekaz informacji.
Wymagania
- Android 10+ (minSdk 26).
- Dostęp do internetu.
- Konto xSale.
- Instalacja poza Google Play (plik APK) — użytkownik musi umieć zainstalować aplikację z pliku.
Dostępność aplikacji
- Na tym etapie aplikacja jest dostępna tylko na zaproszenia (testy).
- Instalacja odbywa się z pliku APK przekazanego przez administratora.
- Aktualna wersja aplikacji: 0.3.3.
- Docelowo aplikacja będzie dostępna w Google Play.
Instalacja
1) Pobierz plik APK od administratora.
2) Włącz instalację z nieznanych źródeł, jeśli system tego wymaga.
3) Zainstaluj aplikację i uruchom.
Pierwsze uruchomienie
1) Otwórz aplikację xSale Caller.
2) Przejdź do sekcji Logowanie i kliknij Zaloguj.
3) Zaloguj się przez Auth0 (okno przeglądarki).
4) Po powrocie do aplikacji zobaczysz status API: OK oraz dane konta.
5) Jeśli masz wiele organizacji, wybierz je z listy Organizacja (wyświetlany jest ShortName).
Uprawnienia
- W sekcji Uprawnienia kliknij Nadaj uprawnienia.
- Wymagane (runtime): odczyt stanu połączeń + powiadomienia (Android 13+).
- 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.
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.
- „Not found” po zalogowaniu: zaktualizuj aplikację do wersji 0.3.3 (poprawka callback URL 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.
