Ein Webhook ist eine Nachricht, die Ihre App erhält, sobald etwas passiert, anstatt selbst danach fragen zu müssen. „Gibt’s schon was Neues?" in einer Schleife. Wenn in Ihrem Simbase-Konto ein Ereignis eintritt, Simbase leitet dieses Ereignis an eine URL weiter Sie steuern dies in Echtzeit.

So binden Sie Simbase in den Rest Ihrer Systemlandschaft ein: Eine SMS geht auf einer SIM-Karte ein, und Ihr Slack-Kanal wird benachrichtigt. Ein Gerät ändert seine IMEI, und Ihr Ticket-System eröffnet einen Vorfall. Das monatliche Datenvolumen überschreitet einen Schwellenwert, und Ihr Nutzungs-Dashboard wird aktualisiert. All dies, ohne Code schreiben zu müssen, der unsere API abfragt.

Webhooks decken die Ereignisse ab, die auf der Seite von Simbase stattfinden: eingehende SMS, Änderungen der IMEI, Änderungen des SIM-Status und Nutzungslimits.

Sind Sie bereit für den Live-Betrieb? Registrieren Sie Ihren Webhook-Endpunkt im Dashboard, damit Simbase weiß, wohin Ereignisse übermittelt werden sollen.

Wie Simbase Webhooks nutzt

Wenn auf Ihrem Konto etwas passiert, sendet Simbase einen HTTPS-POST-Request an die von Ihnen angegebene URL, wobei der JSON-Body das Ereignis beschreibt. Ihre App liest den Body, verarbeitet ihn nach Ihren Vorgaben und antwortet mit einem 2xx-Statuscode, um den Empfang der Nachricht zu bestätigen.

Auf der Empfängerseite müssen Sie keine aufwendigen Lösungen einrichten. Die „von Ihnen angegebene URL“ kann eine der folgenden sein:

• Eine No-Code-Automatisierungsplattform wie Zapier oder Make.com

• Ein Team-Chat-Tool wie Slack oder Microsoft Teams, wobei die integrierten URLs für eingehende Webhooks genutzt werden (entweder direkt oder über Zapier oder Make.com)

• Eine Funktion in Ihrem eigenen Backend, in einer beliebigen Programmiersprache

• Ein externer SMS-Anbieter wie Twilio oder MessageBird, falls Sie SMS-Nachrichten an öffentliche Telefonnummern weiterleiten möchten

• Eine serverlose Funktion auf AWS Lambda, Vercel, Cloudflare Workers, Google Cloud Functions usw.

Wenn Sie uns eine HTTPS-URL mitteilen, können wir Ereignisse an diese URL übermitteln.

Webhook-Ereignisse

Simbase unterstützt die folgenden Ereignistypen:

• Empfangene SMS-Nachrichten

• Änderungen der IMEI-Nummer

• Änderung des SIM-Status

• Nutzungsgrenzen erreicht

Empfangene SMS-Nachrichten

Schwarze, rote und grüne SIM-Karten befinden sich in einem sogenannten geschlossenen SMS-Kreislauf. Einfach ausgedrückt: Die SIM-Karte kann SMS an unseren Server unter der Kurznummer +55555 senden und SMS von unserem Server empfangen, aber sie kann keine SMS mit anderen Telefonnummern weltweit austauschen. Dies ist beabsichtigt. Es handelt sich um eine Sicherheitsmaßnahme, die Ihre Geräteflotte vom öffentlichen SMS-Netzwerk abschirmt, sodass niemand Ihre Geräte per SMS erreichen kann, keine Betrugsversuche über Premium-Tarife Ihr Guthaben belasten können und SMS nicht als Angriffsfläche gegen Ihre Hardware genutzt werden können.

Blau, Gelb und Cyan SIM-Karten werden mit einer MSISDN ausgeliefert, sodass externe Nummern SMS an sie senden können. Die von diesen Geräten gesendeten Nachrichten verbleiben jedoch innerhalb von Simbase und werden niemals an ein externes Telefon zugestellt, sodass sich der Webhook bei jedem Profil gleich verhält. Siehe SMS für die Details pro Profil.

Wenn Ihr Gerät eine SMS an die Nummer +55555 sendet, passieren zwei Dinge:

1. Die Meldung wird im Simbase-Dashboard angezeigt.

2. Wenn Sie einen SMS-Webhook registriert haben, leitet Simbase die vollständige Nachricht über HTTPS an Ihren Endpunkt weiter.

Dieser zweite Schritt wird von den meisten Kunden unterschätzt. Die Nutzlast enthält den Nachrichtentext, die ICCID der SIM-Karte, den Gerätenamen und einen Zeitstempel. Sobald diese Daten bei Ihrem Endpunkt eintreffen, können Sie damit machen, was Sie wollen.

Einige konkrete Beispiele dafür, was Nutzer mit diesem Webhook entwickeln:

• Leiten Sie den SMS-Text an einen Slack- oder Microsoft Teams-Kanal weiter, damit das Team die Gerätemeldungen in Echtzeit sieht. Nützlich für Asset-Tracker, Verkaufsautomaten, Fernsensoren oder jedes andere Gerät, das per SMS meldet.

• Leiten Sie die Daten an Zapier oder Make.com weiter und lösen Sie alle von diesen Plattformen unterstützten Aktionen aus: Protokollierung in Google Sheets, Versenden einer E-Mail, Aktualisieren eines CRM-Systems, Erstellen eines Zendesk- oder Intercom-Tickets, Veröffentlichen in Notion usw. Ganz ohne Programmierkenntnisse.

• Leiten Sie die SMS über Twilio, MessageBird oder einen anderen SMS-Anbieter an eine externe Telefonnummer weiter. Ihr Gerät sendet eine SMS über Simbase, Ihr Webhook empfängt sie, Ihr Code leitet den Text an Twilio weiter, und Twilio übermittelt ihn an ein normales Mobiltelefon. Auf diese Weise bauen Kunden eine Einwegverbindung von einer abgeschotteten IoT-Flotte zu einer normalen Telefonnummer auf, ohne dabei auf die Sicherheit des geschlossenen Netzwerks verzichten zu müssen.

• Analysieren Sie den SMS-Text auf Sensorwerte oder Befehle und speichern Sie diese in Ihrer eigenen Datenbank oder einem Zeitreihenspeicher wie InfluxDB oder TimescaleDB.

• Lösen Sie eine Aktion auf der SIM-Karte aus. Ihr Endgerät empfängt die SMS, stellt fest, dass „sich dieses Gerät verdächtig verhält“, und ruft die Simbase-API auf, um die SIM-Karte zu deaktivieren.

Für Leser, die keinen Code schreiben: Kurz gesagt funktioniert der SMS-Webhook so, dass er „eine auf einer SIM-Karte eingegangene SMS“ in „eine Benachrichtigung in Slack“, „die Aktualisierung der Tabelle“, „eine E-Mail an das Team“ oder „die Eröffnung eines Tickets“ umwandelt. Sie müssen nicht lernen, wie SMS-Routing funktioniert. Sie müssen lediglich Simbase auf die richtige URL verweisen. Siehe SMS.

JSON-Webhook-Inhalt

{
  "event": "sms",
  "iccid": "8900000000001234567",
  "timestamp": "2026-08-06 12:00:00",
  "message": "test SMS message",
  "deviceName": "Demo device"
}

Änderung der IMEI-Nummer

Jedes Gerät verfügt über eine IMEI (International Mobile Equipment Identity), eine eindeutige 15-stellige Kennung, die fest in die Hardware integriert ist. Wenn Ihre SIM-Karte in ein anderes Gerät eingelegt wird, erkennt das Mobilfunknetz die neue IMEI und meldet diese. Simbase kann Ihren Endpunkt in dem Moment benachrichtigen, in dem dies geschieht.

Warum dies von Bedeutung ist, hängt von Ihrem Unternehmen ab. Bei der Bestandsverfolgung, in der Logistik oder im Flottenmanagement ist eine unerwartete Änderung der IMEI eines der deutlichsten Anzeichen dafür, dass eine SIM-Karte aus dem vorgesehenen Gerät entfernt wurde – sei es durch Diebstahl, Manipulation oder fehlgeschlagene Wartungsarbeiten. Für OEMs, die vorkonfigurierte Geräte ausliefern, sind IMEI-Änderungen der Weg, um sicherzustellen, dass jede SIM-Karte in dem Gerät gelandet ist, für das sie vorgesehen war.

Was Nutzer in der Regel mit diesem Webhook machen:

• Leite das Ereignis an Slack oder per E-Mail weiter, damit sich dein Betriebsteam darum kümmern kann.

• Eröffnen Sie automatisch ein Ticket in Ihrem Support-Tool, wenn die neue IMEI nicht mit einem erwarteten Gerät übereinstimmt.

• Deaktivieren Sie die SIM-Karte über die Simbase-API, falls Ihre Sicherheitsrichtlinie unerwartete IMEI-Änderungen als Betrugsindikator wertet.

• Erfassen Sie die Änderung in Ihrer Anlagen-Datenbank, damit Sie jederzeit wissen, welche SIM-Karte sich in welchem Gerät befindet, ohne dass ein manueller Abgleich erforderlich ist.

• Leiten Sie das Ereignis zur Einhaltung von Vorschriften und für forensische Untersuchungen an ein SIEM-System oder ein Audit-Protokoll weiter.

JSON-Webhook-Inhalt

{
  "event": "imei",
  "timestamp": "2026-08-06 12:00:00",
  "iccid": "8900000000001234567",
  "oldIMEI": "None",
  "newIMEI": "355234090012345",
  "action": "disabled",
  "deviceName": "Demo device"
}

Änderungen des SIM-Status

Eine SIM-Karte verfügt über einen Status, der angibt, ob sie derzeit aktiviert oder deaktiviert ist. Der Status kann sich aus verschiedenen Gründen ändern:

• Manuelle Aktivierung oder Deaktivierung über das Dashboard oder die API

• Automatische Aktivierung bei der ersten Nutzung der SIM-Karte

• Negativer Kontostand

• Vorfälle wie Diebstahl oder mutmaßlicher Betrug

• Unbefugte Änderungen der IMEI-Nummer

Wenn sich der Status ändert, übermittelt Simbase den neuen Status an Ihren Webhook, damit der Rest Ihrer Infrastruktur darauf reagieren kann. Siehe SIM-Status.

Was Kunden bei diesem Anlass in der Regel tun:

• Halten Sie eine interne CRM-, ERP- oder Anlagendatenbank stets auf dem aktuellen Stand des tatsächlichen Status jeder SIM-Karte, ohne die Simbase-API abzufragen.

• Erhalten Sie eine Benachrichtigung über Slack oder per E-Mail, sobald eine SIM-Karte deaktiviert wird, damit der Support davon erfährt, bevor der Kunde anruft.

• Starten Sie die Abrechnungsautomatisierung, sobald eine SIM-Karte zum ersten Mal aktiviert wird, indem Sie das Ereignis über Zapier oder Ihr eigenes Backend an Stripe, Chargebee oder einen benutzerdefinierten Abrechnungsdienst übermitteln.

• Erkennen Sie Überraschungen frühzeitig. Wenn eine SIM-Karte deaktiviert wurde und niemand in Ihrem Team damit gerechnet hat, behandeln Sie dies automatisch als Vorfall.

JSON-Webhook-Inhalt

{
  "event": "sim_state",
  "timestamp": "2026-08-06 12:00:00",
  "iccid": "8900000000001234567",
  "old_state": "enabled",
  "new_state": "disabled",
  "deviceName": "Demo device"
}

Nutzungsgrenzen erreicht

Sie können für jede SIM-Karte ein monatliches Daten- oder SMS-Limit festlegen. Sobald die Nutzung dieses Limits überschreitet, sperrt Simbase die SIM-Karte automatisch, und dieser Webhook informiert den Rest Ihres Systems sofort, sobald dies geschieht.

Die Überprüfung der Obergrenzen erfolgt erst, wenn die Nutzungsdaten vom Betreiber eingehen, und nicht in Echtzeit. Daher kann es vorkommen, dass eine SIM-Karte ihr Limit geringfügig überschreitet, bevor sie gesperrt wird. Siehe Nutzungsbeschränkungen warum es zu dieser Überschreitung kommt und wie man sie einkalkulieren kann.

Dies ist eine elegante Methode, um ein fehlerhaftes Gerät frühzeitig zu erkennen. Eine SIM-Karte, die normalerweise 10 MB pro Monat verbraucht und plötzlich ihr Datenlimit erreicht, will Ihnen in der Regel etwas mitteilen: einen Firmware-Fehler, einen fehlgeschlagenen WLAN-Fallback, ein Gerät, das im Debug-Modus belassen wurde, ein außer Kontrolle geratenes OTA-Update oder im schlimmsten Fall eine gestohlene SIM-Karte, die für Tethering genutzt wird.

Was Kunden bei dieser Veranstaltung üblicherweise tun:

• Sende eine Benachrichtigung an Slack oder per E-Mail, damit das Team weiß, dass eine SIM-Karte offline gegangen ist, noch bevor der Kunde anruft

• Eröffnen Sie bei Deployments mit hoher Priorität einen Vorfall in PagerDuty oder Opsgenie

• Überprüfen Sie das Gerät und aktivieren Sie anschließend die SIM-Karte erneut oder erhöhen Sie deren Limit über die Simbase-API.

• Löse einen Zapier- oder Make.com-Ablauf aus, der den Gerätebesitzer benachrichtigt

• Erfassen Sie das Ereignis in einem Dashboard für Nutzungsabweichungen, damit Sie im Zeitverlauf flottenweite Trends erkennen können

JSON-Webhook-Inhalt

{
  "event": "usage_limits",
  "timestamp": "2026-08-06 12:00:00",
  "iccid": "8900000000001234567",
  "usage_mb": 102,
  "threshold_mb": 100,
  "usage_sms": 0,
  "threshold_sms": null
}

Schritte zum Empfang von Webhooks

In wenigen Schritten können Sie in Ihrer App Benachrichtigungen zu Ereignissen erhalten:

1. Entscheiden Sie, welche Ereignisse Sie überwachen möchten und welche Felder in der Nutzlast für Sie tatsächlich von Interesse sind.

2. Erstellen Sie einen HTTP(S)-Endpunkt, um die Ereignisse zu empfangen. Dabei kann es sich um eine Route in Ihrem Backend, eine serverlose Funktion, eine Zapier-Webhook-URL, eine Make.com-Webhook-URL, einen eingehenden Slack-Webhook (mit einer kleinen Vorverarbeitung) oder eine beliebige andere URL handeln, die POST-Anfragen akzeptiert.

3. Analysieren Sie den JSON-Body auf Ihrer Seite und geben Sie einen 2xx-Statuscode zurück. Für Simbase ist nur der Statuscode von Bedeutung, nicht der Antworttext.

4. Testen Sie den Endpunkt mit einem Tool wie Postbote oder curl. Wenn Sie während der Entwicklung auf Ihrem Laptop echte Simbase-Ereignisse empfangen möchten, eignet sich ein Tunneling-Tool wie ngrok oder Cloudflare Tunnel gut.

5. Stellen Sie Ihren Endpunkt hinter einer öffentlich erreichbaren HTTPS-URL bereit.

6. Registrieren Sie diese URL in der Simbase-Dashboard unter „Integrationen“ → „Webhooks“.

7. Simbase sendet ein Testereignis an Ihre URL. Wenn Ihr Endpunkt mit einem 2xx-Code antwortet, wird der Webhook gespeichert und beginnt, Live-Ereignisse zu empfangen.

Technische Daten

Verfahren

Alle Aufrufe von Simbase an Ihren Webhook sind HTTP-POST-Anfragen mit einem JSON-Body.

Sicherheit

• Verwenden Sie IP-Filterung nicht als Sicherheitsmaßnahme. Unsere Server sind weltweit verteilt, und die öffentlichen IP-Adressen, von denen aus sie Daten versenden, ändern sich im Laufe der Zeit, sodass eine IP-Whitelist im ungünstigsten Moment versagen wird.

Häufig gestellte Fragen

Verwandte Themen

• SMS, welche Nachrichten der Webhook „received-SMS“ weiterleitet und wie sie sich je nach Profil unterscheiden

• Diebstahlschutz, eine SIM-Karte an eine bestimmte IMEI-Nummer binden, sodass ein Wechsel blockiert und nicht nur gemeldet wird

• SIM-Status, was „Aktiviert“ und „Deaktiviert“ bedeuten und wodurch sie sich ändern

• Nutzungsbeschränkungen, legen Sie das Limit fest, bei dessen Erreichen der Nutzungs-Webhook ausgelöst wird

• API, Webhooks programmgesteuert auflisten, erstellen und löschen