====== Informowanie pacjentów SMSem o dostępności wyniku badania ======

==== Cel funkcjonalności ====

Nowa funkcjonalność systemu LISPAT umożliwia informowanie pacjentów za pomocą wiadomości SMS o dostępności ich wyniku badania. Dzięki temu pacjent może szybko uzyskać informację o gotowości dokumentu do pobrania bez konieczności kontaktu telefonicznego lub osobistego.

==== Użycie funkcjonalności ====

=== 1. Ręczne wywołanie wysyłki SMS ===
Funkcję informowania można wywołać ręcznie:

  * Dla pojedynczego badania – klikając ikonę koperty "Badanie pacjenta jest gotowe do pobrania (SMS)" w oknie konkretnego badania.
  * Dla wielu badań – zaznaczając wybrane pozycje na liście badań i klikając tę samą ikonę oraz nazwę funkcji.

=== 2. Okno podglądu i logika działania ===

  * W przypadku pojedynczego badania – zawsze wyświetlane jest okno podglądu wiadomości przed jej wysłaniem.
  * W przypadku wielu badań – system zapyta, czy pokazać okna podglądu "dla pacjentów, którzy nie mają numeru telefonu":
    * Jeśli użytkownik wybierze „Nie” – SMS zostaną wysłane tylko do tych pacjentów, którzy mają wpisany numer telefonu.
    * Jeśli wybierze „Tak” – dla każdego takiego pacjenta pojawi się możliwość ręcznego uzupełnienia numeru przed wysyłką.

=== 3. Format numeru telefonu ===

Aby wiadomość została prawidłowo wysłana, numer telefonu pacjenta musi być zapisany w formacie:  
<kod kraju><numer telefonu> — bez znaków „+”, spacji, myślników.

Przykład poprawnego numeru: <code>48601222333</code> (dla Polski)

=== 4. Automatyczne uzupełnianie numeru ===
Po pomyślnym wysłaniu wiadomości, numer telefonu zostanie automatycznie zapisany w karcie pacjenta (jeśli wcześniej go tam nie było).

==== Konfiguracja ====

=== 1. Założenie konta w SMSAPI ===

LISPAT korzysta z serwisu https://www.smsapi.pl. Aby rozpocząć:

  * Załóż konto w serwisie SMSAPI.
  * Przedpłać dowolną liczbę punktów, odpowiadającą przewidywanej liczbie SMS-ów.
  * Skontaktuj się z Biurem Obsługi Klienta SMSAPI (telefonicznie) i poproś o "aktywację możliwości wysyłania wiadomości zawierających linki" – ta opcja jest domyślnie wyłączona.

=== 2. Konfiguracja nadawcy wiadomości ===

  * Przejdź do Panel główny > Dodaj pole nadawcy i zdefiniuj nazwę nadawcy (np. „Patomorfologia”).
  * Ustaw zdefiniowaną nazwę jako "domyślną nazwę nadawcy".

=== 3. Powiadomienia o niskim stanie konta ===

  * W 'Profil > Ustawienia > Powiadomienia" ustaw próg stanu konta, przy którym chcesz otrzymać e-mail z przypomnieniem o konieczności doładowania punktów.

=== 4. Generowanie Tokena API ===

  * Zaloguj się do konta SMSAPI.
  * Przejdź do Ustawienia API > Tokeny API (OAuth).
  * Utwórz nowy token i skopiuj go.

=== 5. Wprowadzenie tokena w LISPAT ===

W systemie LISPAT:

  * Przejdź do Administracja > Konfiguracja > Komunikacja > Integracje > SMS.
  * Kliknij Edytuj > Parametry.
  * Wklej token do pola Token.
  * Zapisz zmiany: Zapisz > Zapisz konfigurację.

=== 6. Edycja szablonu wiadomości ===

Aby zmienić treść SMS-a:

  * Przejdź do Administracja > Konfiguracja > Komunikacja > E-mail > Typ wiadomości.
  * Wybierz: SMS: Powiadomienie o możliwości pobrania wyniku > Pacjent.
  * Edytuj treść według własnych potrzeb (np. dodaj nazwę placówki, podpis, link do pobrania itp.).

==== Uwagi końcowe ====

  * Funkcjonalność SMS działa wyłącznie przy poprawnie wpisanym numerze telefonu.
  * Wysłane wiadomości są logowane w systemie.
  * Koszt każdej wiadomości zależy od cennika SMSAPI oraz długości treści wiadomości.