Hem
/
Integrationer
/
SMS-integration till specialiserade system
/
SMS-integration för REDCap

Innehållsförteckning

Lägg till en rubrik för att börja generera innehållsförteckningen

SMS-integration för REDCap

Vad är REDCap

REDCap (Research Electronic Data Capture) är en säker webbapplikation som är utformad för att stödja datainsamling för forskningsstudier. Applikationen erbjuder både databasuppbyggnad och online-enkäter, vilket gör den idealisk för ett brett spektrum av datadrivna projekt.

REDCap är särskilt känt för sin flexibilitet när det gäller att hantera komplexa datainsamlingsstrategier och sin förmåga att anpassa sig till olika forskningsbehov. Systemet säkerställer också dataintegritet med omfattande verifieringskedjor och har hantering av användarrättigheter för att skydda känslig information.

REDCap har utvecklats vid Vanderbilt University och används globalt i mer än hundra länder, vilket understryker dess tillförlitlighet och effektivitet.

REDCap och SureSMS

Integrationen mellan REDCap och SureSMS sker via den tjänst vi kallar mail-to-sms i SureSMS. Det innebär att REDCap genererar e-postmeddelanden som SureSMS skickar ut som SMS till mottagarna i REDCap.

I REDCap kan SMS användas för att optimera kommunikationen genom funktionerna "Automated Survey Invitations" och "Alerts and Notifications". Detta gör det möjligt för användare att ställa in e-postmeddelanden som automatiskt konverteras till SMS-meddelanden, vilket förbättrar svarsfrekvensen och säkerställer information i rätt tid. Dessa funktioner gör det enkelt att hålla deltagarna uppdaterade och engagerade i forskningsprojekt.

Innan du sätter igång

Innan du sätter igång kan det vara bra att fundera över följande punkter:

Måste du kunna svara på SMS-meddelandet?

Det finns två sätt att skicka SMS-meddelanden. Det ena är med ett telefonnummer som avsändare och det andra är med en text som avsändare. Om du väljer att skicka med ett telefonnummer kan mottagaren svara på SMS-meddelandet. Om du väljer att skicka med en text kan mottagaren inte svara på meddelandet. Du har säkert provat att få ett SMS från SMS-Service, frisören eller liknande. Dessa går inte att svara på. Om du väljer att skicka med en text (vilket de flesta REDCap-användare gör) måste du välja ett avsändarnamn.

Vad ska avsändarnamnet vara?

Du måste välja ett avsändarnamn för dina SMS-meddelanden. Här begränsar det internationella SMS-protokollet dig till 11 tecken inklusive mellanslag, bindestreck, punkter etc. Försök att komma på ett namn som gör att mottagaren associerar det till ditt forskningsprojekt. Om du skickar länkar i dina meddelanden är det mer sannolikt att användarna klickar på länken om de tror att det faktiskt är en trovärdig källa som har skickat meddelandet.

Hur kommer du att betala för tjänsten?

Du har två alternativ för betalning:

Betalning via kreditkort

Genom att välja onlinebetalning med kreditkort sätter du in ett belopp på ditt SureSMS-konto. Varje gång du skickar drar vi av beloppet för SMS:et från ditt saldo. När ditt saldo når den varningsnivå som du har ställt in (standard är 10 DKK) får du ett e-postmeddelande. Du kan också slå på automatisk påfyllning. Du får automatiskt en faktura när du har betalat.

Betalning via faktura/EAN

Du kan också välja att betala med faktura. Varje månad skickar vi dig en faktura för den senaste månadens användning. Fakturan kan antingen skickas via EAN eller via e-post. Observera: för fakturor gäller ett minimibelopp på DKK 100,- per månad.

Hur mycket kostar det?

När du använder SureSMS kostar det en liten summa för varje SMS du skickar, från 0,28 DKK per SMS som skickas till danska nummer. Observera att ett SMS endast kan vara 160 tecken långt. (läs mer om priser här.)

Det finns ingen uppläggnings- eller löpande avgift. Det kostar dock minst 100 DKK per månad om du vill ta emot fakturor via EAN.

Om du vill ta emot SMS-svar måste du ha en tvåvägslösning . Abonnemangsavgiften är DKK 99,- per månad.

Så här ställer du in REDCap och SureSMS

Integrationen mellan REDCap och SureSMS kräver inställningar i båda systemen. Du måste börja med att ställa in SureSMS, sedan flytta till REDCap och ställa in de sista detaljerna.

Inställning i SureSMS

För att använda SureSMS från REDCap behöver du ett SureSMS-konto och en API-nyckel från SureSMS. Nedan går vi igenom de steg du behöver gå igenom för att ställa in SureSMS.

Skapa en API-nyckel

Logga in på ditt SureSMS-konto här https://app.suresms.com
Om du inte har något konto kan du skapa ett här Skapa SMS Gateway-konto
Välj API-nycklar i menyn
Klicka på Alternativ i det övre högra hörnet och välj "SureSMS API-nyckel" i menyn.
I namnet kan du skriva t.ex. REDCap
Klicka på Spara
Kopiera den nya API-nyckeln så att du har den för senare användning.

Ange avsändarnamn

Välj Inställningar -> Avsändarnamn i menyn
Klicka på "Alternativ" i det övre högra hörnet och klicka sedan på "Beställ ny alfanumerisk avsändare".
Fyll i fältet med önskat avsändarnamn och klicka på "Beställ"
Godkännande av avsändarnamn är manuellt och det kan ta upp till 24 timmar innan det godkänns (vanligtvis inom en timme)
När namnet har godkänts återvänder du till den här sidan och kryssar i kryssrutan "Är standard"

Skapa betalning

Ditt konto har 50 gratis SMS när det skapas. Alla meddelanden som skickas med ett testkonto avslutas med en mening som anger att det skickades från ett testkonto. För att sätta upp betalning klickar du på den stora röda knappen högst upp där det står "TESTKONTO". Följ sedan instruktionerna för att byta till ett produktionskonto.

Nu är du klar i SureSMS och kan gå vidare till REDCap.

Konfigurera REDCap

Vi har skapat en guide för att konfigurera REDCap i PDF-format. Den kan laddas ner Distribution av enkäter via sureSMS inom ramen för REDCap-riktlinjerna.

Testning av installationen

I samband med att du testar din installation kan flera saker gå fel.

REDCap skickar inte ett e-postmeddelande till SureSMS
SureSMS tar emot e-postmeddelandet men kan inte koppla det till ditt konto
SureSMS kan associera e-postmeddelandet med ditt konto men kan inte leverera SMS-meddelandet

REDCap skickar inte e-post till SureSMS

Du måste först kontrollera att REDCap har skickat meddelandet korrekt. Detta gör du genom att öppna fliken "Notifieringslogg" och titta på de skickade meddelandena:

Här måste du vara särskilt uppmärksam på om meddelandet alls har skickats, vem som är mottagare och om det finns något i texten. Särskilt mottagaren kan vara problematisk. Det viktiga är att det står telefonnummer.apikey.[dinapikey]@2sms.nu. Så länge det finns innehåll i meddelandet ska det skickas. Du kan alltid korrigera innehållet i efterhand.

SureSMS tar inte emot e-post

Om SureSMS tar emot ett e-postmeddelande men inte kan associera det med ett konto skickas det inte ut som ett SMS. Det här är det svåraste problemet att hitta. Det beror på att SMS-meddelandet inte läggs till i ditt SureSMS-konto - just för att vi inte kan hitta det. Vanligtvis beror detta på att mottagaren av e-postmeddelandet inte är korrekt konfigurerad.

Ta en ordentlig titt på fältet Recipient i Notification Log. Formatet ska vara ett plus, följt av landskoden och sedan telefonnumret. Sedan antingen APIKey eller ditt användarnamn och en punkt. Sedan din SureSMS-kod eller den API-nyckel du använder. E-postadressen ska sluta med @2sms.nu.

Kontrollera att det inte finns några semikolon, hakparenteser eller mjuka parenteser i mottagarens namn.

Prova att använda din vanliga mailklient för att skicka till ett mottagarnamn som du har kopierat från mottagarlistan. Om du lyckas beror det på att REDCap inte kan skicka mailet till oss. Du kan testa om ditt användarnamn och lösenord är korrekta genom att logga in på https://app.suresms.com.

SureSMS tar emot e-post men skickar inte SMS

Det sista steget i felsökningen är att se till att SureSMS tar emot e-postmeddelandet men inte skickar SMS-meddelandet. Du kan kontrollera detta genom att logga in på https://app.suresms.com och klicka på Meddelanden i menyn och sedan på Utkorg. I utkorgen kommer ditt SMS att visas, men det har en status som inte är "Levererat". Genom att föra muspekaren över statusen kan du se vad som gick fel.

Vanligtvis beror det på att landskoden är fel. Det kan vara så att numret har två landskoder - t.ex. +454512345678 eller att det inte finns någon landskod alls. Det kan också vara så att länken i meddelandet har "fångats upp" av vårt SPAM-filter.

Observera att SureSMS inte kommer att skicka samma meddelande till samma mottagare inom 10 minuter. I så fall kommer det att ha status SPAM. Du kan undvika detta genom att ändra lite i texten som du skickar.

Problem med linjeändringar

När REDCap skickar meddelandet skickas det i HTML. Detta är med många olika koder. SureSMS tar bort dessa koder och försöker skapa ett SMS i klartext. Framför allt kan REDCap göra radbrytningar på flera olika sätt och det kan orsaka problem. Om du inte kan få REDCap att göra en radbrytning kan du prova att skriva <br> där du vill ha en radbrytning. Om du vill ha två radbrytningar direkt efter varandra kan du använda koden <br2>.

Radbrytningar räknas som ett tecken i SMS:et, så räkna inte med de fyra eller fem tecknen i koden när du beräknar längden på ditt SMS.

När du har satt upp det och kontrollerat att SMS:et ser ut som det ska kan du logga in på https://app.suresms.com, hitta meddelandet och klicka på Info bredvid meddelandet. Här kan du se hur mycket det kostar och hur lång tid det tar.