In der Anwendung
- Öffnen Sie Einstellungen → Webhooks und klicken Sie auf Webhook erstellen.
- Geben Sie die Benachrichtigungs-URL an: eine aus dem Internet erreichbare
https://-Adresse (lokale oder private Adressen werden abgelehnt). Sie muss innerhalb von 10 Sekunden antworten. - Wählen Sie die zu empfangenden Ereignisse (vollständige Liste) und bestätigen Sie.
Das Signatur-Secret wird nur ein einziges Mal angezeigt. Kopieren Sie es sofort in einen Passwort-Manager: Damit prüfen Sie, dass Aufrufe wirklich von Mailpro stammen. Verloren? Nutzen Sie „Secret erneuern“.
Der Webhook ist etwa 10 Minuten nach der Erstellung aktiv, sobald sich unsere Server synchronisiert haben.
Testen
In der Liste: Weitere Aktionen → Test-Ping senden. Wählen Sie einen Ereignistyp; ein Beispieldatensatz wird sofort an Ihre URL gesendet. Zustellungsverlauf anzeigen listet jeden Versuch (Datum, HTTP-Status, Latenz, Versuchsnummer) und erlaubt, eine Zustellung erneut zu senden.
Per API
Dieselben Vorgänge stehen Ihren Integrationen zur Verfügung: POST /api/v3/Webhook (Erstellung, liefert das Secret einmalig), POST /api/v3/Webhook/{id}/test, GET /api/v3/Webhook/{id}/deliveries, POST /api/v3/Webhook/{id}/rotate-secret, DELETE /api/v3/Webhook/{id}. Details und Beispiele im Entwicklerportal.
Grenzen
- 20 Webhooks pro Konto, 50 Ereignisse pro Webhook.
- Ein deaktivierter Webhook (manuell oder nach 10 aufeinanderfolgenden Fehlern) wird mit einem Klick reaktiviert: Was passiert bei einem Fehler?
- Das Löschen entfernt auch den Zustellungsverlauf – endgültig.