Home
/
Integrationer
/
SMS integration til fagsystemer
/
SMS integration til REDCap

Indholdsfortegnelse

Tilføj en overskrift for at begynde at generere indholdsfortegnelsen

SMS integration til REDCap

Hvad er REDCap

REDCap (Research Electronic Data Capture) er en sikker webapplikation designet til at understøtte dataindsamling for forskningsstudier. Applikationen tilbyder både bygning af databaser og online undersøgelser, hvilket gør den ideel til en bred vifte af datadrevne projekter.

REDCap er særligt anerkendt for sin fleksibilitet i at håndtere komplekse dataindsamlingsstrategier og sin evne til at tilpasse sig forskellige forskningsbehov. Systemet sikrer også dataintegritet med omfattende audit trails og har brugerrettighedsstyring, der beskytter følsomme oplysninger.

REDCap er udviklet ved Vanderbilt University og bruges globalt i mere end hundrede lande, hvilket understreger dets pålidelighed og effektivitet.

REDCap og SureSMS

Integrationen mellem REDCap og SureSMS foregår via den service vi i SureSMS kalder mail-to-sms. Det betyder at REDCap genererer emails som SureSMS sender ud som SMS beskeder til de modtagere der er i REDCap.

I REDCap kan SMS bruges til at optimere kommunikationen gennem funktionerne "Automated Survey Invitations" og "Alerts and Notifications". Dette tillader brugerne at opsætte e-mails, der automatisk konverteres til SMS-beskeder, hvilket forbedrer responsraten og sikrer rettidig information. Disse funktioner gør det nemt at holde deltagere opdateret og engageret i forskningsprojekter.

Inden du går i gang

Du kan eventuelt gøre dig overvejelser om nedenstående punkter, inden du går igang:

Skal man kunne besvare SMS beskeden?

Der er to måder at sende SMS beskeder på. Den ene er med et telefonnummer som afsender og den anden er med en tekst som afsender. Vælger man at sende med et telefonnummer kan modtageren besvare SMS beskeden. Vælger man at sende med en tekst kan modtageren ikke besvare beskeden. Du har sikkert selv prøvet at få en SMS fra SMS-Service, Frisøren eller tilsvarende. Disse kan ikke besvares. Hvis du beslutter dig for at sende med en tekst (hvilket de fleste REDCap brugere gør), så skal du vælge et afsender-navn.

Hvad skal afsender-navn være?

Du skal vælge et afsender-navn på dine SMS beskeder. Her begrænser den internationale SMS protokol dig til 11 tegn inklusive mellemrum, bindestreger, punktum etc. Prøv at finde på et navn der gør, at modtageren forbinder det med dit forskningsprojekt. Hvis du sender links i dine beskeder er brugerne mere tilbøjelige til at klikke på linket, hvis de tror at det faktisk er en troværdig kilde der har sendt beskeden.

Hvordan vil du betale for servicen?

Du har to muligheder for betaling:

Betaling via kreditkort

Ved at vælge online betaling med kreditkort sætter du et beløb ind på din SureSMS konto. Hver gang du sender trækker vi beløbet for SMS'en fra din saldo. Når din saldo når det alarmeringsniveau der er sat op (standard er 10 DKK), får du en mail. Du kan også slå automatisk optankning til. Du modtager automatisk en faktura når du har betalt.

Betaling med faktura/EAN

Du kan også vælge at betale via faktura. Hver måned sender vi en faktura til dig, på sidste måneds forbrug. Den faktura kan enten sendes via EAN eller via mail. OBS: ved faktura er der et mindste beløb på 100,- DKK pr. måned.

Hvad koster det?

Når du bruger SureSMS koster det en lille smule for hver SMS du sender.Udgangspunktet er 0,28 DKK pr. SMS sendt til danske numre. Du skal være opmærksom på, at en SMS kun kan være 160 tegn. (læs mere om priser her.)

Der er ingen oprettelse eller løbende gebyr. Dog koster det mindst 100,- DKK pr. måned, hvis du ønsker at modtage faktura via EAN.

Ønsker du at modtage svar SMS kræver det, at du har en tovejs løsning . Der er et abonnement på den på 99,- DKK pr. måned.

Sådan sætter du REDCap og SureSMS op

Integrationen mellem REDCap og SureSMS kræver opsætning i begge systemer. Du skal starte med at sætte SureSMS op, hvorefter du går over i REDCap og sætter de sidste ting op.

Opsætning i SureSMS

For at kunne bruge SureSMS fra REDCap skal du have en SureSMS konto og du skal bruge en API nøgle fra SureSMS. Herunder gennemgår vi de trin du skal igennem for at sætte SureSMS op.

Opret en API nøgle

Login på din SureSMS konto her https://app.suresms.com
Har du ikke en konto kan du oprette den her Opret SMS Gateway konto
Vælg API nøgler i menuen
Klik på Valg i øverste højre hjørne og vælg "SureSMS API nøgle" i menuen.
I navn kan du skrive f.eks. REDCap
Klik på Gem
Kopier den nye API nøgle så du har den til senere brug.

Sæt afsender-navn

Vælg Indstillinger -> Afsendernavn i menuen
I øverste højre hjørne klikker du på "Valg" og herefter på "Bestil ny alfanumerisk afsender".
Udfyld feltet med det ønske afsender-navn og klik "Bestil"
Godkendelse af afsender-navn er manuelt og der kan gå op til 24 timer førend det bliver godkendt. (typisk dog indenfor en time)
Når navnet er godkendt, skal du tilbage til denne side og sætte flueben i fletet "Er default"

Opret betaling

Din konto har 50 gratis SMS beskeder når den bliver oprettet. Alle beskeder sendt med en test-konto slutter med en sætning om at den er sendt fra en test-konto. Når du skal sætte betaling op skal du klikke på den store røde knap toppen hvor der står "TEST KONTO". Herefter skal du følge vejledningen for at overgå til en produktionskonto.

Nu er du færdig i SureSMS og kan gå over i REDCap.

Opsætning af REDCap

Vi har lavet en vejledning til opsætning af REDCap i PDF. Den kan hentes Survey distribution through sureSMS within REDCap guideline.

Afprøvning af opsætning

I processen med at afprøve din opsætning kan flere ting gå galt.

REDCap sender ikke en mail til SureSMS
SureSMS modtager mailen men kan ikke knytte den til din konto
SureSMS kan knytte mailen til din konto, men kan ikke levere SMS beskeden

REDCap sender ikke mail til SureSMS

Du skal først tjekke, at REDCap har sendt beskeden korrekt. Det gør du ved at åbne "Notification log" fanen og kigge på de afsendte beskeder:

Her skal du være særlig opmærksom på om beskeden overhovedet er sendt og dernæst hvem er modtageren og står der noget i teksten. Særligt modtageren kan være problematisk. Det vigtige er at der står telefonnummer.apikey.[dinapikey]@2sms.nu. Hvis blot der er indhold i beskeden, så skulle den blive sendt. Du kan altid rette indholdet efterfølgende.

SureSMS modtager ikke mail

Hvis SureSMS modtager en mail, men ikke kan knytte den til en konto, så bliver den ikke sendt ud som SMS. Dette er det sværeste problem at finde. Det er det, fordi SMS beskeden ikke bliver lagt ind på din SureSMS konto - netop fordi vi ikke kan finde den. Typisk sker det, fordi modtageren af emailen ikke er sat korrekt op.

Kig grundigt på Recipient feltet i "Notification Log". Formatet skal være et plus, efterfulgt af landekode og så telefonnummeret. Herefter skal der enten stå APIKey eller dit brugernavn og et punktum. Derefter skal stå din SureSMS kode eller den APIkey du bruger. Mailadressen skal slutte med @2sms.nu.

Tjek at der ikke står semikolon, firkantparenteser eller bløde parenteser i modtagernavnet.

Prøv at anvende din almindelige mail-klient til at sende til et modtagernavn du har kopieret fra listen over modtagere. Hvis det lykkedes er det fordi REDCap ikke kan sende mailen til os. Du kan teste om dit brugernavn og kodeord er korrekt, ved at logge på https://app.suresms.com.

SureSMS modtager mail men sender ikke SMS

Sidste skridt i fejlfindingen er, at se at SureSMS modtager emailen, men ikke sender SMS beskeden. Det kan du tjekke ved at logge på https://app.suresms.com og klikke på Beskeder i menuen og herefter udbakken. I udbakken vil din SMS stå, men den vil have en status der ikke er "Leveret". Ved at flytte musen henover status kan du se hvad der gået galt.

Typisk er det, at landekoden er forkert. Det kan enten være at nummeret har fået to landekoder - altså +454512345678 eller at der slet ikke er nogen landekode på. Det kan også være, at linket i beskeden er blevet "fanget" af vores SPAM filter.

Du skal særligt være opmærksom på, at SureSMS ikke sender samme besked til samme modtager indenfor 10 minutter. Her vil den stå med status SPAM. Du kan undgå dette ved at ændre en smule i teksten du sender.

Problemer med linjeskift

Når REDCap sender beskeden, bliver den sendt i HTML. Det er med mange forskellige koder. SureSMS fjerner disse koder og prøver at danne en SMS i ren tekst. Specielt kan REDCap lave linjeskift på flere måder og det kan give problemer. Hvis du ikke kan få REDCap til at lave et linjeskift kan du prøve at skrive <br> dér hvor du gerne vil have et linjeskift. Hvis du vil have to linjeskift lige efter hinanden kan du prøve at bruge koden <br2>.

Linjeskift tæller som eet tegn i SMS'en, så du skal ikke regne de fire eller fem tegn som kode fylder med, når du skal beregne længden af din SMS.

Når du har sat det op og tjekket at SMS beskeden ser ud som den skal, kan du med fordel logge på https://app.suresms.com, finde beskeden og klikke på Info udfor beskeden. Her kan du se hvad den koster og hvor lang den er.