Neu: Webhooks wurden aktualisiert
Webhooks bieten jetzt eine bessere Konfiguration, Zustellprotokolle, Ereignis-Replay und Signaturprüfung. Wenn Sie Webhooks vor dem 31. August 2026 konfiguriert haben, funktionieren Ihre Endpunkte weiterhin, Sie müssen sie jedoch vor dem 15. Januar 2027 migrieren. Sie können den Migrationsschritten folgen.
Mit Webhooks erhalten Sie Echtzeit-Updates zu Ihren gesendeten und empfangenen fax direkt von Fax.Plus. Durch die Konfiguration von Webhooks können Sie die Überwachung Ihrer fax-Übertragungen automatisieren und Statusaktualisierungen in Ihre bestehenden Systeme integrieren.
Webhook-Konfiguration
- Öffnen Sie den Bereich „Webhooks“:
- Melden Sie sich bei Ihrem Fax.Plus-Konto an.
- Navigieren Sie unter Einstellungen zum Bereich „Integrationen“.
- Suchen Sie Webhooks und klicken Sie auf Verwalten.
- Endpunkt hinzufügen:
- Klicken Sie auf Endpunkt hinzufügen und geben Sie die absolute URL auf Ihrem Server ein, die die Ereignisse empfangen soll.
- Wählen Sie aus, welche Ereignisse Sie erhalten möchten. Abonnieren Sie alle Ereignisse oder wählen Sie nur die benötigten aus
dem Ereigniskatalog aus. -
Optional: Nach fax-Nummer filtern. Ordnen Sie eine oder mehrere Ihrer fax-Nummern zu, um nur Ereignisse für
diese Nummern zu erhalten.
-
Statusaktualisierungen erhalten
- Nach der Konfiguration sendet Fax.Plus einen Webhook an Ihre angegebene URL, sobald sich der Status eines fax
ändert. - Die Webhook-Payload enthält wichtige Angaben wie fax-ID, Status, Zeitstempel und
Empfängerinformationen.
Hinweis: Wenn hook.id nicht gleich data.id ist, wird das fax erneut gesendet. Wenn hook.id gleich data.id ist, wird das fax zum ersten Mal gesendet.
- Nach der Konfiguration sendet Fax.Plus einen Webhook an Ihre angegebene URL, sobald sich der Status eines fax
- Signatur überprüfen
- Für jeden erstellten Endpunkt wird automatisch ein Signaturgeheimnis erstellt. Damit können Sie jede eingehende Anfrage validieren. Erfahren Sie mehr über das Überprüfen von Webhook-Signaturen.
- (Optional) Ursprungs-IP-Adressen überprüfen:
- Sie können überprüfen, ob die empfangenen Webhooks von unserer Liste autorisierter IP-Adressen stammen:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Sie können überprüfen, ob die empfangenen Webhooks von unserer Liste autorisierter IP-Adressen stammen:
Fehlerbehebung und Überwachung
- Protokolle und Nachvollziehbarkeit: Im Webhook-Bereich sehen Sie jedes Ereignis und ob es erfolgreich zugestellt wurde oder nicht.
- Wiederholungen: Bei einem Zustellfehler wird die Zustellung der Webhooks automatisch wiederholt.
- Replay: Sie können außerdem manuelle Wiederholungen über den Bereich auslösen oder beliebige vergangene Ereignisse innerhalb eines gewählten Zeitfensters erneut abspielen.