Integracja SMS dla REDCap

Co to jest REDCap

REDCap (Research Electronic Data Capture) to bezpieczna aplikacja internetowa zaprojektowana w celu wspierania gromadzenia danych w badaniach naukowych. Aplikacja oferuje zarówno tworzenie baz danych, jak i ankiety online, dzięki czemu idealnie nadaje się do szerokiej gamy projektów opartych na danych.

REDCap jest szczególnie ceniony za swoją elastyczność w obsłudze złożonych strategii gromadzenia danych i zdolność do dostosowywania się do różnych potrzeb badawczych. System zapewnia również integralność danych dzięki kompleksowym ścieżkom audytu i zarządzaniu prawami użytkowników w celu ochrony poufnych informacji.

REDCap, opracowany na Uniwersytecie Vanderbilt, jest używany na całym świecie w ponad stu krajach, co podkreśla jego niezawodność i skuteczność.

REDCap i SureSMS

Integracja między REDCap i SureSMS odbywa się za pośrednictwem usługi, którą nazywamy mail-to-sms w SureSMS. Oznacza to, że REDCap generuje wiadomości e-mail, które SureSMS wysyła jako wiadomości SMS do odbiorców w REDCap.

W REDCap wiadomości SMS mogą być wykorzystywane do optymalizacji komunikacji poprzez funkcje "Automatyczne zaproszenia do ankiet" oraz "Alerty i powiadomienia". Pozwala to użytkownikom na skonfigurowanie wiadomości e-mail, które automatycznie konwertują się na wiadomości SMS, poprawiając wskaźniki odpowiedzi i zapewniając terminowe informacje. Funkcje te ułatwiają informowanie uczestników na bieżąco i angażowanie ich w projekty badawcze.

Przed rozpoczęciem

Przed rozpoczęciem warto rozważyć następujące kwestie:

Czy musisz mieć możliwość odpowiadania na wiadomości SMS? Rozwiń

Istnieją dwa sposoby wysyłania wiadomości SMS. Jednym z nich jest podanie numeru telefonu jako nadawcy, a drugim podanie tekstu jako nadawcy. W przypadku wybrania numeru telefonu odbiorca może odpowiedzieć na wiadomość SMS. Jeśli wybierzesz wysyłanie za pomocą tekstu, odbiorca nie będzie mógł odpowiedzieć na wiadomość. Prawdopodobnie próbowałeś otrzymywać wiadomości SMS od SMS-Service, fryzjera lub podobnych. Nie można na nie odpowiedzieć. Jeśli zdecydujesz się wysłać wiadomość tekstową (co robi większość użytkowników REDCap), musisz wybrać nazwę nadawcy.

Jaka powinna być nazwa nadawcy? Rozwiń

Musisz wybrać nazwę nadawcy dla swoich wiadomości SMS. W tym przypadku międzynarodowy protokół SMS ogranicza się do 11 znaków, w tym spacji, myślników, kropek itp. Spróbuj wymyślić nazwę, która sprawi, że odbiorca skojarzy ją z Twoim projektem badawczym. Jeśli wysyłasz linki w swoich wiadomościach, użytkownicy są bardziej skłonni do kliknięcia w link, jeśli wierzą, że jest to rzeczywiście wiarygodne źródło, które wysłało wiadomość.

W jaki sposób będziesz płacić za usługę? Rozwiń

Dostępne są dwie opcje płatności:

Płatność kartą kredytową

Wybierając płatność online kartą kredytową, wpłacasz kwotę na swoje konto SureSMS. Za każdym razem, gdy wysyłasz wiadomość, odejmujemy kwotę SMS-a od salda. Gdy saldo osiągnie ustawiony poziom alarmowy (domyślnie 10 DKK), otrzymasz wiadomość e-mail. Możesz także włączyć automatyczne doładowanie. Po dokonaniu płatności automatycznie otrzymasz fakturę.

Płatność fakturą/EAN

Można również wybrać płatność na podstawie faktury. Co miesiąc wysyłamy fakturę za poprzedni miesiąc użytkowania. Faktura może zostać wysłana za pośrednictwem EAN lub pocztą elektroniczną. Uwaga: w przypadku faktur obowiązuje minimalna kwota 100,- DKK miesięcznie.

Ile to kosztuje?

Korzystanie z SureSMS wiąże się z niewielkimi kosztami za każdą wysłaną wiadomość SMS, począwszy od 0,28 DKK za SMS wysłany na duńskie numery. Należy pamiętać, że wiadomość SMS może mieć tylko 160 znaków. (czytaj więcej o cenach tutaj.)

Nie ma żadnych opłat instalacyjnych ani bieżących. Jeśli jednak chcesz otrzymywać faktury za pośrednictwem EAN, kosztuje to co najmniej 100 DKK miesięcznie.

Jeśli chcesz otrzymywać odpowiedzi SMS, musisz posiadać rozwiązanie dwukierunkowe . Opłata abonamentowa wynosi 99,- DKK miesięcznie.

Jak skonfigurować REDCap i SureSMS

Integracja między REDCap i SureSMS wymaga konfiguracji w obu systemach. Musisz zacząć od skonfigurowania SureSMS, a następnie przejść do REDCap i skonfigurować ostatnie elementy.

Konfiguracja w SureSMS

Aby korzystać z SureSMS od REDCap, potrzebujesz konta SureSMS i klucza API od SureSMS. Poniżej przedstawiamy kroki, które należy wykonać, aby skonfigurować SureSMS.

Tworzenie klucza API

 

1. 1. Zaloguj się do swojego konta SureSMS tutaj https://app.suresms.com
      Jeśli nie masz konta, możesz je utworzyć tutaj Utwórz konto bramki SMS

 

1. 1. Wybierz klucze API w menu

 

1. 1. Kliknij Opcje w prawym górnym rogu i wybierz "Klucz API SureSMS" z menu.

 

1. 1. W nazwie można wpisać np. REDCap

 

1. 1. Kliknij przycisk Zapisz

 

1. 1. Skopiuj nowy klucz API, aby mieć go do późniejszego wykorzystania.

 

 

Ustaw nazwę nadawcy

 

1. 1. Wybierz Ustawienia -> Nazwa nadawcy z menu

 

1. 1. W prawym górnym rogu kliknij "Opcje", a następnie "Zamów nowego nadawcę alfanumerycznego".

 

1. 1. Wypełnij pole żądaną nazwą nadawcy i kliknij "Zamów".

 

1. 1. Zatwierdzenie nazwy nadawcy jest ręczne i może potrwać do 24 godzin (zazwyczaj w ciągu godziny).

 

1. 1. Po zatwierdzeniu nazwy wróć do tej strony i zaznacz pole wyboru "Jest domyślna".

 

 

Utwórz płatność

Po utworzeniu konta użytkownik otrzymuje 50 bezpłatnych wiadomości SMS. Wszystkie wiadomości wysłane z konta testowego kończą się zdaniem informującym, że zostały wysłane z konta testowego. Aby skonfigurować płatność, kliknij duży czerwony przycisk u góry z napisem "KONTO TESTOWE". Następnie postępuj zgodnie z instrukcjami, aby przełączyć się na konto produkcyjne.

Teraz skończyłeś w SureSMS i możesz przejść do REDCap.

Konfiguracja REDCap

Stworzyliśmy przewodnik konfiguracji REDCap w formacie PDF. Można go pobrać Dystrybucja ankiet za pośrednictwem sureSMS zgodnie z wytycznymi REDCap.

Testowanie konfiguracji

W procesie testowania konfiguracji kilka rzeczy może pójść nie tak.

• REDCap nie wysyła wiadomości e-mail do SureSMS
• SureSMS odbiera wiadomość e-mail, ale nie może powiązać jej z kontem użytkownika.
• SureSMS może powiązać wiadomość e-mail z kontem, ale nie może dostarczyć wiadomości SMS

REDCap nie wysyła poczty do SureSMS

Najpierw należy sprawdzić, czy REDCap poprawnie wysłał wiadomość. W tym celu należy otworzyć zakładkę "Dziennik powiadomień" i przejrzeć wysłane wiadomości:

Tutaj należy zwrócić szczególną uwagę na to, czy wiadomość została w ogóle wysłana, kto jest odbiorcą i czy w tekście jest cokolwiek. Szczególnie odbiorca może być problematyczny. Ważną rzeczą jest to, że jest to numer telefonu.apikey.[dinapikey]@2sms.nu. Dopóki wiadomość zawiera treść, powinna zostać wysłana. Treść zawsze można później poprawić.

SureSMS nie odbiera poczty

Jeśli SureSMS otrzyma wiadomość e-mail, ale nie może powiązać jej z kontem, nie zostanie ona wysłana jako SMS. Jest to najtrudniejszy do znalezienia problem. Dzieje się tak, ponieważ wiadomość SMS nie jest dodawana do konta SureSMS - właśnie dlatego, że nie możemy jej znaleźć. Zazwyczaj dzieje się tak, ponieważ odbiorca wiadomości e-mail nie jest poprawnie skonfigurowany.

Przyjrzyj się polu Odbiorca w dzienniku powiadomień. Format powinien składać się z plusa, po którym następuje kod kraju, a następnie numer telefonu. Następnie APIKey lub nazwa użytkownika i kropka. Następnie kod SureSMS lub klucz API, którego używasz. Adres e-mail powinien kończyć się @2sms.nu.

Sprawdź, czy w nazwie odbiorcy nie ma średników, nawiasów kwadratowych lub miękkich.

Spróbuj użyć zwykłego klienta poczty, aby wysłać wiadomość do odbiorcy skopiowanego z listy odbiorców. Jeśli to się powiedzie, REDCap nie może wysłać wiadomości e-mail do nas. Możesz sprawdzić, czy Twoja nazwa użytkownika i hasło są poprawne, logując się na stronie https://app.suresms.com.

SureSMS odbiera pocztę, ale nie wysyła wiadomości SMS

Ostatnim krokiem w rozwiązywaniu problemów jest sprawdzenie, czy SureSMS odbiera wiadomości e-mail, ale nie wysyła wiadomości SMS. Można to sprawdzić logując się do https://app.suresms.com i kliknij Wiadomości w menu, a następnie Skrzynka nadawcza. W skrzynce nadawczej pojawi się wiadomość SMS, ale będzie ona miała status "Niedostarczona". Przesuwając kursor myszy nad statusem, można zobaczyć, co poszło nie tak.

Zazwyczaj dzieje się tak dlatego, że kod kraju jest nieprawidłowy. Może się zdarzyć, że numer ma dwa kody kraju - tj. +454512345678 lub że w ogóle nie ma kodu kraju. Może to być również spowodowane tym, że link w wiadomości został "złapany" przez nasz filtr SPAM.

Należy pamiętać, że SureSMS nie wyśle tej samej wiadomości do tego samego odbiorcy w ciągu 10 minut. W takim przypadku wiadomość będzie miała status SPAM. Można tego uniknąć, nieznacznie zmieniając wysyłany tekst.

Problemy ze zmianami linii

Gdy REDCap wysyła wiadomość, jest ona wysyłana w formacie HTML. Zawiera ona wiele różnych kodów. SureSMS usuwa te kody i próbuje utworzyć zwykłą wiadomość SMS. W szczególności REDCap może robić podziały wierszy na kilka sposobów, co może powodować problemy. Jeśli nie możesz zmusić REDCap do robienia podziałów linii, spróbuj wpisać <br> w miejscu, w którym ma nastąpić podział wiersza. Jeśli chcesz uzyskać dwa podziały wiersza bezpośrednio po sobie, spróbuj użyć kodu <br2>.

Przerwy między wierszami liczą się jako jeden znak w wiadomości SMS, więc nie licz czterech lub pięciu znaków kodu podczas obliczania długości wiadomości SMS.

Po skonfigurowaniu i sprawdzeniu, że wiadomość SMS wygląda tak, jak powinna, możesz zalogować się na stronie https://app.suresms.com, znaleźć wiadomość i kliknąć opcję Informacje obok wiadomości. Tutaj możesz sprawdzić, ile kosztuje i jak długo trwa.