Webhooks: Leiten Sie eingehende SMS an Ihr System weiter

Mithilfe von Webhooks kann SureSMS eingehende SMS automatisch an ein anderes System weiterleiten. Das ist praktisch, wenn Antworten von Kunden gespeichert werden sollen oder eine Aktion ohne manuellen Aufwand ausgelöst werden soll.

1. Was ist ein Webhook?

Ein Webhook ist eine automatische Nachricht von einem System an ein anderes. Wenn ein Kunde auf Ihre SMS antwortet, leitet SureSMS die Nachricht automatisch an Ihr System weiter, ohne dass Sie sich anmelden und sie abrufen müssen.

Ablauf: Der Kunde sendet eine SMS → SureSMS empfängt sie → Ihr System wird benachrichtigt.

Du kannst Webhooks beispielsweise für folgende Zwecke nutzen:

• Antworten in einem CRM speichern
• einen Workflow in Zapier oder Make starten
• Anmeldungen für einen Wettbewerb erfassen
• einen Supportfall erstellen

2. Das musst du zuerst klären

1. Ein SureSMS-Konto mit einer Nummer, die SMS empfangen kann. Das kann Ihre eigene virtuelle Nummer, eine Hosted-SIM oder ein Passwort für eine Kurznummer sein, z. B. TAXA im Jahr 1414.
2. Eine Webadresse, also eine URL, die die Nachricht empfangen kann. Diese stammt in der Regel von dem System, an das Sie die Nachricht senden möchten, z. B. Zapier, Make, HubSpot oder Ihr CRM. Sie kann auch von Ihrem Entwickler stammen.
3. Die Adresse muss über das Internet erreichbar sein und sollte möglichst mit https://.

3. So richten Sie den Webhook ein

1. Melden Sie sich im SureSMS-Portal an und gehen Sie zu Integrationen → Webhooks.
2. Klicken Neuen Webhook erstellen.
3. Wählen Sie den Typ im Feld aus Beschreibung:
   • POST bei eingehenden SMS (empfohlen), wenn Sie die Daten im JSON-Format erhalten möchten. Das ist mit den meisten Systemen kompatibel.
   • GET für eingegangene Nachrichten (empfohlen), falls Ihr System Daten nur über die Webadresse selbst empfangen kann.
4. Geben Sie Ihre Webadresse in URI. Das Portal füllt ein Beispiel aus, das Sie durch Ihre eigene Adresse ersetzen müssen.
5. Wählen Sie aus Alle Ausgaben, ob der Webhook für alle Ihre Nummern gelten soll oder nur für eine bestimmte Nummer oder ein bestimmtes Passwort. Ein Passwort wird nur dann erkannt, wenn es das erste Wort in der SMS ist.
6. Wenn Sie „POST“ ausgewählt haben, müssen Sie Folgendes ausfüllen: POST-Wert. Das ist der JSON-Code, den SureSMS an deine URL sendet. Klicke auf die Schaltfläche Feld „Fusion“ einfügen zum Einfügen dynamischer Werte. Das Feld darf maximal 1000 Zeichen enthalten.
7. Klicken Gem.

4. Verknüpfungsfelder

Platzhalter werden beim Empfang einer SMS durch die entsprechenden Werte ersetzt. Hier sind die am häufigsten verwendeten:

Geflechtfeld	Inhalt
<%bodyjson%>	Der SMS-Text, bereit für JSON. Verwenden Sie diesen in JSON.
<%body%>	Der SMS-Text
<%fromphonenumber%>	Absendernummer
<%receivedbyphonenumber%>	Deine Nummer, an die die SMS gesendet wurde
<%countrycode%>	Ländercode des Absenders
<%receivedutcdatetime%>	Zeitpunkt des Eingangs (UTC)

Verwenden Sie das Dropdown-Menü im Portal, um die vollständige Liste anzuzeigen.

Beispiel: GET

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

Beispiel: POST

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

Wenn die Testwerte vom Absender stammen +4512345678, erhält +4587654321 und der Text SureSMS-Test, sieht das POST-Beispiel dann wie folgt aus:

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

5. So führst du den Test durch

a) Klicken Sie auf die Schaltfläche „Test“

Im Einstellungsfenster kannst du klicken Test, bevor Sie speichern. SureSMS sendet einen Testanruf mit den oben genannten Testwerten an Ihre Adresse. Sie erhalten eine Rückmeldung, ob der Vorgang erfolgreich war und welchen HTTP-Statuscode Ihr System zurückgegeben hat. Alle Werte aus der 200er-Reihe bedeuten, dass alles funktioniert.

b) Führe einen richtigen Test durch

Sende eine SMS von deinem eigenen Handy an diese Nummer. Denk an das Passwort, falls du eines verwendest. Öffne anschließend den Reiter Protokoll auf der Seite „Webhooks“ und klicken Sie auf Aktualisieren. Hier kannst du genau sehen, was gesendet wurde, wie dein System darauf reagiert hat und wann.

c) Hast du noch kein System parat?

Sie können einen kostenlosen Testdienst wie webhook.site. Damit erhalten Sie eine vorübergehende Adresse. Geben Sie die Adresse wie folgt ein: URI, sende eine Test-SMS und sieh dir die Nachricht live auf webhook.site an.

6. Falls es nicht funktioniert

• Der Test schlägt mit dem Fehler „400 Bad Request“ fehl: Verwendest du <%bodyjson%> in JSON? Ist das JSON mit korrekten Anführungszeichen und Kommas gültig?
• Der Test funktioniert, aber bei einer echten SMS passiert nichts: Ist das die richtige Nummer? Beginnt die SMS mit dem Passwort? Wurde der Webhook gelöscht?
• Zeitüberschreitung: Ihr System muss innerhalb weniger Sekunden antworten. Führen Sie rechenintensive Verarbeitungsschritte erst danach durch, nicht während SureSMS auf eine Antwort wartet.
• Ungültige Adresse: Die Adresse muss mit folgendem beginnen: http:// oder https://.
• Ihr System ist vorübergehend nicht erreichbar: SureSMS versucht es dreimal im Abstand von jeweils einer Minute.
• Firewall: Wenn Sie feste IP-Adressen zulassen möchten, können Sie diese bei SureSMS erfragen.

Der Webhook wird unmittelbar nach dem Empfang der SMS gesendet. Für Webhooks ist kein spezielles Abonnement erforderlich, Sie müssen jedoch über eine Möglichkeit zum Empfang von SMS verfügen.