Webhooks: send indgående SMS’er videre til dit system

Med webhooks kan SureSMS automatisk sende indgående SMS’er videre til et andet system. Det er praktisk, når svar fra kunder skal gemmes eller starte en handling uden manuelt arbejde.

1. Hvad er en webhook?

En webhook er en automatisk besked fra ét system til et andet. Når en kunde svarer på din SMS, sender SureSMS automatisk beskeden videre til dit system, uden at du skal logge ind og hente den.

Flow: Kunden sender en SMS → SureSMS modtager den → dit system får besked.

Du kan for eksempel bruge webhooks til at:

• gemme svar i et CRM
• starte et flow i Zapier eller Make
• registrere tilmeldinger til en konkurrence
• oprette en supportsag

2. Det skal du have på plads først

1. En SureSMS-konto med et nummer, der kan modtage SMS. Det kan være dit eget virtuelle nummer, hosted SIM eller et kodeord på et kortnummer, fx TAXA på 1414.
2. En webadresse, altså en URL, der kan modtage beskeden. Den kommer typisk fra det system, du vil sende til, fx Zapier, Make, HubSpot eller jeres CRM. Den kan også komme fra jeres udvikler.
3. Adressen skal være tilgængelig fra internettet og helst starte med https://.

3. Sådan opsætter du webhooket

1. Log ind i SureSMS-portalen og gå til Integrationer → Webhooks.
2. Klik Opret ny webhook.
3. Vælg type i feltet Beskrivelse:
   • POST på indkomne SMS (anbefales), hvis du vil modtage data som JSON. Det passer til de fleste systemer.
   • GET på indkomne beskeder (anbefales), hvis dit system kun kan modtage data i selve webadressen.
4. Indsæt din webadresse i URI. Portalen udfylder et eksempel, som du skal erstatte med din egen adresse.
5. Vælg i Alle numre, om webhooket skal gælde alle dine numre eller kun ét bestemt nummer eller kodeord. Et kodeord matcher kun, når det er det første ord i SMS’en.
6. Hvis du har valgt POST, skal du udfylde POST-værdi. Det er den JSON, SureSMS sender til din URL. Brug knappen Indsæt flettefelt til at sætte dynamiske værdier ind. Feltet kan højst indeholde 1000 tegn.
7. Klik Gem.

4. Flettefelter

Flettefelter bliver udskiftet med de rigtige værdier, når en SMS modtages. Her er de mest brugte:

Flettefelt	Indhold
<%bodyjson%>	SMS-teksten, klar til JSON. Brug denne i JSON.
<%body%>	SMS-teksten
<%fromphonenumber%>	Afsenderens nummer
<%receivedbyphonenumber%>	Dit nummer, som SMS’en blev sendt til
<%countrycode%>	Afsenderens landekode
<%receivedutcdatetime%>	Tidspunkt for modtagelse (UTC)

Brug dropdownen i portalen for den fulde liste.

Eksempel: GET

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

Eksempel: POST

{
  "time": "<%receivedutcdatetime%>",
  "sender": "<%fromphonenumber%>",
  "receiver": "<%receivedbyphonenumber%>",
  "message": "<%bodyjson%>"
}

Hvis testværdierne er afsender +4512345678, modtager +4587654321 og teksten SureSMS test, ankommer POST-eksemplet sådan:

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

5. Sådan tester du

a) Brug Test-knappen

I opsætningsvinduet kan du klikke Test, før du gemmer. SureSMS sender et eksempelkald til din adresse med testværdierne ovenfor. Du får at vide, om det lykkedes, og hvilken HTTP-statuskode dit system svarede med. Alt i 200-serien betyder, at det virker.

b) Lav en rigtig test

Send en SMS fra din egen mobil til nummeret. Husk kodeordet, hvis du bruger et. Åbn derefter fanen Log på Webhooks-siden og klik Opdater. Her kan du se, præcis hvad der blev sendt, hvad dit system svarede, og hvornår.

c) Har du ikke et system klar endnu?

Du kan bruge en gratis testtjeneste som webhook.site. Den giver dig en midlertidig adresse. Indsæt adressen som URI, send en test-SMS, og se beskeden live på webhook.site.

6. Hvis det ikke virker

• Testen fejler med 400 Bad Request: Bruger du <%bodyjson%> i JSON? Er JSON’en gyldig med rigtige anførselstegn og kommaer?
• Testen virker, men der kommer intet ved en rigtig SMS: Er det det rigtige nummer? Starter SMS’en med kodeordet? Er webhooket slettet?
• Timeout: Dit system skal svare inden for få sekunder. Lav tung behandling bagefter, ikke mens SureSMS venter på svar.
• Ugyldig adresse: Adressen skal starte med http:// eller https://.
• Dit system er midlertidigt nede: SureSMS prøver 3 gange med 1 minuts mellemrum.
• Firewall: Hvis du skal tillade faste IP-adresser, kan de oplyses ved henvendelse til SureSMS.

Webhooket sendes straks efter, at SMS-beskeden er modtaget. Webhooks kræver ikke et særligt abonnement, men du skal have indgående SMS i en form.