SMS-integrasjon for REDCap

Hva er REDCap?

REDCap (Research Electronic Data Capture) er en sikker webapplikasjon som er utviklet for å støtte datainnsamling i forskningsstudier. Programmet tilbyr både databasebygging og nettbaserte spørreundersøkelser, noe som gjør det ideelt for et bredt spekter av datadrevne prosjekter.

REDCap er spesielt anerkjent for sin fleksibilitet når det gjelder å håndtere komplekse datainnsamlingsstrategier og sin evne til å tilpasse seg ulike forskningsbehov. Systemet sikrer også dataintegritet med omfattende revisjonsspor og har styring av brukerrettigheter for å beskytte sensitiv informasjon.

REDCap er utviklet ved Vanderbilt University og brukes globalt i mer enn hundre land, noe som understreker dets pålitelighet og effektivitet.

REDCap og SureSMS

Integrasjonen mellom REDCap og SureSMS skjer via tjenesten vi kaller mail-to-sms i SureSMS. Det betyr at REDCap genererer e-poster som SureSMS sender ut som SMS-meldinger til mottakerne i REDCap.

I REDCap kan SMS brukes til å optimalisere kommunikasjonen gjennom funksjonene "Automatiserte invitasjoner til spørreundersøkelser" og "Varsler og notifikasjoner". Dette gjør det mulig for brukere å sette opp e-postmeldinger som automatisk konverteres til SMS-meldinger, noe som forbedrer svarprosenten og sikrer rettidig informasjon. Disse funksjonene gjør det enkelt å holde deltakerne oppdatert og engasjert i forskningsprosjekter.

Før du setter i gang

Før du går i gang, kan det være lurt å tenke over følgende punkter:

Har du behov for å kunne svare på SMS-meldingen? Utvid

Det finnes to måter å sende SMS-meldinger på. Den ene er med et telefonnummer som avsender, og den andre er med en tekst som avsender. Hvis du velger å sende med et telefonnummer, kan mottakeren svare på SMS-meldingen. Hvis du velger å sende med en tekst, kan ikke mottakeren svare på meldingen. Du har sikkert prøvd å få en SMS fra SMS-Service, frisøren eller lignende. Disse kan ikke besvares. Hvis du velger å sende med tekst (som de fleste REDCap-brukere gjør), må du velge et avsendernavn.

Hva skal avsendernavnet være? Utvid

Du må velge et avsendernavn for SMS-meldingene dine. Her begrenser den internasjonale SMS-protokollen deg til 11 tegn, inkludert mellomrom, bindestreker, punktum etc. Prøv å finne på et navn som får mottakeren til å assosiere det med forskningsprosjektet ditt. Hvis du sender lenker i meldingene dine, er det mer sannsynlig at brukerne klikker på lenken hvis de tror at det faktisk er en troverdig kilde som har sendt meldingen.

Hvordan vil du betale for tjenesten? Utvid

Du har to alternativer for betaling:

Betaling via kredittkort

Ved å velge nettbetaling med kredittkort setter du inn et beløp på SureSMS-kontoen din. Hver gang du sender, trekker vi beløpet for SMS-en fra saldoen din. Når saldoen din når det varslingsnivået du har satt opp (standard er 10 DKK), vil du motta en e-post. Du kan også slå på automatisk påfylling. Du vil automatisk motta en faktura når du har betalt.

Betaling med faktura/EAN

Du kan også velge å betale med faktura. Hver måned sender vi deg en faktura for den siste månedens forbruk. Fakturaen kan enten sendes via EAN eller e-post. Merk: For fakturaer er det et minimumsbeløp på DKK 100,- per måned.

Hvor mye koster det?

Når du bruker SureSMS, koster det et lite beløp for hver SMS du sender, fra 0,28 DKK per SMS som sendes til danske numre. Vær oppmerksom på at en SMS bare kan være 160 tegn lang. (les mer om priser her.)

Det er ingen oppstartsavgift eller løpende avgift. Det koster imidlertid minst 100 DKK per måned hvis du ønsker å motta fakturaer via EAN.

Hvis du ønsker å motta SMS-svar, må du ha en toveis løsning . Abonnementsavgiften er DKK 99,- per måned.

Slik konfigurerer du REDCap og SureSMS

Integrasjonen mellom REDCap og SureSMS krever oppsett i begge systemene. Du må starte med å sette opp SureSMS, og deretter gå til REDCap og sette opp de siste detaljene.

Oppsett i SureSMS

For å bruke SureSMS fra REDCap trenger du en SureSMS-konto, og du trenger en API-nøkkel fra SureSMS. Nedenfor går vi gjennom trinnene du må gå gjennom for å sette opp SureSMS.

Opprett en API-nøkkel

 

1. 1. Logg inn på SureSMS-kontoen din her https://app.suresms.com
      Hvis du ikke har en konto, kan du opprette en her Opprett SMS Gateway-konto

 

1. 1. Velg API-nøkler i menyen

 

1. 1. Klikk på Alternativer øverst i høyre hjørne, og velg "SureSMS API-nøkkel" fra menyen.

 

1. 1. I navnet kan du skrive f.eks. REDCap

 

1. 1. Klikk på Lagre

 

1. 1. Kopier den nye API-nøkkelen slik at du har den til senere bruk.

 

 

Angi avsendernavn

 

1. 1. Velg Innstillinger -> Avsendernavn fra menyen

 

1. 1. Klikk på "Alternativer" øverst i høyre hjørne, og klikk deretter på "Bestill ny alfanumerisk avsender".

 

1. 1. Fyll ut feltet med ønsket avsendernavn og klikk på "Bestill"

 

1. 1. Godkjenning av avsendernavn er manuell og kan ta opptil 24 timer å få godkjent (vanligvis innen en time)

 

1. 1. Når navnet er godkjent, går du tilbake til denne siden og merker av i avmerkingsboksen "Er standard"

 

 

Opprett betaling

Kontoen din har 50 gratis SMS-meldinger når den opprettes. Alle meldinger som sendes med en testkonto, avsluttes med en setning som sier at de er sendt fra en testkonto. For å sette opp betaling klikker du på den store røde knappen øverst der det står "TESTKONTO". Følg deretter instruksjonene for å bytte til en produksjonskonto.

Nå er du ferdig i SureSMS og kan gå videre til REDCap.

Sette opp REDCap

Vi har laget en veiledning for oppsett av REDCap i PDF-format. Den kan lastes ned Distribusjon av spørreundersøkelser via sureSMS innenfor REDCap-retningslinjene.

Testing av oppsettet

Når du tester oppsettet ditt, er det flere ting som kan gå galt.

• REDCap sender ikke e-post til SureSMS
• SureSMS mottar e-posten, men kan ikke knytte den til kontoen din
• SureSMS kan knytte e-posten til kontoen din, men kan ikke levere SMS-meldingen

REDCap sender ikke e-post til SureSMS

Du må først sjekke at REDCap har sendt meldingen korrekt. Dette gjør du ved å åpne fanen "Meldingslogg" og se på de sendte meldingene:

Her må du være spesielt oppmerksom på om meldingen i det hele tatt er sendt, hvem som er mottaker og om det står noe i teksten. Spesielt mottakeren kan være problematisk. Det viktige er at det står telefonnummer.apikey.[dinapikey]@2sms.nu. Så lenge det er innhold i meldingen, skal den sendes. Du kan alltid korrigere innholdet i etterkant.

SureSMS mottar ikke e-post

Hvis SureSMS mottar en e-post, men ikke kan knytte den til en konto, vil den ikke bli sendt ut som en SMS. Dette er det vanskeligste problemet å finne. Dette skyldes at SMS-meldingen ikke blir lagt til i SureSMS-kontoen din - nettopp fordi vi ikke finner den. Vanligvis skjer dette fordi mottakeren av e-posten ikke er riktig konfigurert.

Ta en god titt på mottakerfeltet i varslingsloggen. Formatet skal være et pluss, etterfulgt av landskoden og deretter telefonnummeret. Deretter enten APIKey eller brukernavnet ditt og et punktum. Deretter SureSMS-koden eller API-nøkkelen du bruker. E-postadressen skal slutte med @2sms.nu.

Kontroller at det ikke er semikolon, hakeparenteser eller myke parenteser i mottakernavnet.

Prøv å bruke din vanlige e-postklient til å sende til et mottakernavn du har kopiert fra mottakerlisten. Hvis du lykkes, er det fordi REDCap ikke kan sende e-posten til oss. Du kan teste om brukernavnet og passordet ditt er riktig ved å logge inn på https://app.suresms.com.

SureSMS mottar e-post, men sender ikke SMS

Det siste trinnet i feilsøkingen er å sjekke at SureSMS mottar e-posten, men ikke sender SMS-meldingen. Du kan sjekke dette ved å logge inn på https://app.suresms.com og klikk på Meldinger i menyen og deretter Utboks. I utboksen vises SMS-en din, men den har en status som ikke er "Levert". Ved å holde musepekeren over statusen kan du se hva som gikk galt.

Vanligvis er det fordi landskoden er feil. Det kan være at nummeret har to landskoder - f.eks. +454512345678 eller at det ikke finnes noen landskode i det hele tatt. Det kan også være at lenken i meldingen har blitt "fanget" av SPAM-filteret vårt.

Vær oppmerksom på at SureSMS ikke vil sende samme melding til samme mottaker innen 10 minutter. I så fall vil den få statusen SPAM. Du kan unngå dette ved å endre teksten du sender litt.

Problemer med linjeendringer

Når REDCap sender meldingen, sendes den i HTML. Dette er med mange forskjellige koder. SureSMS fjerner disse kodene og forsøker å lage en ren tekst-SMS. REDCap kan lage linjeskift på flere måter, og dette kan forårsake problemer. Hvis du ikke får REDCap til å lage et linjeskift, kan du prøve å skrive <br> der du vil ha et linjeskift. Hvis du vil ha to linjeskift rett etter hverandre, kan du prøve å bruke koden <br2>.

Linjeskift teller som ett tegn i SMS-en, så ikke regn med de fire eller fem tegnene i koden når du beregner lengden på SMS-en.

Når du har satt det opp og sjekket at SMS-meldingen ser ut som den skal, kan du logge deg inn på https://app.suresms.com, finne meldingen og klikke på Info ved siden av meldingen. Her kan du se hvor mye den koster og hvor lang den er.