Instrukcja krok po kroku: integracja LabJet i SMSAPI.

Przetestuj SMSAPI!

Załóż darmowe konto SMSAPI i przetestuj możliwości profesjonalnej bramki SMS, RCS i WhatsApp dla firm.

Załóż konto

LabJet jest systemem przeznaczonym do obsługi procesów laboratoriów, obejmującym między innymi zlecenia, kontrahentów, rozliczenia i panel kontrahenta.

Integracja LabJet z SMSAPI umożliwia wysyłanie wiadomości SMS bezpośrednio z systemu do zleceń, kontrahentów i rozliczeń. Możesz przygotować własne szablony, korzystać z danych zapisanych w LabJet oraz wysyłać wiadomości pojedynczo lub zbiorczo po przefiltrowaniu odpowiedniej grupy.

1. Pierwsze kroki w SMSAPI

Zacznij od przygotowania konta SMSAPI do wysyłek.

1.1. Stwórz i aktywuj konto SMSAPI

1. Zarejestruj siÄ™ w SMSAPI.
2. Zaloguj siÄ™ do panelu klienta.
3. Uzupełnij dane firmy i aktywuj konto.

1.2. Dodaj pole nadawcy SMS

1. Przejdź do zakładki Pole nadawcy.
2. Dodaj nowe pole nadawcy. 
3. Wprowadź nazwę laboratorium, firmy albo marki.
4. Zatwierdź oświadczenie i poczekaj na aktywację nazwy.

Aktywną nazwę nadawcy wybierzesz później podczas konfiguracji konkretnego oddziału w LabJet.

Więcej o nadpisach SMS

Branding SMS – jak ustawić nazwę nadawcy w miejsce numeru telefonu?

Czytaj artykuł

1.3. Doładuj konto

1. Przejdź do zakładki Płatności.
2. Wybierz kwotę i metodę płatności.
3. Doładuj konto, aby zapewnić środki do realizacji wysyłek.

1.4. Wygeneruj Token API OAuth

1. Przejdź do zakładki Tokeny API.
2. Utwórz nowy token. 
3. Nadaj mu nazwÄ™ np. LabJet. 
4. Przyznaj uprawnienie do obsługi wiadomości SMS.
5. Wygeneruj i skopiuj token.

Token będzie potrzebny podczas konfiguracji oddziału w LabJet.

Uwaga odnośnie do tokenów

Token traktuj jak hasło. Nigdy nie udostępniaj go osobom trzecim i nie umieszczaj w publicznych repozytoriach.

2. Konfiguracja SMSAPI w LabJet

Gdy masz wszystko gotowe w SMSAPI, możesz przejść do ustawień w LabJet.

2.1. Wybierz oddział

Konfiguracja SMS jest przypisywana do konkretnego oddziału.

1. Zaloguj siÄ™ do LabJet.
2. Przejdź do Ustawień. 
3. W kafelku Dane firmowe wybierz oddział, dla którego chcesz skonfigurować wiadomości SMS. 

2.2. Wprowadź Token API i nazwę nadawcy

W ustawieniach wybranego oddziału przejdź do zakładki SMS.

1. W polu Token API wklej token wygenerowany w panelu SMSAPI. 
2. Wybierz aktywną Nazwę nadawcy. 
3. W razie potrzeby zaznacz opcję automatycznego usuwania znaków specjalnych z wiadomości.
4. Zapisz ustawienia.

Jeżeli korzystasz z kilku oddziałów, możesz zastosować ten sam Token API dla każdego z nich. W takim przypadku oddziały korzystają ze wspólnego konta i salda SMSAPI. Jeżeli chcesz rozdzielić środki między oddziały, potrzebne będą osobne konta SMSAPI.

2.3. Skonfiguruj raporty doręczeń

W zakładce SMS LabJet generuje Adres callback (raporty SMS).

1. Skopiuj wyświetlony adres.
2. Zaloguj siÄ™ do panelu klienta SMSAPI.
3. Przejdź do Ustawienia API → Adresy Callback
4. W sekcji dotyczącej Raportów SMS wklej adres wygenerowany przez LabJet. 
5. Zapisz konfigurację i upewnij się, że callback jest aktywny.

SMSAPI wykorzystuje wskazany adres callback do przekazywania aktualizacji statusów wysyłanych wiadomości.

2.4. Utwórz szablon SMS

Po zakończeniu konfiguracji integracji wróć do Ustawień w LabJet i otwórz sekcję Szablony SMS.

Kliknij Dodaj szablon, a następnie:

1. Wprowadź wewnętrzną nazwę szablonu
2. Wybierz grupę, w której ma być dostępny
   • Zlecenia,
   • Kontrahenci,
   • Rozliczenia;
3. Zapisz szablon
4. Kliknij ikonę edycji, aby przygotować jego treść

2.5. Przygotuj treść wiadomości

W Edytorze szablonu SMS wpisz treść wiadomości.

W szablonach możesz wykorzystywać parametry automatycznie zastępowane danymi z systemu. Dla zleceń dostępne są między innymi:

• numer zlecenia;
• oddziaÅ‚;
• pacjent;
• numer karty pacjenta;
• kontrahent;
• osoba zlecajÄ…ca;
• pÅ‚atnik;
• forma odbioru i dostawy;
• data otrzymania i zakoÅ„czenia;
• etap przetwarzania;
• wartość zlecenia.

Możesz również wykorzystać dane firmy, takie jak nazwa, adres, telefon, e-mail czy link do panelu kontrahenta. Przykład:

Zlecenie nr {ONo} dla pacjenta {OPatientName} zostało wysłane. Pozdrawiamy.

2.6. Kontroluj długość wiadomości

Pojedyncza wiadomość może zawierać:

• do 160 znaków bez znaków specjalnych;
• do 70 znaków, jeżeli wykorzystany zostanie znak wymagajÄ…cy kodowania Unicode.

Rzeczywista długość wiadomości może się różnić po zastąpieniu skrótów (parametrów, zmiennych) właściwymi danymi.

Znaki specjalne w treści SMS

W ustawieniach SMS możesz zaznaczyć opcję Automatycznie usuwaj znaki specjalne z wiadomości. LabJet usunie je przed wysyłką, co pomaga ograniczyć liczbę znaków wykorzystywanych przez wiadomość.

2.7. Uzupełnij numery telefonów kontrahentów

Aby wiadomości trafiały do właściwych odbiorców, numery telefonów muszą być zapisane w odpowiednim formacie.

1. Przejdź do kartoteki kontrahenta i otwórz zakładkę Kontakt.
2. Wprowadź polski numer komórkowy wraz z kodem kraju, bez spacji na przykÅ‚ad 48694234200.

Możesz również przypisać osobne numery do osób zlecających.

W przypadku Zleceń możesz wybrać wiadomość kierowaną do:

• kontrahenta zlecajÄ…cego;
• pÅ‚atnika;
• osoby zlecajÄ…cej.

W sekcjach Kontrahenci i Rozliczenia wykorzystywany jest główny numer telefonu klienta.

2.8. Wyślij wiadomość

Po przygotowaniu szablonów możesz wysyłać SMS-y bezpośrednio z systemu.

Dostępne są dwa podstawowe sposoby:

• wysyÅ‚ka do pojedynczej pozycji z menu dostÄ™pnego pod trzema kropkami;
• wysyÅ‚ka zbiorcza po przefiltrowaniu wybranej grupy zleceÅ„, kontrahentów lub rozliczeÅ„.

2.9. Sprawdź stan konta SMSAPI

W Ustawieniach → Szczegóły licencji możesz sprawdzić aktualny stan konta przeznaczonego na powiadomienia SMS.

3. Funkcje SMS w LabJet

Powiadomienia zwiÄ…zane ze zleceniami

• informacja o przyjÄ™ciu lub wysÅ‚aniu zlecenia
• komunikaty kierowane do kontrahenta, pÅ‚atnika lub osoby zlecajÄ…cej
• wykorzystanie numeru zlecenia i danych pacjenta w treÅ›ci
• wiadomoÅ›ci dotyczÄ…ce kolejnych etapów obsÅ‚ugi zlecenia

Wiadomości do kontrahentów

• indywidualna wysyÅ‚ka bezpoÅ›rednio z kartoteki
• wykorzystanie głównego numeru telefonu klienta
• wiadomoÅ›ci informacyjne i organizacyjne
• zbiorcza wysyÅ‚ka do przefiltrowanej grupy kontrahentów

Powiadomienia dotyczące rozliczeń

• przypomnienia o pÅ‚atnoÅ›ci
• komunikaty zwiÄ…zane z fakturami
• wysyÅ‚ka do głównego numeru kontrahenta
• zbiorcze wiadomoÅ›ci do wybranej grupy klientów

Szablony i personalizacja wiadomości

• osobne szablony dla zleceÅ„, kontrahentów i rozliczeÅ„
• automatyczne uzupeÅ‚nianie treÅ›ci danymi z LabJet
• wykorzystanie danych zlecenia, klienta i firmy
• możliwość automatycznego usuwania znaków specjalnych

Wysyłki indywidualne i zbiorcze

• SMS do pojedynczego zlecenia lub kontrahenta
• wysyÅ‚ka do wybranej grupy po zastosowaniu filtrów
• korzystanie z wczeÅ›niej przygotowanych szablonów
• obsÅ‚uga różnych odbiorców w procesie realizacji zlecenia

Przetestuj SMSAPI!

Załóż darmowe konto SMSAPI i przetestuj możliwości profesjonalnej bramki SMS, RCS i WhatsApp dla firm.

Załóż konto