Webhooks einrichten

Webhooks ermöglichen es dir, in absentify Benachrichtigungen in Echtzeit zu erhalten, wenn bestimmte Ereignisse eintreten, wie z. B. die Erstellung eines Antrags, die Änderung seines Status oder wenn Benutzer erstellt oder verändert werden. Dadurch kannst du nahtlose Integrationen mit deinen internen Tools oder externen Systemen aufbauen.

---

​

Netzwerkanforderungen

Wenn dein Webhook-Endpunkt hinter einer Firewall liegt, füge die folgende IP-Adresse zur Allowlist hinzu, damit absentify Webhook-Benachrichtigungen senden kann: Ausgehende IP-Adresse: 4.231.227.89 Alle Webhook-HTTP-POST-Anfragen von absentify werden von dieser IP-Adresse gesendet.

---

​

Was sind Webhooks?

Ein Webhook ist eine Methode, mit der Apps in Echtzeit Informationen an andere Apps senden. In absentify kannst du Webhooks verwenden, um deine Systeme auf bestimmte Ereignisse (z. B. das Erstellen eines Abwesenheitsantrags, die Aktualisierung von Benutzerkonten) reagieren zu lassen und Workflows oder Prozesse automatisch auszulösen.

---

​

Vorteile von Webhooks

• Echtzeit-Updates: Erhalte sofortige Benachrichtigungen über Änderungen in absentify, wie neue Anträge, Statusaktualisierungen oder Änderungen an Benutzerkonten.
• Nahtlose Integration: Verbinde absentify mit deinen internen Systemen, wie z. B. HR-Software oder Benachrichtigungstools.
• Individuelle Workflows: Verwende Webhooks, um automatisierte Aktionen auszulösen, wie das Senden von Benachrichtigungen, Aktualisieren von Dashboards oder die Integration mit benutzerdefinierten Tools.

---

​

Webhooks in absentify einrichten

​

Schritt 1: Webhook-Einstellungen aufrufen

1. Gehe zu Einstellungen > Integrationen.
2. Klicke im Abschnitt Webhooks auf URLs konfigurieren.

---

​

Schritt 2: Eine Webhook-URL hinzufügen

1. Im Abschnitt URLs für den Empfang von Webhooks:
   • Wähle das Ereignis aus, das du überwachen möchtest:
     • Alle Anfragen: Benachrichtigungen bei Erstellung und Statusänderung von Anträgen
     • Anfrage erstellt: Wenn ein neuer Abwesenheitsantrag eingereicht wird
     • Anfragestatus geändert: Wenn ein Antrag genehmigt, abgelehnt oder storniert wird
     • Antrag geändert: Wenn Daten, Uhrzeiten, die Abwesenheitsart oder der Grund eines Antrags geändert werden. Die Payload enthält die alten und die neuen Werte.
     • Alle Anträge und Änderungen: Benachrichtigungen bei Erstellung, Statusänderung oder inhaltlicher Änderung von Anträgen
     • Benutzer erstellt: Wenn ein neuer Benutzer zum System hinzugefügt wird
     • Benutzer aktualisiert: Wenn Benutzerinformationen geändert werden (Profil, Rolle, etc.)
     • Alle Benutzer: Benachrichtigungen bei Erstellung und Aktualisierung von Benutzern
   • Gib deine Endpoint-URL in das Textfeld ein (z. B. https://dein-webhook-endpunkt.com).
2. Klicke auf Hinzufügen, um den Webhook zu speichern.

---

​

Payload-Format

Alle über die UI konfigurierten Webhooks verwenden das v1-Payload-Format. Antragsereignisse werden als flaches JSON-Objekt mit einem event_type-Feld im Root gesendet; Benutzerereignisse nutzen einen event_type- und body-Wrapper. Die vollständige Feldreferenz und Beispiel-Payloads findest du in der Entwicklerdokumentation.

---

​

Schritt 3: Bestehende Webhooks verwalten

1. Du siehst eine Liste der konfigurierten Webhook-URLs unter URLs für den Empfang von Webhooks.
2. Für jeden Webhook kannst du:
   • Mit dem Stiftsymbol die URL oder den Ereignistyp bearbeiten.
   • Mit dem Papierkorb-Symbol einen Webhook löschen.

---

​

Schritt 4: Webhook-Verlauf anzeigen

1. Klicke unten in den Webhook-Einstellungen auf Benachrichtigungsprotokoll.
2. Hier siehst du eine Historie aller Webhook-Ereignisse, einschließlich:
   • Dem Status jedes Ereignisses: Erfolgreich, Fehlgeschlagen oder Ausstehend.
   • Dem Name des Ereignisses (z. B. Anfrage erstellt, Benutzer aktualisiert).
   • Der Anzahl der Versuche.
3. Verwende die Schaltfläche Wiederholen, um eine Zustellung erneut zu senden.
4. Wähle Filter, um einen Filter für Status, Endpoint oder Ereignisart hinzuzufügen. Am Filter wählst du ist oder ist nicht. Wenn du mehr als einen Wert wählst, zeigt der Filter ist einer von oder ist keiner von. Wenn ein Filter aktiv ist, zeigt das Protokoll, wie viele Lieferungen passen.
5. Fehlgeschlagene Lieferungen haben ein Kontrollkästchen. Wähle die Zeilen. Das Kontrollkästchen in der Tabellenkopfzeile wählt alle fehlgeschlagenen Lieferungen auf dieser Seite. Eine Leiste erscheint. Wähle Wiederholen.

---

​

Webhooks mit Power Automate nutzen

Webhooks sind ein No-Code-Weg, um Power-Automate-Flows aus absentify auszulösen – ohne den absentify-Connector. Der Flow stellt über den Trigger Wenn eine HTTP-Anfrage empfangen wird eine öffentliche URL bereit; diese URL trägst du hier als Webhook-Endpunkt ein. Das ist der empfohlene Inbound-Weg, wenn:

• Der absentify-Connector in deinem Tenant noch nicht verfügbar ist.
• Du eventgesteuerte Automatisierung willst, den Connector aber nicht nutzen kannst oder möchtest.
• Du in einem Flow den Event-Empfang mit direkten API-Aufrufen kombinieren willst.

Schritt-für-Schritt-Anleitung: Power Automate (HTTP & Webhooks).

---

​

Anwendungsbeispiele für Webhooks

​

Antragsbezogene Workflows

• Benachrichtigungen: Sende Benachrichtigungen an Slack oder Microsoft Teams, wenn ein neuer Abwesenheitsantrag erstellt wird.
• HR-Automatisierung: Aktualisiere automatisch Datensätze in deinem HR-Management-System, wenn sich der Status eines Antrags ändert.
• Dashboards: Aktualisiere Echtzeit-Dashboards mit den neuesten Abwesenheitsdaten.

​

Benutzerverwaltung-Workflows

• Onboarding-Automatisierung: Löse Willkommens-E-Mails oder Kontoeinrichtungsprozesse aus, wenn ein neuer Benutzer erstellt wird.
• Verzeichnissynchronisation: Halte externe Benutzerverzeichnisse synchron, wenn Benutzerinformationen aktualisiert werden.
• Zugriffsverwaltung: Stelle automatisch Benutzerzugriff in verbundenen Systemen bereit oder aktualisiere ihn.

---

​

Erweiterte Nutzung und Entwickler-Support

Um benutzerdefinierte Integrationen zu erstellen oder erweiterte Webhook-Workflows zu implementieren, sieh dir unsere Entwicklerdokumentation an. Sie enthält detaillierte Informationen zu:

• Verfügbaren Webhook-Ereignissen
• Aktuellem v1-Payload-Format für Antrags- und Benutzerereignisse
• Geplantem v2-Format (Public-API-kompatibel)
• Best Practices zur Sicherung deiner Webhook-Endpunkte

Du kannst außerdem die Microsoft-Sync-Logs verwenden, um Ereignisse zu überwachen, die durch verbundene Microsoft-Dienste oder automatisierte Synchronisationen ausgelöst wurden.