SMS gateway API: Sådan sender du SMS direkte fra egne systemer

Af Stian Pedersen

Indholdsfortegnelse

Make SMS Gateway API

Med et SMS gateway API kan dit fagsystem, din webshop eller app sende og modtage SMS automatisk, uden at nogen trykker på "send". Her får du en praktisk gennemgang af, hvordan det fungerer, hvad du bør kræve af en leverandør, hvilke regler der gælder i Norge, og hvordan du kommer i gang med Make.

Hvad er et SMS gateway API?

En SMS-gateway er bindeleddet mellem din software og mobilnettene. Dit system sender en besked til gatewayen, som formaterer den korrekt og ruter den videre til modtagerens operatør. Svar fra modtageren går samme vej tilbage.

API-et er den grænseflade, dit system bruger til at kommunikere med gatewayen. Hos Make foregår det via almindelige webforespørgsler: Du sender en HTTP POST med JSON over HTTPS og modtager standard HTTP-statuskoder retur. Det fungerer derfor med det programmeringssprog og den platform, du allerede anvender.

Typiske anvendelsesområder

SMS er mest velegnet, når beskeden er kort, vigtig og tidskritisk:

  • Driftsmeddelelser og varsler: Strømafbrydelser, ændrede åbningstider og hændelser, der kræver handling.

  • Påmindelser: Mødeaftaler, tidsfrister og pakkeafhentning.

  • Ordre- og leveringsbekræftelser: Udløses automatisk af hændelser i webshop eller ERP.

  • Engangskoder (OTP/2FA): Login og verifikation af telefonnumre.

  • Tovejsdialog: Bekræftelser, aflysninger, tilmeldinger og afstemninger.

  • Markedsføring: Kampagner og tilbud, men kun til modtagere, der har givet samtykke (mere om dette nedenfor).

Dette bør et godt SMS API indeholde

Enkel integration og bulk

Du skal slippe for et stort integrationsprojekt. I Makes SMS Gateway API kan du sende flere beskeder i én forespørgsel, så bulk-SMS og enkeltbeskeder håndteres gennem samme grænseflade. API-et understøtter både tekst- og binære beskeder.

Pålidelige leveringsrapporter

At sende én SMS er enkelt. At vide, hvad der rent faktisk nåede frem, adskiller en hobbyløsning fra en professionel gateway. Med Make får du en leveringsrapport (DLR) for hver besked sendt til en URL, du vælger, med detaljerede statuskoder som leveret, undervejs, blokeret, ugyldigt nummer eller udløbet. Rapporterne gensendes automatisk, hvis dit modtagesystem ikke svarer. Du kan også angive en udløbstid på beskeder, så en engangskode ikke leveres, når den alligevel er udløbet.

Tovejs-SMS

Indgående SMS (MO, "mobile originated") sendes til din egen URL, så svarene lander direkte i dit system. Make understøtter afsendernavn eller -nummer, svarkodeord, kortnumre samt nationale og internationale numre. Til særlige behov understøttes også premium rate (reverse billing) og aldersgrænser.

Sikkerhed og oppetid

Al trafik er krypteret med HTTPS, og leveringsrapporterne kan beskyttes med Basic auth. Make har desuden to endpoints, så forsendelsen fortsætter, selv hvis det ene ikke svarer. Det anbefales at opbygge integrationen, så den automatisk skifter til reserve-endpointet.

Tegn, Unicode og SMS-dele: Det mange overser

En enkelt SMS rummer 160 tegn, når teksten anvender GSM 7-bit-alfabetet. Dette er standardtegnsættet for SMS. Indeholder beskeden tegn uden for dette alfabet, sendes den som Unicode, og grænsen falder til 70 tegn. Lange beskeder opdeles, og hver del har plads til henholdsvis 153 tegn (GSM-7) eller 67 tegn (Unicode), da der reserveres plads til at samle delene igen.

To ting er særligt relevante for afsendere:

  • Æ, ø og å indgår i GSM-7-alfabetet. Norske og danske tegn alene gør altså ikke beskeden dyrere.

  • Én enkelt emoji eller typografiske anførselstegn er nok til, at hele beskeden konverteres til Unicode. Euro-tegnet (€) og visse andre symboler tæller som to tegn.

Hos Make sendes beskeden automatisk som Unicode, når det er nødvendigt, så alt når frem. Lange beskeder opdeles automatisk. Ønsker du at spare SMS-dele, kan Make erstatte specialtegn med lignende standardtegn.

Afsendernavn: Brug virksomhedsnavnet

Med Make kan du bruge et afsendernavn på op til 11 tegn i stedet for et nummer. Et tekstbaseret afsendernavn kan ikke besvares. Skal modtagerne have mulighed for at svare, kræves et kodeord knyttet til et nummer eller et dedikeret nummer.

Hold dig til bogstaverne A–Z, tallene 0–9 og tegnene &, # og !. Undgå æ, ø, å og mellemrum, da ikke alle operatører understøtter disse i afsendernavne.

Tip: Beskyt dit afsendernavn mod svindel
Svindlere kan afsende SMS'er, der ser ud til at stamme fra kendte brands. Nkom og Økokrim anbefaler derfor virksomheder at registrere deres afsendernavn i SMS SenderID-registeret. Flere mobiloperatører tilbyder dette. Dit navn registreres på en hvidliste, så falske beskeder med samme navn blokeres.

Regler, du skal kende

Markedsføring kræver samtykke

Du må ikke sende markedsføring via SMS eller e-mail til privatpersoner uden forudgående samtykke. Dette følger af markedsføringslovens § 15. Samtykket skal være:

  • Frivilligt: Personen skal have et reelt valg. Du må ikke stille krav om samtykke for at gennemføre et køb.

  • Udtrykkeligt: Personen skal aktivt afkrydse et felt eller tilmelde sig. Et forudafkrydset felt er ikke gyldigt.

  • Informeret: Personen skal vide, hvem afsenderen er, hvilke typer beskeder det omfatter, og hvordan man afmelder sig.

To væsentlige detaljer:

  • Du må ikke sende en SMS for at anmode om samtykke. Denne henvendelse betragtes i sig selv som markedsføring.

  • Et samtykke til e-mail gælder ikke for SMS. Du skal indhente samtykke for hver kanal.

Undtagelse for eksisterende kunder: Har du et eksisterende kundeforhold, for eksempel et abonnement eller medlemskab, kan du sende tilbud på tilsvarende produkter uden forudgående samtykke. Kunden skal have haft mulighed for at frabede sig dette ved afgivelsen af nummeret, og hver henvendelse skal indeholde en enkel adgang til afmeldelse.

Servicemeddelelser er ikke reklame. Ordrebekræftelser, påmindelser om aftaler og leveringsbeskeder kan sendes uden samtykke. Tilføjer du et tilbud, betragtes beskeden som markedsføring.

Overtrædelser kan medføre påbud og tvangsbøder fra Forbrukertilsynet per ulovlige henvendelse. Læs mere i Forbrukertilsynets vejledning.

GDPR

Telefonnumre er personoplysninger. Når du anvender en leverandør til udsendelse af SMS, skal der foreligge en databehandleraftale. Make opbevarer alle personoplysninger på servere i Norge.

SMS som engangskode

SMS anvendes ofte til login og verificering, men det er ikke den mest sikre metode. Den amerikanske standardiseringsorganisation NIST betragter SMS-koder som en svagere løsning, der bør anvendes med omtanke. Sørg for kort levetid på koderne, og tilbyd stærkere alternativer, såsom en godkenderapp, når sikkerhedsbehovet er højt.

Sådan kommer du i gang med Makes SMS Gateway API

  1. Anmod om adgang. Send en e-mail til support@make.as, eller book en uforpligtende gennemgang via produktsiden.

  2. Få konto og loginoplysninger. Du modtager en Make SMS Gateway-konto med brugernavn og adgangskode.

  3. Vælg afsender. Vælg et afsendernavn på op til 11 tegn eller et nummer/kodeord, hvis modtagerne skal have mulighed for at svare.

  4. Opsæt modtagelse. Opret endpoints til leveringsrapporter (DLR) og indgående SMS (MO), og beskyt DLR-modtagelsen med Basic auth.

  5. Test og fejlhåndtering. Send testbeskeder, verificer HTTP-statuskoderne, og konfigurer automatisk fallback til reserve-endpointet.

  6. Gå i produktion. Sikr, at samtykker og reservationer er på plads for alt indhold, der har karakter af markedsføring.

Ofte stillede spørgsmål om SMS gateway API

Hvad er forskellen på en SMS-gateway og et SMS API? SMS-gatewayen er tjenesten, der leverer beskederne til mobilnettene. API-et er grænsefladen, dit system anvender til at sende og modtage beskeder gennem gatewayen.

Kan jeg sende bulk-SMS via API? Ja. Med Makes SMS Gateway API kan du sende flere beskeder i én og samme forespørgsel.

Hvordan ved jeg, om SMS'en nåede frem? Du modtager en leveringsrapport (DLR) for hver besked til din egen URL med statusangivelser som leveret, undervejs, blokeret, ugyldigt nummer eller udløbet.

Kan vi anvende virksomhedsnavnet som afsender? Ja, med et afsendernavn på op til 11 tegn. Skal modtagerne kunne svare, kræves et kodeord tilknyttet et nummer eller et dedikeret nummer.

Koster æ, ø, å og emojis ekstra? Æ, ø og å indgår i standardalfabetet og medfører ingen ekstra omkostninger. Emojis og visse specialtegn betyder, at beskeden sendes som Unicode, hvilket reducerer kapaciteten til 70 tegn per SMS mod normalt 160.

Skal jeg have samtykke for at sende SMS? Til markedsføring kræves der som udgangspunkt altid samtykke. Rene servicemeddelelser som ordrebekræftelser og påmindelser kræver ikke markedsføringssamtykke, men der skal fortsat foreligge et lovligt grundlag for behandlingen af personoplysningerne.

Klar til at integrere dine systemer med Make?

Læs mere om funktionerne, eller book en gennemgang af, hvordan API-et integreres i jeres setup.

Start med en 30-dages prøveperiode

Start med en 30-dages prøveperiode