Webhooks: vidarebefordra inkommande SMS till ditt system

Med hjälp av webhooks kan SureSMS automatiskt vidarebefordra inkommande SMS till ett annat system. Det är praktiskt när svar från kunder ska sparas eller när en åtgärd ska initieras utan manuellt arbete.

1. Vad är en webhook?

En webhook är ett automatiskt meddelande från ett system till ett annat. När en kund svarar på ditt SMS vidarebefordrar SureSMS automatiskt meddelandet till ditt system, utan att du behöver logga in och hämta det.

Flöde: Kunden skickar ett SMS → SureSMS tar emot det → ditt system får ett meddelande.

Du kan till exempel använda webhooks för att:

• spara svar i ett CRM-system
• starta ett flöde i Zapier eller Make
• registrera anmälningar till en tävling
• skapa ett supportärende

2. Det här måste du ha klart först

1. Ett SureSMS-konto med ett nummer som kan ta emot SMS. Det kan vara ditt eget virtuella nummer, ett hosted SIM eller en kod på ett kortnummer, t.ex. TAXA år 1414.
2. En webbadress, det vill säga en URL, som kan ta emot meddelandet. Den kommer vanligtvis från det system som du vill skicka till, till exempel Zapier, Make, HubSpot eller ert CRM-system. Den kan också komma från er utvecklare.
3. Adressen måste vara tillgänglig via internet och helst börja med https://.

3. Så här konfigurerar du webhooken

1. Logga in på SureSMS-portalen och gå till Integrationer → Webhooks.
2. Klicka Skapa en ny webhook.
3. Välj typ i fältet Beskrivning:
   • POST vid mottagna SMS (rekommenderas), om du vill ta emot data i JSON-format. Det passar de flesta system.
   • GET för mottagna meddelanden (rekommenderas), om ditt system endast kan ta emot data som ingår i själva webbadressen.
4. Ange din webbadress i URI. Portalen fyller i ett exempel som du ska ersätta med din egen adress.
5. Välj i Alla nummer, om webhooken ska gälla alla dina nummer eller bara ett visst nummer eller lösenord. Ett lösenord matchar endast om det är det första ordet i SMS:et.
6. Om du har valt POST ska du fylla i POST-värde. Det är den JSON-data som SureSMS skickar till din URL. Använd knappen Infoga sammanfogningsfält för att ange dynamiska värden. Fältet får innehålla högst 1 000 tecken.
7. Klicka Gem.

4. Sammanfogningsfält

Fält med platshållare ersätts med de rätta värdena när ett SMS tas emot. Här är de vanligaste:

Flätat fält	Innehåll
<%bodyjson%>	SMS-texten, redo för JSON. Använd den här i JSON.
<%body%>	SMS-texten
<%fromphonenumber%>	Avsändarens nummer
<%receivedbyphonenumber%>	Det nummer som SMS:et skickades till
<%countrycode%>	Avsändarens landskod
<%receivedutcdatetime%>	Mottagningstidpunkt (UTC)

Använd rullgardinsmenyn i portalen för att se hela listan.

Exempel: GET

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

Exempel: POST

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

Om testvärdena kommer från avsändaren +4512345678, tar emot +4587654321 och texten SureSMS-test, ser POST-exemplet ut så här:

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

5. Så här testar du

a) Tryck på knappen ”Test”

I inställningsfönstret kan du klicka på Test, innan du sparar. SureSMS skickar ett testanrop till din adress med testvärdena ovan. Du får reda på om det lyckades och vilken HTTP-statuskod ditt system svarade med. Alla koder i 200-serien betyder att det fungerar.

b) Gör ett riktigt test

Skicka ett SMS från din egen mobil till numret. Kom ihåg lösenordet om du använder ett. Öppna sedan fliken Logga in på sidan ”Webhooks” och klicka Uppdatera. Här kan du se exakt vad som skickades, vad ditt system svarade och när.

c) Har du inte något system klart ännu?

Du kan använda en kostnadsfri testtjänst som webhook.site. Den ger dig en tillfällig adress. Ange adressen som URI, skicka ett test-SMS och se meddelandet i realtid på webhook.site.

6. Om det inte fungerar

• Testet misslyckas med felkod 400 Bad Request: Använder du <%bodyjson%> i JSON? Är JSON-koden giltig med korrekta citattecken och kommatecken?
• Testet fungerar, men det händer ingenting när man skickar ett riktigt SMS: Är det rätt nummer? Börjar SMS:et med lösenordet? Har webhooken raderats?
• Timeout: Ditt system ska svara inom några sekunder. Utför resurskrävande bearbetning efteråt, inte medan SureSMS väntar på svar.
• Ogiltig adress: Adressen ska börja med http:// eller https://.
• Ditt system är tillfälligt ur drift: SureSMS gör tre försök med en minuts mellanrum.
• Brandvägg: Om du vill tillåta fasta IP-adresser kan du få information om dessa genom att kontakta SureSMS.

Webhooken skickas omedelbart efter att SMS-meddelandet har mottagits. Webhooks kräver inget särskilt abonnemang, men du måste kunna ta emot SMS på något sätt.