Skip to main content
Der absentify Connector für Power Automate deckt die wichtigsten Trigger und einige Standardaktionen direkt ab. Die Planverfügbarkeit hängt davon ab, ob du Connector-Trigger, Webhooks oder die Plus-exklusive API nutzt; vergleiche sie in der Plan-Feature-Matrix. Wenn du etwas brauchst, das der Connector noch nicht anbietet, kannst du Power Automate auf zwei Wegen manuell mit absentify integrieren – beide werden auf dieser Seite beschrieben:
  • Outbound – HTTP-Aktion + API-Key: Power Automate ruft die absentify-API auf, um Daten zu lesen oder zu ändern (z. B. Benutzer anlegen, Kontingent aktualisieren, Workspace-Einstellungen lesen).
  • Inbound – Webhook-Trigger: absentify sendet Events (Antrag erstellt, Status geändert, Benutzer erstellt oder aktualisiert) an einen Power Automate Flow, ganz ohne Polling.
Eine erweiterte Version des Connectors mit voller Abdeckung für Benutzer, Abteilungen, Abwesenheitsarten, Anträge, Feiertage, Workspace-Einstellungen und Abwesenheiten befindet sich derzeit in der Microsoft-Zertifizierung. Bis sie veröffentlicht ist, sind die HTTP-Aktion und der Webhook-Trigger die empfohlenen Wege.

Wann welchen Weg nutzen?


Teil 1 – Outbound: HTTP-Aktion mit API-Key

Voraussetzungen

  • Ein absentify-Workspace mit dem Plus Plan (die API ist ein Plus-Feature).
  • Eine Power Automate-Lizenz, die die HTTP-Premium-Aktion enthält (jeder Plan mit Premium-Connectoren, z. B. Power Automate Premium).
  • Berechtigung in absentify, einen API-Key zu erzeugen (Workspace-Owner oder Admin).

Schritt 1: API-Key in absentify erzeugen

1

API-Einstellungen öffnen

Gehe in absentify zu Einstellungen → Integrationen und suche den Bereich API. Details: API-Zugriff einrichten.
2

Schlüssel erzeugen

Klicke auf API-Schlüssel erstellen. Der Schlüssel wird nur einmal angezeigt – kopiere ihn sofort und lege ihn sicher ab (Passwortmanager oder Azure Key Vault).
3

Wie ein Passwort behandeln

Der Schlüssel hat die Rechte des Workspaces. Wer ihn besitzt, kann deine Abwesenheitsdaten lesen und ändern.
Füge den API-Key nie direkt in einen Flow ein, den du teilst, exportierst oder in eine Versionsverwaltung legst. Nutze eine sichere Variable, eine Umgebungsvariable oder Azure Key Vault – siehe Schlüssel sicher speichern unten.

Schritt 2: HTTP-Aktion zum Flow hinzufügen

1

Flow öffnen oder erstellen

Gehe zu Power Automate, öffne den Flow, den du erweitern möchtest, und füge einen neuen Schritt hinzu.
2

HTTP-Aktion auswählen

Suche nach HTTP und wähle HTTP – HTTP (die eingebaute Premium-Aktion, nicht HTTP mit Microsoft Entra ID).

Schritt 3: HTTP-Anfrage konfigurieren

Verwende die folgenden Werte. Ersetze your_api_key_here durch den Schlüssel aus Schritt 1 und wähle den Endpunkt, der zu deinem Anwendungsfall passt (siehe API-Referenz).

Beispiel: alle Abwesenheitsanfragen lesen

Die Listen-Endpunkte (/requests, /requests_per_day, /absences_per_day) benötigen start und end. Der Zeitraum dazwischen darf höchstens 1826 Tage (5 Jahre) umfassen. Ein weit in der Zukunft liegendes Enddatum wie end=2100-12-31 wird mit einer 400-Antwort abgelehnt – frage nur den Zeitraum ab, den du wirklich brauchst, und teile längere Zeiträume in Fenster von maximal 5 Jahren auf.

Beispiel: Abwesenheitsanfrage anlegen

Alle verfügbaren Endpunkte, Parameter und Beispiel-Payloads findest du in der API-Referenz. Mit dem Try it-Panel dort kannst du eine Anfrage testen, bevor du sie in Power Automate einbaust.

Schritt 4: JSON-Antwort parsen

Die meisten Endpunkte liefern JSON zurück. Um Werte aus der Antwort in späteren Schritten zu nutzen, füge nach der HTTP-Aktion eine JSON analysieren-Aktion (engl. Parse JSON) hinzu.
1

JSON analysieren hinzufügen

Neuen Schritt hinzufügen → nach JSON analysieren suchen.
2

Inhalt setzen

Setze Inhalt auf den dynamischen Wert Text/Body der HTTP-Aktion.
3

Schema aus Beispiel generieren

Klicke auf Aus Beispiel generieren und füge eine echte Antwort aus der API-Referenz oder aus einem Testaufruf ein. Power Automate erzeugt das Schema für dich.
Nach diesem Schritt steht jedes Feld der Antwort als dynamischer Inhalt in nachfolgenden Aktionen zur Verfügung (z. B. E-Mail senden, Nachricht in Teams posten, Zeile in Dataverse aktualisieren).

Schlüssel sicher speichern

Den API-Key direkt in der HTTP-Aktion zu hinterlegen funktioniert, aber jeder mit Zugriff auf die Flow-Definition kann ihn lesen. Nutze stattdessen einen dieser Wege:
  • Umgebungsvariable (empfohlen für Lösungen): Lege in deiner Solution eine Secret-Umgebungsvariable an, speichere den Schlüssel dort und referenziere sie in der HTTP-Aktion.
  • Azure Key Vault: Lege den Schlüssel im Key Vault ab und füge vor der HTTP-Aktion eine Get secret-Aktion ein. Übergib das Secret an den x-api-key-Header.
  • Sichere Eingaben/Ausgaben: Öffne in der HTTP-Aktion Einstellungen und aktiviere Sichere Eingaben und Sichere Ausgaben, damit der Schlüssel nicht in der Ausführungs-Historie auftaucht.
Wenn du den API-Key versehentlich offengelegt hast (z. B. in einem geteilten Flow-Export), erzeuge ihn sofort neu unter Einstellungen → Integrationen → API. Sobald ein neuer Schlüssel erstellt ist, funktioniert der alte nicht mehr.

Fehler behandeln

Die API verwendet Standard-HTTP-Statuscodes. Mit einer Bedingung oder über Ausführen nach konfigurieren im Folgeschritt kannst du auf Fehler reagieren.

Beispiel-Flow: täglicher Abwesenheits-Digest in Teams

Ein typisches Muster, das alles oben Genannte kombiniert:
1

Trigger

Wiederholung – jeden Werktag um 08:00 Uhr.
2

HTTP

GET https://api.absentify.com/api/v1/absences/per-day?start=...&end=... mit x-api-key-Header.
3

JSON analysieren

Schema aus einer Beispiel-Antwort generieren.
4

Verfassen / Auswählen

Aus dem geparsten Array eine Markdown-Zusammenfassung bauen.
5

In Teams posten

Die Zusammenfassung mit Nachricht in Chat oder Kanal posten in einen Teams-Kanal senden.


Teil 2 – Inbound: Webhook-Trigger

Wenn Power Automate auf Änderungen in absentify reagieren soll (Antrag erstellt, Status geändert, Benutzer erstellt oder aktualisiert), ohne dass du pollen musst, nutze einen Webhook-Trigger. absentify sendet beim Event einen JSON-POST an eine Power Automate URL.

So funktioniert’s

Du erstellst einen Flow, dessen Trigger eine öffentliche URL bereitstellt, und registrierst diese URL als Webhook in absentify.

Schritt 1: Flow mit HTTP-Request-Trigger anlegen

1

Neuer Sofort-Flow

In Power Automate auf Erstellen → Sofortiger Cloud-Flow klicken.
2

Trigger wählen

Als Trigger Wenn eine HTTP-Anfrage empfangen wird auswählen. (Dieser Trigger ist in Standard-Power-Automate-Plänen enthalten – es ist kein Premium-Connector.)
3

Methode auf POST setzen

In den Trigger-Einstellungen Wer kann den Flow auslösen auf Jeder und die Methode auf POST setzen.

Schritt 2: Schema der Anfrage generieren

Füge ein Beispiel-Payload bei Beispielnutzlast zum Generieren des Schemas verwenden ein, damit Power Automate jedes Feld als dynamischen Inhalt in späteren Schritten anbietet.
Vollständige v2-Payloads findest du in der Webhook-Referenz – sie entsprechen den Antworten von GET /api/v1/requests/{id} und GET /api/v1/members/{id}.

Schritt 3: Folgeaktionen ergänzen und Flow speichern

Füge die gewünschten Aktionen hinzu – z. B. Nachricht in Chat oder Kanal posten (Teams), E-Mail senden, Zeile in Dataverse aktualisieren – und nutze die dynamischen Inhalte aus dem Trigger. Sobald du auf Speichern klickst, zeigt Power Automate oben im Trigger die HTTP-POST-URL an. Klicke auf das Kopiersymbol daneben.
Diese URL enthält eine SAS-Signatur, mit der jeder, der sie kennt, deinen Flow auslösen kann. Behandle sie wie ein Geheimnis. Falls sie geleakt wird, regeneriere sie (Trigger öffnen → URL erneut generieren) und aktualisiere den Webhook in absentify.

Schritt 4: URL als Webhook in absentify registrieren

1

Webhook-Einstellungen öffnen

In absentify zu Einstellungen → Integrationen gehen und den Bereich Webhooks suchen. Details: Webhook-Integration.
2

URL konfigurieren

Auf URL konfigurieren klicken und die Power-Automate-URL aus Schritt 3 einfügen.
3

Event-Typ wählen

Alle Events oder einen der folgenden Typen wählen: request_created, request_status_changed, user_created, user_updated.
4

Payload v2 wählen

Für neue Integrationen immer v2 auswählen. v1 ist veraltet.
5

Speichern

Auf Hinzufügen klicken.

Schritt 5: Flow testen

Löse das Event in absentify aus (z. B. einen Antrag erstellen) und öffne in Power Automate Meine Flows → Ausführungsverlauf. Dort sollte ein erfolgreicher Lauf mit dem absentify-Payload erscheinen. Falls kein Lauf erscheint, prüfe:
  • Der Webhook ist mit derselben URL gespeichert, die der Flow-Trigger jetzt anzeigt.
  • Der Flow ist aktiviert.
  • Der Event-Typ passt zu dem, was du ausgelöst hast.

Outbound und Inbound kombinieren

Beide Wege ergänzen sich gut. Typisches Muster:
1

Inbound Webhook

Flow wird durch request_status_changed ausgelöst.
2

Auf Status verzweigen

Eine Bedingung prüft, ob der Status APPROVED ist.
3

Outbound HTTP

Bei Genehmigung ruft eine HTTP-Aktion GET /api/v1/members/{id} auf (mit dem API-Key aus Teil 1), um Abteilung, Manager oder benutzerdefinierte Felder zu lesen, die nicht im Webhook-Payload enthalten sind.
4

Aktion ausführen

In Teams posten, Dataverse aktualisieren, ins HRIS synchronisieren.

Nächste Schritte