- 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.
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. Ersetzeyour_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
Beispiel: Abwesenheitsanfrage anlegen
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.
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.
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
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.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.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
- API-Referenz – komplette Liste aller Endpunkte, Parameter und Beispiel-Payloads.
- Authentifizierung – Details zum
x-api-key-Header. - Webhook-Referenz – Payload-Schemas für alle Event-Typen.
- Webhook-Integration – Webhooks im absentify-Dashboard einrichten und verwalten.
- Limits – Rate-Limits, mit denen du planen solltest.
- absentify Connector für Power Automate – zurück zum connector-basierten Flow.