Webhooks verwalten
Hier verwaltest du alle Webhooks deines weboffice-Systems. Webhooks ermöglichen es, automatisch Daten an externe Systeme zu senden, wenn bestimmte Ereignisse in weboffice auftreten. So kannst du dein System mit anderen Anwendungen verknüpfen.
Voraussetzungen
Um Webhooks zu verwalten, benötigst du die entsprechende Berechtigung zur Einstellungsverwaltung. Diese Funktion ist normalerweise Administratoren oder technisch versierten Mitarbeitern vorbehalten.
Aufbau der Seite
Die Seite zeigt eine Registerkarte "Webhooks" mit einem Weltkugel-Symbol. In dieser Registerkarte findest du eine übersichtliche Liste aller konfigurierten Webhooks.
So arbeitest du mit dieser Seite
Webhooks anzeigen
Alle deine Webhooks werden in einer strukturierten Liste dargestellt. Du siehst:
- Name: Aussagekräftige Bezeichnung des Webhooks
- URL: Die Zieladresse, an die Daten gesendet werden
- Ereignisse: Welche weboffice-Ereignisse den Webhook auslösen
- Status: Ob der Webhook aktiv oder inaktiv ist
- Letzte Aktivität: Wann der Webhook zuletzt ausgeführt wurde
Neuen Webhook erstellen
- Klicke auf "Hinzufügen" oder das Plus-Symbol
- Gib einen aussagekräftigen Namen ein
- Trage die Ziel-URL des externen Systems ein
- Wähle die Ereignisse aus, die den Webhook auslösen sollen
- Konfiguriere die Authentifizierung (falls erforderlich)
- Teste die Verbindung
- Speichere den neuen Webhook
Webhook bearbeiten
- Klicke auf einen bestehenden Webhook in der Liste
- Ändere Name, URL oder Ereignisse nach Bedarf
- Aktualisiere Authentifizierungsdaten bei Bedarf
- Teste die Änderungen
- Speichere deine Anpassungen
Webhook-Ereignisse konfigurieren
Wähle aus verschiedenen Ereignissen:
- Neue Termine: Wenn ein Termin erstellt wird
- Terminänderungen: Wenn ein Termin geändert oder storniert wird
- Neue Kunden: Wenn ein neuer Kunde angelegt wird
- Rechnungen: Wenn eine Rechnung erstellt oder bezahlt wird
- Zahlungen: Bei Zahlungseingängen oder -problemen
- Artikel: Bei Änderungen am Artikelstamm
Webhook testen
- Wähle einen Webhook aus der Liste
- Klicke auf "Test senden"
- Das System sendet eine Testnachricht an die konfigurierte URL
- Überprüfe in der Protokoll-Ansicht, ob der Test erfolgreich war
- Kontrolliere im Zielsystem, ob die Daten angekommen sind
Webhook-Protokoll einsehen
- Klicke auf einen Webhook, um Details zu sehen
- Wechsle zur Protokoll-Ansicht
- Sieh alle Ausführungen mit Zeitstempel und Status
- Analysiere Fehlermeldungen bei Problemen
- Nutze die Informationen zur Fehlerbehebung
Webhook deaktivieren
- Klicke auf den gewünschten Webhook
- Setze den Status auf "Inaktiv"
- Der Webhook wird nicht mehr ausgeführt, bleibt aber konfiguriert
- Du kannst ihn jederzeit wieder aktivieren
Tipps und Hinweise
- Sichere URLs verwenden: Nutze immer HTTPS-URLs für Webhooks
- Authentifizierung einrichten: Sichere deine Webhooks mit API-Schlüsseln oder Tokens
- Fehlerbehandlung: Plane, wie dein System mit fehlgeschlagenen Webhooks umgeht
- Protokolle überwachen: Überprüfe regelmäßig die Webhook-Protokolle auf Fehler
- Testumgebung nutzen: Teste neue Webhooks zunächst in einer Testumgebung
- Dokumentation führen: Dokumentiere, wofür jeder Webhook verwendet wird
- Performance beachten: Zu viele Webhooks können die Systemleistung beeinträchtigen
- Externe Abhängigkeiten: Bedenke, dass Webhooks von der Verfügbarkeit externer Systeme abhängen
- Datenformat prüfen: Stelle sicher, dass das Zielsystem das Datenformat versteht
- Backup-Strategie: Überlege, was passiert, wenn ein Webhook dauerhaft fehlschlägt