Neu: Webhooks wurden aktualisiert
Webhooks bieten jetzt eine bessere Konfiguration, Zustellprotokolle, Ereigniswiederholung (Replay) und Signaturüberprüfung. Wenn Sie Webhooks vor dem 31. August 2026 konfiguriert haben, funktionieren Ihre Endpunkte weiterhin, Sie müssen sie jedoch vor Oktober 2026 migrieren. Sie können die Migrationsschritte befolgen.
Mit Webhooks erhalten Sie Echtzeit-Updates zu Ihren gesendeten und empfangenen Faxen 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 zu dem Integrationsbereich unter Einstellungen.
- Suchen Sie Webhooks und klicken Sie auf Verwalten.
- Fügen Sie einen Endpunkt hinzu:
- 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 empfangen möchten. Abonnieren Sie alle Ereignisse oder wählen Sie nur die benötigten aus
dem Ereigniskatalog aus. -
Optional: Filtern nach Faxnummer. Verknüpfen Sie eine oder mehrere Ihrer Faxnummern, um nur Ereignisse für
diese Nummern zu erhalten.
-
Statusaktualisierungen empfangen
- Nach der Konfiguration sendet Fax.Plus einen Webhook an Ihre angegebene URL, wann immer sich der Faxstatus
ändert. - Die Webhook-Payload enthält wichtige Details wie die Fax-ID, den Status, den Zeitstempel und
Empfängerinformationen.
Hinweis: Wenn hook.id nicht mit data.id übereinstimmt, wird der Webhook für dieses Fax erneut gesendet (Retry). Wenn hook.id mit data.id übereinstimmt, bedeutet dies, dass das Fax zum ersten Mal gesendet wird
- Nach der Konfiguration sendet Fax.Plus einen Webhook an Ihre angegebene URL, wann immer sich der Faxstatus
- Signatur überprüfen
- Für jeden erstellten Endpunkt wird automatisch ein Signaturschlüssel (Signing Secret) generiert, mit dem Sie jede eingehende Anfrage validieren können. Erfahren Sie mehr über die Überprüfung von Webhook-Signaturen.
- (Optional) Ursprungs-IP-Adressen überprüfen:
- Sie können überprüfen, ob die von Ihnen 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 von Ihnen empfangenen Webhooks von unserer Liste autorisierter IP-Adressen stammen:
Fehlerbehebung und Überwachung
- Protokolle und Beobachtbarkeit: Im Webhooks-Bereich können Sie jedes Ereignis einsehen und feststellen, ob es erfolgreich zugestellt wurde oder nicht.
- Wiederholungen: Bei einem Zustellfehler werden Webhooks automatisch erneut zugestellt.
- Replay: Sie können auch manuelle Wiederholungen über den Bereich auslösen oder vergangene Ereignisse innerhalb eines ausgewählten Zeitfensters erneut senden.