Wie können Sie mit Webhooks den Status Ihres gesendeten oder empfangenen fax prüfen?

Wer kann diese Funktion nutzen?

Verfügbar im Enterprise-Tarif.

Zugänglich für Inhaber und Administratoren in der Web-App.

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 Faxen direkt von Fax.Plus. Wenn Sie Webhooks konfigurieren, können Sie die Überwachung Ihrer Faxübertragungen automatisieren und Statusaktualisierungen in Ihre bestehenden Systeme integrieren.

Entwicklerreferenz: Alle technischen Details, darunter Ereignistypen, Payload-Struktur und Signaturprüfung, finden Sie in der Fax.Plus-API-Dokumentation zu Webhooks.

Webhook-Konfiguration

  1. Ö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.
  2. 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: Nach Faxnummer filtern. Weisen Sie eine oder mehrere Ihrer Faxnummern zu, um nur Ereignisse für
      diese Nummern zu erhalten.
  3. Statusaktualisierungen empfangen

    • Nach der Konfiguration sendet Fax.Plus immer dann einen Webhook an die von Ihnen angegebene URL, wenn sich ein Faxstatus
      ändert.
    • Die Webhook-Payload enthält wichtige Details wie Fax-ID, Status, Zeitstempel und
      Empfängerinformationen.

    Hinweis: Wenn hook.id nicht mit data.id übereinstimmt, handelt es sich um einen erneuten Sendeversuch des Faxes. Wenn hook.id gleich data.id ist, wird das Fax zum ersten Mal gesendet.

  4. Signatur überprüfen
    • Für jeden erstellten Endpunkt wird automatisch ein Signing Secret erzeugt, mit dem Sie jede eingehende Anfrage validieren können. Weitere Informationen zum Überprüfen von Webhook-Signaturen.
  5. (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

Fehlerbehebung und Überwachung

  • Protokolle und Überwachung: Im Webhook-Bereich sehen Sie jedes Ereignis und ob es erfolgreich zugestellt wurde oder nicht.
  • Wiederholungsversuche: Bei fehlgeschlagener Zustellung werden Webhooks automatisch erneut gesendet.
  • Erneute Zustellung: Sie können auch manuelle Wiederholungsversuche über den Webhook-Bereich auslösen oder beliebige vergangene Ereignisse innerhalb eines gewählten Zeitfensters erneut abspielen.
War dieser Beitrag hilfreich?
0 von 1 fanden dies hilfreich
Weitere Artikel in diesem Abschnitt