SMS gateway API: Slik sender du SMS rett fra egne systemer
Av Stian Pedersen

Med et SMS gateway API kan fagsystemet, nettbutikken eller appen din sende og motta SMS automatisk, uten at noen trykker «send». Her får du en praktisk gjennomgang av hvordan det fungerer, hva du bør kreve av en leverandør, hvilke regler som gjelder i Norge, og hvordan du kommer i gang med Make.
Hva er et SMS gateway API?
En SMS-gateway er bindeleddet mellom programvaren din og mobilnettene. Systemet ditt sender en melding til gatewayen, som formaterer den riktig og ruter den videre til mottakerens operatør. Svar fra mottakeren går samme vei tilbake.
API-et er grensesnittet systemet ditt bruker for å snakke med gatewayen. Hos Make er det vanlige web-forespørsler: du sender en HTTP POST med JSON over HTTPS, og du får standard HTTP-statuskoder tilbake. Det fungerer derfor med det programmeringsspråket og den plattformen du allerede bruker.
Typiske bruksområder
SMS egner seg best når beskjeden er kort, viktig og tidskritisk:
Varsler og driftsmeldinger: strømbrudd, endrede åpningstider, hendelser som krever handling.
Påminnelser: timeavtaler, frister, henting av pakker.
Ordre- og leveringsbekreftelser: utløst automatisk av hendelser i nettbutikk eller ERP.
Engangskoder (OTP/2FA): innlogging og verifisering av telefonnummer.
Toveis dialog: bekreftelser, avbestillinger, påmeldinger og avstemninger.
Markedsføring: kampanjer og tilbud, men bare til mottakere som har samtykket (mer om det under).
Dette bør et godt SMS API ha
Enkel integrasjon og bulk
Du skal slippe et stort integrasjonsprosjekt. I Makes SMS Gateway API kan du sende flere meldinger i én forespørsel, så bulk-SMS og enkeltmeldinger går gjennom samme grensesnitt. API-et støtter både tekst- og binærmeldinger.
Leveringsrapporter du kan stole på
Å sende én SMS er enkelt. Å vite hva som faktisk kom frem er det som skiller en hobbyløsning fra en profesjonell gateway. Med Make får du en leveringsrapport (DLR) for hver melding til en URL du bestemmer, med detaljerte statuskoder som levert, på vei, sperret, ugyldig nummer eller utløpt. Rapportene sendes automatisk på nytt hvis mottaket ditt ikke svarer. Du kan også sette utløpstid på meldinger, slik at en engangskode ikke leveres når den uansett er ugyldig.
Toveis SMS
Innkommende SMS (MO, «mobile originated») sendes til din egen URL, slik at svar havner rett i systemet ditt. Make støtter avsendernavn eller nummer, kodeord for svar, kortnummer og nasjonale og internasjonale numre. For spesielle behov finnes også premium rate (reverse billing) og aldersgrense.
Sikkerhet og driftssikkerhet
All trafikk er kryptert med HTTPS, og leveringsrapportene kan beskyttes med Basic Auth. Make har i tillegg to endepunkter, så sendingen fortsetter selv om det ene ikke svarer. Bygg gjerne integrasjonen slik at den faller tilbake til reserve-endepunktet automatisk.
Tegn, Unicode og SMS-deler: det mange overser
En enkelt SMS rommer 160 tegn når teksten bruker GSM 7-bit-alfabetet. Dette er standardtegnsettet for SMS. Inneholder meldingen tegn utenfor alfabetet, sendes den som Unicode, og grensen faller til 70 tegn. Lange meldinger deles opp, og hver del har da plass til 153 tegn (GSM-7) eller 67 tegn (Unicode), fordi litt plass går med til å sette delene sammen igjen.
To ting er spesielt nyttige å vite for norske avsendere:
Æ, ø og å er med i GSM-7-alfabetet. Norsk tekst alene gjør altså ikke meldingen dyrere.
Én emoji eller «krøllete» anførselstegn er nok til at hele meldingen går over til Unicode. Euro-tegnet (€) og noen andre symboler teller som to tegn.
Hos Make sendes meldingen automatisk som Unicode når det trengs, så alt kommer frem. Lange meldinger splittes automatisk. Vil du spare SMS-deler, kan Make bytte ut spesialtegn med lignende standardtegn.
Avsendernavn: bruk firmanavnet
Med Make kan du bruke et avsendernavn på inntil 11 tegn i stedet for et nummer. Et tekstbasert avsendernavn kan ikke besvares. Skal mottakerne kunne svare, trenger du et kodeord koblet til et nummer eller et eget nummer.
Hold deg til bokstavene A–Z, tallene 0–9 og tegnene &, # og !. Unngå æ, ø, å og mellomrom, siden ikke alle operatører støtter dem.
Tips: Beskytt avsendernavnet ditt mot svindel
Svindlere kan sende SMS som ser ut til å komme fra kjente merkevarer. Nkom og Økokrim anbefaler derfor virksomheter å registrere avsendernavnet sitt i SMS SenderID-registeret. Flere mobiloperatører tilbyr dette. Navnet ditt havner på en hvitliste, og falske meldinger med det samme navnet blir stoppet.
Regler du må kjenne
Markedsføring krever samtykke
Du kan ikke sende reklame på SMS eller e-post til privatpersoner uten at de har sagt ja først. Det følger av markedsføringsloven § 15. Samtykket må være:
Frivillig: Personen har et reelt valg. Du kan ikke kreve samtykke for at noen skal få handle hos deg.
Uttrykkelig: Personen må aktivt krysse av eller melde seg på. En boks som allerede er krysset av, gjelder ikke.
Informert: Personen må vite hvem som sender, hva slags meldinger det gjelder og hvordan man melder seg av.
To ting mange ikke vet:
Du kan ikke sende en SMS for å spørre om samtykke. Den regnes selv som markedsføring.
Samtykke til e-post gjelder ikke for SMS. Du må be om samtykke for hver kanal.
Unntak for faste kunder: Har du et pågående kundeforhold, for eksempel et abonnement eller medlemskap, kan du sende tilbud på lignende produkter uten samtykke. Kunden må ha fått mulighet til å si nei da du fikk nummeret, og hver melding må ha en enkel måte å melde seg av på.
Servicemeldinger er ikke reklame. Ordrebekreftelser, timepåminnelser og leveringsvarsler kan du sende uten samtykke. Legger du inn et tilbud, blir meldingen reklame.
Brudd kan bli dyrt: Forbrukertilsynet kan gi forbud og tvangsmulkt per ulovlige melding. Les mer i Forbrukertilsynets veileder.
GDPR
Telefonnumre er personopplysninger. Når du bruker en leverandør til å sende SMS, må dere ha en databehandleravtale. Make lagrer alle personopplysninger på servere i Norge.
SMS som engangskode
SMS er mye brukt til innlogging og verifisering, men det er ikke den sikreste metoden. Den amerikanske standardiseringsorganisasjonen NIST regner SMS-koder som en svakere metode som bør brukes med forsiktighet. Gi kodene kort levetid, og tilby sterkere alternativer, som en autentiseringsapp, der sikkerhetsbehovet er høyt.
Slik kommer du i gang med Makes SMS Gateway API
Be om tilgang. Send en e-post til support@make.as eller book en uforpliktende gjennomgang via produktsiden.
Få konto og påloggingsdetaljer. Du trenger en Make SMS Gateway-konto med brukernavn og passord.
Velg avsender. Velg et avsendernavn på inntil 11 tegn, eller et nummer eller kodeord hvis mottakerne skal kunne svare.
Sett opp mottak. Lag endepunkter for leveringsrapporter (DLR) og innkommende SMS (MO), og beskytt DLR-mottaket med Basic Auth.
Test og håndter feil. Send testmeldinger, tolk HTTP-statuskodene og legg inn automatisk bruk av reserve-endepunktet.
Gå i produksjon. Sjekk at samtykker og reservasjoner er på plass for alt som kan regnes som markedsføring.
Ofte stilte spørsmål om SMS gateway API
Hva er forskjellen på en SMS-gateway og et SMS API? SMS-gatewayen er tjenesten som leverer meldingene til mobilnettene. API-et er grensesnittet systemet ditt bruker for å sende og motta meldinger gjennom gatewayen.
Kan jeg sende bulk-SMS via API? Ja. Med Makes SMS Gateway API kan du sende flere meldinger i én og samme forespørsel.
Hvordan vet jeg at SMS-en kom frem? Du får en leveringsrapport (DLR) for hver melding til din egen URL, med status som levert, på vei, sperret, ugyldig nummer eller utløpt.
Kan vi bruke firmanavnet som avsender? Ja, med et avsendernavn på inntil 11 tegn. Skal mottakerne kunne svare, trenger du et kodeord koblet til et nummer eller et eget nummer.
Koster æ, ø, å og emoji ekstra? Æ, ø og å er med i standardalfabetet og gir ingen ekstra kostnad. Emoji og enkelte spesialtegn gjør at meldingen sendes som Unicode, med 70 tegn per SMS i stedet for 160.
Trenger jeg samtykke for å sende SMS? For markedsføring, ja, som hovedregel. Rene servicemeldinger som ordrebekreftelser og påminnelser krever ikke markedsføringssamtykke, men du trenger fortsatt et lovlig grunnlag for å behandle personopplysningene.
Klar til å koble systemene dine til Make?
Les mer om funksjonene, eller book en gjennomgang av hvordan API-et passer inn hos dere.
