weboffice.digital - Dokumentation
Branche Beauty Branche Gastro Branche Handel
PDF

Webhook bearbeiten

Webhook bearbeiten

In diesem Fenster konfigurierst du Webhooks, die automatisch Benachrichtigungen an externe Systeme senden, wenn bestimmte Ereignisse in weboffice auftreten. Webhooks ermöglichen es dir, deine Software mit anderen Anwendungen zu verbinden und Arbeitsabläufe zu automatisieren.

Voraussetzungen

  • Du benötigst entsprechende Administratorrechte
  • Du solltest die URL des Zielsystems kennen, das die Webhook-Nachrichten empfangen soll
  • Grundkenntnisse über Webhooks und HTTP-Requests sind hilfreich

Aufbau des Fensters

Webhook-Konfiguration

Bezeichnung: Gib hier einen aussagekräftigen Namen für den Webhook ein (z.B. "CRM-Integration", "Buchhaltungs-Sync", "Marketing-Automation")

URL: Trage die vollständige Internetadresse ein, an die die Webhook-Nachrichten gesendet werden sollen (z.B. "https://api.dein-system.de/webhooks/weboffice")

Secret (HMAC-SHA256): Gib hier einen geheimen Schlüssel ein, der zur Signierung der Nachrichten verwendet wird. Dies erhöht die Sicherheit, da das empfangende System prüfen kann, ob die Nachricht wirklich von weboffice stammt

Standort: Wähle den Standort aus, für den dieser Webhook aktiv sein soll. Nur Ereignisse dieses Standorts lösen den Webhook aus

Events

In diesem Bereich wählst du aus, bei welchen Ereignissen der Webhook ausgelöst werden soll:

Kunden-Events:

  • Kunde erstellt: Wird ausgelöst, wenn ein neuer Kunde angelegt wird
  • Kunde aktualisiert: Wird ausgelöst, wenn Kundendaten geändert werden
  • Kunde gelöscht: Wird ausgelöst, wenn ein Kunde gelöscht wird

Rechnungs-Events:

  • Rechnung erstellt: Wird ausgelöst, wenn eine neue Rechnung erstellt wird
  • Rechnung aktualisiert: Wird ausgelöst, wenn eine Rechnung geändert wird
  • Rechnung bezahlt: Wird ausgelöst, wenn eine Rechnung als bezahlt markiert wird
  • Rechnung storniert: Wird ausgelöst, wenn eine Rechnung storniert wird

Termin-Events:

  • Termin erstellt: Wird ausgelöst, wenn ein neuer Termin gebucht wird
  • Termin aktualisiert: Wird ausgelöst, wenn ein Termin geändert wird
  • Termin storniert: Wird ausgelöst, wenn ein Termin abgesagt wird

Weitere Events:

  • Zahlung eingegangen: Wird ausgelöst, wenn eine Zahlung verbucht wird
  • Artikel erstellt/aktualisiert: Wird ausgelöst bei Änderungen am Artikelstamm
  • Auftrag erstellt/aktualisiert: Wird ausgelöst bei Auftragsänderungen
  • Beleg erstellt: Wird ausgelöst, wenn ein neuer Beleg erfasst wird
  • Mitarbeiter erstellt/aktualisiert: Wird ausgelöst bei Mitarbeiteränderungen

So arbeitest du mit diesem Fenster

  1. Webhook benennen: Gib einen eindeutigen, verständlichen Namen ein
  2. Ziel-URL eingeben: Trage die URL des empfangenden Systems ein
  3. Secret festlegen: Wähle einen sicheren, geheimen Schlüssel
  4. Standort auswählen: Bestimme, für welchen Standort der Webhook gelten soll
  5. Events auswählen: Aktiviere alle Ereignisse, die übertragen werden sollen
  6. Speichern: Klicke auf "Speichern" um den Webhook zu aktivieren

Tipps und Hinweise

  • Sichere URLs: Verwende immer HTTPS-URLs für die Übertragung
  • Secret-Sicherheit: Wähle einen langen, zufälligen Secret-Schlüssel
  • Event-Auswahl: Wähle nur die Events aus, die du wirklich benötigst, um unnötigen Traffic zu vermeiden
  • Testen: Teste den Webhook nach der Einrichtung mit einem Testevent
  • Monitoring: Überwache die Webhook-Aufrufe, um sicherzustellen, dass sie funktionieren
  • Fehlerbehandlung: Das empfangende System sollte HTTP-Statuscodes korrekt zurückgeben

Anwendungsbeispiele

CRM-Integration:

  • Neue Kunden automatisch ins CRM übertragen
  • Kundendaten synchron halten
  • Termine im CRM-Kalender erstellen

Buchhaltungs-Integration:

  • Rechnungen automatisch in die Buchhaltung übertragen
  • Zahlungseingänge synchronisieren
  • Kundenstammdaten abgleichen

Marketing-Automation:

  • Neue Kunden in Newsletter-Listen eintragen
  • Terminbestätigungen versenden
  • Follow-up-E-Mails nach Terminen

Lagerverwaltung:

  • Artikelbestände aktualisieren
  • Bestellungen auslösen
  • Lieferbenachrichtigungen senden

Sicherheitshinweise

  • HMAC-Verifikation: Das empfangende System sollte die HMAC-Signatur prüfen
  • IP-Beschränkung: Beschränke den Zugriff auf bekannte IP-Adressen
  • Rate-Limiting: Implementiere Schutz vor zu vielen Anfragen
  • Logging: Protokolliere alle Webhook-Aufrufe für die Fehleranalyse

Verwandte Seiten