SMS-Webhooks — wir rufen Sie an, nicht umgekehrt
Mit einem Webhook muss Ihre Software uns nicht ständig fragen, ob es etwas Neues gibt. Sobald eine SMS eingeht oder sich ein Zustellstatus ändert, machen wir sofort einen HTTP POST an eine Adresse, die Sie angeben. Immer über HTTPS, pro Kanal einstellbar — und wer keinen Server hat, lässt es einfach an eine Mailbox senden.
Zwei Arten von Webhooks
Sie werden oft verwechselt, sind aber unabhängig voneinander und werden separat eingerichtet: Der eine betrifft Nachrichten, die eingehen, der andere, was mit Nachrichten passiert, die Sie senden.
| Eingehende SMS | Zustellstatus (DLR) | |
|---|---|---|
| Wann | Jemand sendet eine Nachricht an Ihre Nummer oder Ihren Shortcode | Der Status einer von Ihnen gesendeten Nachricht ändert sich |
| Wo eingestellt | Pro Kanal, unter Channels & Webhooks in Ihrem Konto | Pro Nachricht, als Benachrichtigungs-URL im API-Aufruf |
| Payload | msgid timestamp sender message keyword | msgid status |
| Alternative ohne Server | Weiterleitung an eine E-Mail-Adresse | Status im Dashboard einsehen |
Was wir an Ihren Endpoint senden
Bei einer eingehenden Nachricht machen wir einen HTTP POST an Ihre Adresse mit den folgenden Feldern. Ihr Endpoint muss sie nur annehmen und verarbeiten.
| Feld | Bedeutung |
|---|---|
msgid | Eindeutige ID der Nachricht — verwenden Sie diese, um doppelte Verarbeitung zu vermeiden |
timestamp | Zeitpunkt, zu dem die Nachricht bei uns eingegangen ist |
sender | Die Mobilnummer des Absenders |
message | Der vollständige Text der Nachricht |
keyword | Der Kanal oder das Keyword, auf dem die Nachricht eingegangen ist |
Bei einem Zustellstatus ist die Payload kürzer: die Nachrichten-ID und der Statuscode. Die Bedeutung jedes Codes steht auf der Seite über Zustellberichte.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Einen Webhook in 4 Schritten einrichten
Endpoint vorbereiten
Sorgen Sie für eine öffentlich erreichbare HTTPS-Adresse mit gültigem Zertifikat, die einen HTTP POST annehmen kann.
Kanal wählen
Gehen Sie in Ihrem Konto zu Channels & Webhooks und wählen Sie den Kanal oder das Keyword, für den die Meldung gelten soll.
Adresse eingeben
Geben Sie die Adresse ohne Schema ein; wir senden immer über HTTPS. Weicht Ihr Port von 443 ab, geben Sie ihn mit an.
Testen
Senden Sie eine SMS an Ihre virtuelle Nummer oder Ihren Shortcode und prüfen Sie, ob Ihr Endpoint den POST empfängt.
Was Ihr Endpoint erfüllen muss
Kommt bei Ihrem Endpoint nichts an, prüfen Sie in dieser Reihenfolge: Ist die Adresse von außen erreichbar, ist das Zertifikat gültig, und lässt Ihre Firewall unseren Aufruf durch? Im Tracelog Ihres Kontos sehen Sie, was genau gesendet wurde.
Kein Server? Senden Sie es an eine Mailbox
Ein Webhook setzt voraus, dass Sie etwas haben, um ihn zu empfangen. Haben Sie das nicht, wählen Sie pro Kanal einfach Weiterleitung an eine E-Mail-Adresse: Jede eingehende Nachricht kommt dann als Mail an, bei Ihnen oder bei dem Kollegen, der sie bearbeiten soll.
Sie können die Meldung auch ganz abschalten und die Nachrichten nur in Ihrem Dashboard ansehen — in der Konversationsansicht stehen sie direkt neben dem, was Sie selbst gesendet haben.
