Webhooks: videresend innkommende SMS-meldinger til systemet ditt

Med webhooks kan SureSMS automatisk videresende innkommende SMS-meldinger til et annet system. Dette er praktisk når svar fra kunder skal lagres eller utløse en handling uten manuell innsats.

1. Hva er en webhook?

En webhook er en automatisk melding fra ett system til et annet. Når en kunde svarer på SMS-en din, videresender SureSMS automatisk meldingen til systemet ditt, uten at du trenger å logge inn for å hente den.

Flyt: Kunden sender en SMS → SureSMS mottar den → systemet ditt får beskjed.

Du kan for eksempel bruke webhooks til å:

• lagre svar i et CRM-system
• starte en prosess i Zapier eller Make
• registrere påmeldinger til en konkurranse
• opprette en supportsak

2. Det må du få på plass først

1. En SureSMS-konto med et nummer som kan motta SMS. Det kan være ditt eget virtuelle nummer, et hosted SIM-kort eller en kode på et kortnummer, f.eks. TAXA i 1414.
2. En nettadresse, altså en URL, som kan motta meldingen. Den kommer vanligvis fra systemet du ønsker å sende til, for eksempel Zapier, Make, HubSpot eller deres CRM-system. Den kan også komme fra utvikleren deres.
3. Adressen må være tilgjengelig fra internett og helst begynne med https://.

3. Slik konfigurerer du webhooken

1. Logg inn på SureSMS-portalen og gå til Integrasjoner → Webhooks.
2. Klikk Opprett ny webhook.
3. Velg type i feltet Beskrivelse:
   • POST ved mottatte SMS-meldinger (anbefales), hvis du ønsker å motta data i JSON-format. Dette passer for de fleste systemer.
   • GET for mottatte meldinger (anbefales), hvis systemet ditt kun kan motta data i selve nettadressen.
4. Skriv inn nettadressen din i URI. Portalen fyller ut et eksempel som du må erstatte med din egen adresse.
5. Velg i Alle numre, om webhooken skal gjelde for alle numrene dine eller bare ett bestemt nummer eller passord. Et passord stemmer bare overens når det er det første ordet i SMS-en.
6. Hvis du har valgt POST, må du fylle ut POST-verdi. Dette er JSON-dataene som SureSMS sender til din URL. Bruk knappen Sett inn flettingsfelt for å legge inn dynamiske verdier. Feltet kan inneholde maksimalt 1000 tegn.
7. Klikk Edelsten.

4. Sammenslåtte felt

Felt med fylltekster erstattes med de riktige verdiene når en SMS mottas. Her er de mest brukte:

Flettefelt	Innhold
<%bodyjson%>	SMS-teksten, klar for JSON. Bruk denne i JSON.
<%body%>	SMS-teksten
<%fromphonenumber%>	Avsenderens nummer
<%receivedbyphonenumber%>	Nummeret ditt, som SMS-en ble sendt til
<%countrycode%>	Avsenderens landskode
<%receivedutcdatetime%>	Mottakstidspunkt (UTC)

Bruk rullegardinmenyen i portalen for å se hele listen.

Eksempel: GET

https://ditdomæne.dk/sms?fra=<%fromphonenumber%>&til=<%receivedbyphonenumber%>&tekst=<%body%>

Eksempel: POST

{
  "time": "",
  "sender": "",
  "receiver": "",
  "message": ""
}

Hvis testverdiene er avsender +4512345678, mottaker +4587654321 og teksten SureSMS-test, ser POST-eksemplet slik ut:

{
  "time": "2026-10-23T07:54:00Z",
  "sender": "+4512345678",
  "receiver": "+4587654321",
  "message": "SureSMS-test"
}

5. Slik tester du

a) Bruk «Test»-knappen

I konfigurasjonsvinduet kan du klikke Test, før du lagrer. SureSMS sender et testanrop til adressen din med testverdiene ovenfor. Du får beskjed om det lyktes, og hvilken HTTP-statuskode systemet ditt svarte med. Alle koder i 200-serien betyr at det fungerer.

b) Gjør en ordentlig test

Send en SMS fra din egen mobiltelefon til nummeret. Husk passordet, hvis du bruker et. Åpne deretter fanen Logg på Webhooks-siden og klikk Oppdater. Her kan du se nøyaktig hva som ble sendt, hva systemet ditt svarte, og når.

c) Har du ikke et system klart ennå?

Du kan bruke en gratis testtjeneste som webhook.site. Den gir deg en midlertidig adresse. Skriv inn adressen som URI, send en test-SMS, og se meldingen i sanntid på webhook.site.

6. Hvis det ikke fungerer

• Testen mislykkes med feilmeldingen «400 Bad Request»: Bruker du <%bodyjson%> i JSON? Er JSON-koden gyldig med riktige anførselstegn og kommaer?
• Testen fungerer, men det kommer ikke noe tilbake i en ekte SMS: Er dette riktig nummer? Begynner SMS-en med passordet? Er webhooken slettet?
• Tidsavbrudd: Systemet ditt skal svare i løpet av få sekunder. Utfør ressurskrevende prosesser etterpå, ikke mens SureSMS venter på svar.
• Ugyldig adresse: Adressen må begynne med http:// eller https://.
• Systemet ditt er midlertidig nede: SureSMS prøver tre ganger med ett minuts mellomrom.
• Brannmur: Hvis du ønsker å tillate faste IP-adresser, kan du få opplyst disse ved å kontakte SureSMS.

Webhooken sendes umiddelbart etter at SMS-meldingen er mottatt. Webhooker krever ikke noe spesielt abonnement, men du må ha mulighet til å motta SMS-meldinger på en eller annen måte.