# Warum werden meine Webhooks für Zustellberichte nicht ausgelöst?

> Wenn die Zustellungsberichte (DLR) von BroadNet Ihren Server nicht erreichen, liegt die Ursache fast immer auf der Empfängerseite: Es ist keine Callback-URL im Konto konfiguriert, die URL ist nicht öffentlich über HTTPS erreichbar oder der Endpunkt liefert nicht umgehend HTTP 200. Die Plattform sendet einen JSON-DLR (MessageId, Status, BatchId usw.) per POST an Ihre URL, sobald eine Nachricht ihren endgültigen Status erreicht hat. Überprüfen Sie daher zuerst die URL, die Antwort und Ihre Firewall.

- Kanonische URL: https://www.broadnet.me/de/developers/troubleshooting-webhooks-not-firing
- Sprache: de
- Zuletzt aktualisiert: 2026-10-21
- Herausgeber: BroadNet (https://www.broadnet.me)

## Keine (oder falsche) Callback-URL konfiguriert

DLR-Webhooks werden nur ausgelöst, wenn in Ihrem Konto eine Callback-URL hinterlegt ist. Ist keine konfiguriert oder verweist die URL auf einen veralteten oder falschen Host, werden keine Benachrichtigungen zugestellt und es wird keine Fehlermeldung angezeigt. Überprüfen Sie die DLR-/Webhook-URL in Ihrem Konto. Falls Sie überhaupt keine Push-Benachrichtigungen empfangen, rufen Sie den Status bei Bedarf ab (über die Legacy-HTTP-API: GET /websmpp/websmsstatus mit der Antwort-ID).

- Für Webhooks muss eine Callback-URL im Konto festgelegt sein.
- Eine fehlende/veraltete URL bedeutet, dass die Zustellung stillschweigend nicht erfolgt.
- Überprüfen Sie, ob die konfigurierte DLR-URL aktuell ist.
- Fallback: Status bei Bedarf abrufen (Legacy-HTTP-API: /websmpp/websmsstatus).

## Endpunkt nicht öffentlich über HTTPS erreichbar

Die Plattform sendet POST-Anfragen aus dem öffentlichen Internet. Daher verhindern localhost, eine private IP-Adresse, ein nicht vertrauenswürdiges/selbstsigniertes TLS-Zertifikat oder eine IP-Whitelist, die unsere Absender ausschließt, das Erreichen des Callbacks. Stellen Sie einen öffentlichen HTTPS-Endpunkt mit einem gültigen Zertifikat bereit und erlauben Sie ausgehende Verbindungen von BroadNet, falls Sie eine Whitelist verwenden. Testen Sie die URL von außerhalb Ihres Netzwerks, bevor Sie die Plattform verantwortlich machen.

- Muss eine öffentliche HTTPS-URL mit einem gültigen Zertifikat sein.
- localhost, private IPs und selbstsignierte Zertifikate werden nicht empfangen.
- Setzen Sie die Absender von BroadNet auf die Zulassungsliste, wenn Sie den eingehenden Datenverkehr filtern.
- Testen Sie den Endpunkt von außerhalb Ihres Netzwerks mit curl, um die Erreichbarkeit zu bestätigen.

## Der Endpunkt gibt den Statuscode 200 nicht schnell genug zurück.

Ihr Endpunkt muss umgehend mit HTTP 200 bestätigen. Bei einer Antwort vom Typ 4xx/5xx, einem Timeout oder Blockierung während rechenintensiver Prozesse wird die Zustellung als fehlgeschlagen behandelt und mit exponentiellem Backoff wiederholt – was wie fehlende oder verzögerte Webhooks aussieht. Geben Sie sofort 200 zurück und verarbeiten Sie die DLR asynchron (reihen Sie sie in die Warteschlange ein und führen Sie die Verarbeitung anschließend durch).

- Schnelle Bestätigung mit HTTP 200.
- 5xx/4xx/Timeout → Wiederholungsversuche mit Backoff (sieht nach Paketverlusten aus).
- Reagiere schnell, bevor du mit der Arbeit beginnst.
- Gibt den Statuscode 200 zurück und verarbeitet anschließend die DLR-Anfrage über den Anfragepfad.

## Es handelt sich nicht um ein Webhook-Problem – die Nachricht ist noch nicht endgültig.

Ein DLR wird nur ausgelöst, wenn eine Nachricht ihren Endstatus (DELIVRD oder UNDELIV) erreicht. Befindet sich eine Nachricht noch in der Warteschlange oder ist sie geplant, ist noch kein Bericht fällig – dies ist zu erwarten und kein Fehler des Webhooks. Überprüfen Sie den tatsächlichen Status der Nachricht per Statusabruf (Legacy-HTTP-API: /websmpp/websmsstatus), bevor Sie davon ausgehen, dass der Webhook defekt ist, und gleichen Sie Berichte anhand der MessageId oder BatchId ab.

- DLRs feuern nur im Endzustand (DELIVRD / UNDELIV).
- Für in der Warteschlange befindliche oder geplante Nachrichten ist noch kein DLR vorhanden.
- Prüfen Sie den Ist-Zustand per Statusabruf (Legacy-HTTP-API: /websmpp/websmsstatus), bevor Sie mit dem Debuggen fortfahren.
- Match-Berichte basieren auf MessageId oder BatchId.

## Verwandte Seiten

- [SMS-API-Referenz – Zustellberichte](https://www.broadnet.me/de/developers/api)
- [Webhook-Einrichtung](https://www.broadnet.me/de/developers/webhooks)
- [Was ist ein DLR?](https://www.broadnet.me/de/answers/what-is-dlr)