Wenn Webhook-Zustellungen fehlschlagen, ist es wichtig, dass die richtigen Personen benachrichtigt werden, damit sie das Problem schnell lösen können. Sie können jetzt einen dedizierten Technischen Kontakt für Ihr Unternehmen konfigurieren, um sicherzustellen, dass API-bezogene Benachrichtigungen an das Team gesendet werden, das für die Wartung Ihrer Integrationen verantwortlich ist.
Überblick
Der Technische Kontakt ermöglicht es Ihrem Unternehmen, die E-Mail-Adresse festzulegen, die API-Benachrichtigungs-E-Mails erhalten soll, wie z.B. Benachrichtigungen über fehlgeschlagene Webhook-Zustellungen.
Früher wurden diese Benachrichtigungen an einen abgeleiteten Empfänger gesendet, wie z.B. die E-Mail des Partners, den Eigentümer der OAuth-Anwendung oder die Person, die das Webhook-Abonnement erstellt hat. In vielen Fällen waren diese Empfänger nicht mehr für die Integration verantwortlich, was dazu führte, dass Probleme unbemerkt blieben.
Durch die Konfiguration eines Technischen Kontakts können Sie sicherstellen, dass API-Benachrichtigungen das entsprechende Team erreichen und dazu beitragen, Ausfallzeiten durch unbemerkte Webhook-Fehler zu reduzieren.
Wenn kein Technischer Kontakt konfiguriert ist, funktioniert der Benachrichtigungsprozess wie zuvor.
So verwenden Sie es
- Gehen Sie in Ihrer Seitenleiste zu Einstellungen
- Öffnen Sie Erweiterte Konfiguration
- Wählen Sie API-Benachrichtigungen
- Geben Sie im Feld Technischer Kontakt die E-Mail-Adresse ein, die API-Benachrichtigungen erhalten soll
- Klicken Sie auf Speichern
Um den Technischen Kontakt zu entfernen, löschen Sie das Feld für den Technischen Kontakt. Nach der Entfernung folgen die Benachrichtigungen dem Standardempfängerfluss.
Wenn Sie die E-Mail-Adresse des Technischen Kontakts nicht speichern können, könnte die E-Mail-Adresse nicht im gültigen Format vorliegen. Überprüfen Sie, ob Sie eine gültige E-Mail-Adresse eingegeben haben, und versuchen Sie es erneut zu speichern.
Wie Benachrichtigungen gesendet werden
Wenn eine Webhook-Zustellung fehlschlägt, benachrichtigt Factorial die Empfänger in folgender Reihenfolge:
- Partner-E-Mail
- Technischer Kontakt des Unternehmens (falls konfiguriert)
- Eigentümer der OAuth-Anwendung
- Autor des Webhook-Abonnements
- Unternehmensadministratoren
Wenn kein Technischer Kontakt konfiguriert wurde, wird dieser Schritt übersprungen und der verbleibende Benachrichtigungsfluss bleibt unverändert.
Wenn eine Webhook-Zustellung nach dem Ausschöpfen aller Wiederholungsversuche ihren endgültigen Fehlerstatus erreicht, erhalten die Unternehmensadministratoren weiterhin die Benachrichtigung als letzte Rückfalloption.
Tipps und bewährte Praktiken
- Konfigurieren Sie eine gemeinsame Team-E-Mail-Adresse (zum Beispiel das Postfach Ihres Engineering- oder IT-Teams) anstelle der E-Mail-Adresse einer einzelnen Person
- Überprüfen Sie regelmäßig den konfigurierten Technischen Kontakt, um sicherzustellen, dass er aktuell bleibt
- Verwenden Sie ein überwachtetes Postfach, damit Webhook-Fehler so schnell wie möglich behoben werden können
FAQ
-
Ist die Konfiguration eines Technischen Kontakts obligatorisch?
Nein. Wenn Sie keinen Technischen Kontakt konfigurieren, verwendet Factorial weiterhin den bestehenden Benachrichtigungsfluss ohne Änderungen.
-
Wer sollte als Technischer Kontakt konfiguriert werden?
Wir empfehlen, ein überwachtetes gemeinsames Postfach zu verwenden, das dem Team gehört, das für die Wartung Ihrer API-Integrationen verantwortlich ist, anstelle der E-Mail-Adresse eines einzelnen Mitarbeiters.
-
Beeinflusst diese Änderung bestehende Webhook-Abonnements?
Ja. Sobald ein Technischer Kontakt konfiguriert ist, wird er Teil der Empfänger-Kaskade für Benachrichtigungen über fehlgeschlagene Webhook-Zustellungen. Es sind keine Änderungen an bestehenden Webhook-Abonnements erforderlich.
-
Was passiert, wenn ich den Technischen Kontakt entferne?
Der Technische Kontakt wird aus dem Benachrichtigungsfluss entfernt, und die Benachrichtigungen über Webhook-Fehler folgen der gleichen Empfänger-Kaskade, die vor der Einführung dieses Features verwendet wurde.