Integracja AI: SMSAPI
Podłączamy SMSAPI przez API bramki SMS: asystent dostaje dostęp do historii wysyłek, statusów doręczeń i szablonów wiadomości. Rejestratorka i kierownik przychodni widzą od razu, ile przypomnień nie dotarło, do których pacjentów warto wysłać ponowne powiadomienie i czy kampania SMS obniżyła liczbę nieobecności.
Jak się łączymy: Łączymy się z SMSAPI przez REST API bramki, korzystając z klucza API przypisanego do Waszego konta. Odczytujemy historię wysyłek, statusy doręczeń i szablony wiadomości.
Czego potrzebujemy: Klucz API do Waszego konta SMSAPI: konto z uprawnieniami do odczytu historii wysyłek i statusów doręczeń.
Czego asystent nie robi: Asystent nie wysyła SMS-ów do pacjentów bez zatwierdzenia przez upoważnionego pracownika placówki.
Co podłączamy
Historia wysyłek
CzytamyData, godzina, numer odbiorcy, treść wiadomości, status doręczenia (dostarczono, nie dostarczono, błąd)
AsystentPodaje liczbę nieskutecznych wysyłek w wybranym okresie, zestawia dni i typy wiadomości z najwyższym odsetkiem niedoręczeń i wskazuje numery wymagające weryfikacji w rejestracji.
Statusy doręczeń
CzytamyKody statusów zwracane przez operatorów GSM, znaczniki czasu doręczenia
AsystentOdpowiada, ile przypomnień faktycznie dotarło do pacjentów przed wizytą, i wskazuje numery, przy których ten sam błąd powtarza się kolejny raz.
Szablony wiadomości
CzytamyTreść szablonów, zmienne (data, godzina, lekarz, oddział), historia zmian
AsystentPorównuje szablony, wskazuje niespójności i przygotowuje projekty poprawek do zatwierdzenia przez kierownika lub koordynatora rejestracji.
Potwierdzenia i odwołania wizyt
CzytamyOdpowiedzi SMS od pacjentów (TAK, NIE, inne treści), powiązanie z terminem w grafiku
AsystentZestawia liczbę potwierdzeń i odwołań z danego okresu i pomaga ocenić, czy kampania przypomnień zmniejszyła odsetek nieobecności.
Listy pacjentów do wysyłki
CzytamyNumery telefonów i identyfikatory z systemu gabinetowego przekazane do SMSAPI w poprzednich kampaniach
AsystentPrzygotowuje projekt listy pacjentów do przypomnienia o szczepieniu lub badaniu kontrolnym, do zatwierdzenia przez upoważnionego pracownika przed wysyłką.
Raporty komunikacji
CzytamyZagregowane dane wysyłek: liczba SMS-ów, skuteczność doręczeń w podziale na dni i typy wiadomości
AsystentGeneruje zestawienia skuteczności kampanii komunikacyjnych na potrzeby kierownika lub działu jakości, bez ręcznego eksportu z konta SMSAPI.
O co pyta personel w praktyce
- Ile przypomnień o wizytach nie dotarło do pacjentów w tym tygodniu?
- Czy po wprowadzeniu przypomnień SMS zmalała liczba pacjentów, którzy nie przyszli na wizytę?
- Którym pacjentom powinienem wysłać przypomnienie o szczepieniu przeciw grypie?
- Jakie numery telefonów wymagają aktualizacji w systemie, bo SMS stale nie dochodzi?
- Który szablon wiadomości miał najlepszą skuteczność potwierdzeń w ostatnim miesiącu?
- Ile SMS-ów wysłano w tym miesiącu w podziale na typ: przypomnienie, e-recepta, e-skierowanie?
Co się zmienia
Rejestratorka i kierownik przychodni przestają ręcznie przeglądać raporty SMSAPI w poszukiwaniu nieskutecznych wysyłek. Asystent odpowiada na pytanie o skuteczność w kilka sekund, wskazuje numery telefonów wymagające aktualizacji w systemie gabinetowym i przygotowuje projekt listy pacjentów do kolejnej kampanii przypomnień lub szczepień. Kierownik może ocenić, czy liczba nieobecności spadła po uruchomieniu przypomnień SMS, bez ręcznego eksportowania danych i porównywania arkuszy. Każdą propozycję wysyłki zatwierdza upoważniony pracownik, więc kontrola nad komunikacją z pacjentem zostaje po Waszej stronie.
O programie
SMSAPI to bramka SMS, przez którą przychodnie i szpitale wysyłają pacjentom przypomnienia o wizytach, kody e-recept i e-skierowań oraz inne komunikaty. Program działa jako niezależna usługa, do której podłączają się systemy gabinetowe: np. moduł Komunikacja w Comarch Optimed NXT wysyła wiadomości przez konto SMSAPI placówki. Każda wysyłka trafia do historii z datą, statusem i treścią.
W koncie SMSAPI placówka zarządza szablonami wiadomości, monitoruje statusy doręczeń (dostarczono, nie dostarczono, błąd numeru) i widzi potwierdzenia lub odwołania wizyt, gdy pacjent odpowie na wiadomość. Interfejs API bramki pozwala na odczyt tych danych przez zewnętrzne systemy i narzędzia, w tym przez asystenta AI działającego na serwerze placówki.
Gdzie to działa najlepiej
Rejestratorka co poniedziałek sprawdza ręcznie w SMSAPI, ile przypomnień z poprzedniego tygodnia nie dotarło, i telefonicznie przypomina tym pacjentom o wizycie. Zajmuje jej to kilkadziesiąt minut.
Asystent podaje gotowe zestawienie nieskutecznych wysyłek w kilka sekund, rejestratorka weryfikuje numery i od razu przechodzi do kontaktu z pacjentami.
Kierownik chce sprawdzić, czy uruchomienie przypomnień SMS obniżyło liczbę nieobecności, ale dane o wysyłkach są w SMSAPI, a dane o nieobecnościach w Comarch Optimed NXT. Połączenie obu wymaga ręcznego eksportu i arkusza.
Asystent łączy dane z obu źródeł i przygotowuje zestawienie porównawcze do zatwierdzenia przez kierownika.
Pielęgniarka koordynująca szczepienia chce co kwartał wysyłać przypomnienia do pacjentów z listy, ale budowanie listy odbiorców zajmuje jej kilka godzin pracy z eksportami z systemu gabinetowego.
Asystent przygotowuje projekt listy na podstawie historii wizyt i poprzednich wysyłek, pielęgniarka zatwierdza i uruchamia kampanię.
Jak się łączymy
Łączymy się z SMSAPI przez REST API bramki, korzystając z klucza API przypisanego do Waszego konta. Odczytujemy historię wysyłek, statusy doręczeń i szablony wiadomości. Zapis nowych wysyłek przez API jest możliwy, ale asystent przygotowuje wyłącznie projekt wysyłki do zatwierdzenia przez upoważnionego pracownika: bez zatwierdzenia żadna wiadomość nie trafia do pacjenta.
Jeżeli korzystacie z Comarch Optimed NXT z modułem Komunikacja, dane o wysyłkach dostępne są również przez bazę danych tego systemu lub eksport z modułu raportowego. W takim przypadku konfigurujemy dostęp do API SMSAPI lub do bazy Comarch, zależnie od tego, które źródło daje pełniejszy obraz historii komunikacji dla Waszej placówki.
Portal z plikami, bazami i historią rozmów stoi na serwerze placówki. Do modelu AI trafia polecenie i fragmenty potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych pacjentów.
Czego potrzebujemy od Was
- Klucz API do Waszego konta SMSAPI: konto z uprawnieniami do odczytu historii wysyłek i statusów doręczeń.
- Zgoda administratora danych lub osoby upoważnionej po Waszej stronie na dostęp asystenta do historii wysyłek z konta SMSAPI.
- Jeżeli korzystacie z Comarch Optimed NXT: dostęp do bazy danych lub modułu eksportowego systemu na koncie technicznym z uprawnieniami tylko do odczytu.
- Określony zakres danych, które udostępniacie asystentowi (historia wysyłek zawiera numery telefonów pacjentów jako dane osobowe).
- Wasz serwer z uruchomionym portalem szpitalAI: stąd wychodzą zapytania do API SMSAPI i tu zostają pobrane dane.
Czego asystent nie robi
- Asystent nie wysyła SMS-ów do pacjentów bez zatwierdzenia przez upoważnionego pracownika placówki.
- Asystent nie zmienia szablonów wiadomości ani ustawień konta SMSAPI: przygotowuje projekty zmian do zatwierdzenia.
- Asystent nie ma dostępu do dokumentacji medycznej pacjenta przez SMSAPI: bramka SMS zawiera numery telefonów i historię wysyłek, nie dane kliniczne.
- Asystent nie podejmuje decyzji o tym, do których pacjentów wysłać wiadomość: przygotowuje projekt listy, a decyzję i wysyłkę zatwierdza lekarz lub upoważniony pracownik.
Pytania o integrację z SMSAPI
Czy asystent może samodzielnie wysyłać SMS-y do pacjentów?
Nie. Asystent przygotowuje projekt wysyłki: listę odbiorców, treść i szablon. Wysyłka uruchamia się dopiero po zatwierdzeniu przez upoważnionego pracownika placówki. Żadna wiadomość nie trafia do pacjenta bez decyzji człowieka. To dotyczy zarówno kampanii przypomnień, jak i pojedynczych wiadomości z kodami e-recept i e-skierowań.
Jak przetwarzane są dane z SMSAPI, skoro zawierają numery telefonów pacjentów?
Numery telefonów pacjentów to dane osobowe, a w kontekście historii wysyłek o wizytach i e-receptach mogą podlegać ochronie jako dane szczególnej kategorii (RODO art. 9). Portal szpitalAI działa na Waszym serwerze: dane zostają w Waszej infrastrukturze. Do modelu AI trafiają tylko fragmenty potrzebne do konkretnej odpowiedzi, bez trenowania modelu na Waszych danych. Zakres udostępnianych informacji ustalacie przy konfiguracji.
Czy potrzebna jest zgoda producenta SMSAPI na integrację z asystentem AI?
SMSAPI udostępnia publiczne REST API, z którego korzystają m.in. systemy gabinetowe i inne narzędzia. Integracja przez API nie wymaga osobnej zgody producenta, o ile dysponujecie ważnym kontem i kluczem API. Jeśli jednak SMSAPI jest uruchomione w ramach modułu Comarch Optimed NXT, warunki dostępu do danych mogą określać umowy z Comarch: warto to potwierdzić z działem IT lub dostawcą systemu.
Czy asystent potrafi wyjaśnić, dlaczego konkretny SMS nie dotarł do pacjenta?
Asystent odczytuje kod statusu doręczenia zwrócony przez operatora GSM, np. błędny numer, numer niedostępny, pełna skrzynka. Na tej podstawie wskazuje możliwą przyczynę i sugeruje działanie, np. prośbę do rejestratorki o weryfikację numeru w systemie gabinetowym. Szczegółowa diagnoza po stronie operatora GSM wymaga kontaktu z SMSAPI.
Czy integracja działa, jeśli przychodnia używa SMSAPI przez moduł Comarch Optimed NXT, a nie bezpośrednio?
Tak, z zastrzeżeniem. Jeśli Comarch Optimed NXT wysyła SMS-y przez konto SMSAPI placówki, historia wysyłek jest dostępna w API SMSAPI niezależnie od tego, który system je zlecił. Można też pobrać dane z bazy lub modułu raportowego Comarch. Konkretna ścieżka integracji zależy od Waszej konfiguracji i dostępnych uprawnień technicznych.
Inne integracje: rejestracja i kontakt z pacjentem
Sprawdźmy to na Waszej placówce
Na bezpłatnym audycie pokażemy, jakie dane da się wyciągnąć z SMSAPI i od którego procesu zacząć, żeby zespół szybko poczuł różnicę.
Umówcie bezpłatny audyt →