Activepieces Smart-Home-Integration, kostenlos und Open Source

Deine Activepieces-Flows in Gladys: Starte sie aus einer Szene, reagiere, wenn einer fehlschlägt.
Activepieces ist ein Open-Source-Werkzeug für Automatisierungen, das du selbst hosten kannst: Flows aus einem Auslöser und Schritten holen Daten, rufen Dienste auf, senden Nachrichten. Diese Integration bringt deine Activepieces-Flows in Gladys: Jeder Flow wird ein Gerät mit seinem Zustand (aktiviert oder nicht, letzte Ausführung erfolgreich oder fehlgeschlagen, Fehlschläge der letzten 24 Stunden), Szenen können einen Flow starten über seinen Webhook und seine Antwort nutzen, reagieren, wenn irgendeine Ausführung fehlschlägt oder ein Flow deaktiviert wird, und ein Dashboard-Widget zeigt die fehlschlagenden Flows zuerst.
Getestet mit einem echten, selbst gehosteten Activepieces 0.82 (Docker, Community Edition); nicht mit Activepieces Cloud: Rückmeldungen sind willkommen in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Activepieces, selbst gehostet und vom Gladys-Rechner aus erreichbar.
- E-Mail-Adresse und Passwort eines Activepieces-Benutzers. Die Community Edition hat keine API-Schlüssel (sie gehören zu den kostenpflichtigen Editionen), daher meldet sich die Integration wie die Weboberfläche an. Lege wenn möglich einen eigenen Benutzer an: Gladys sieht die Flows seines Projekts.
Bei jeder Aktualisierung (standardmäßig jede Minute) sendet die Integration vier Anfragen an Activepieces, beim ersten Mal ein paar mehr, und meldet sich einmal pro Woche neu an (die Sitzung hält 7 Tage). Die Community Edition begrenzt ihre API nicht.
Erste Schritte
1. Activepieces vorbereiten
Notiere die Adresse, mit der du Activepieces öffnest (Port 8080 mit der offiziellen docker-compose-Datei), sowie E-Mail-Adresse und Passwort des Benutzers, dessen Flows Gladys verfolgen soll. Nur Anmeldung über Google oder einen anderen Anbieter: Gib diesem Benutzer zuerst ein Passwort.
2. Die Integration konfigurieren
Öffne in Gladys die Konfiguration der Activepieces-Integration:
- Activepieces-Adresse: zum Beispiel
http://192.168.1.2:8080. Eine reine IP-Adresse bekommt Port 8080. Eine aus dem Browser kopierte URL geht auch. - E-Mail-Adresse und Passwort: die des Benutzers aus Schritt 1.
- Projekt (optional): leer, das eigene Projekt des Benutzers. Sonst die ID des Projekts oder die aus dem Browser kopierte Adresse einer seiner Seiten.
- Aktualisierungsintervall: 30 Sekunden bis 5 Minuten.
- Flows aus Gladys schalten erlauben: standardmäßig aus, siehe unten.
- Sprache der Namen: Sprache der Funktionsnamen, der Zustände und der Szenenergebnisse.
Klicke auf Verbindung testen: Der Test zeigt die Version, die Flows, die aktivierten und die Fehlschläge der letzten 24 Stunden.
3. Die Flows hinzufügen
Öffne den Tab Entdecken der Integration und füge die zu verfolgenden Flows hinzu, dazu das Gerät Activepieces, wenn du die Zahlen der ganzen Instanz willst. Nichts wird ohne dich hinzugefügt. Die Szenenauslöser funktionieren für alle Flows, hinzugefügt oder nicht.
Die Geräte
Jeder Flow ergibt ein Gerät:
| Funktion | Wert |
|---|---|
| Aktiviert | der Flow ist aktiviert oder nicht |
| Letzte Ausführung | Erfolgreich, Fehlgeschlagen, Zeitüberschreitung, Läuft… |
| Funktioniert | Nein, wenn die letzte beendete Ausführung fehlschlug, sonst Ja |
| Fehlschläge in 24 h | fehlgeschlagene Ausführungen der letzten 24 Stunden |
| Letzter Start | Beginn der letzten Ausführung, Tag/Monat Stunden:Minuten |
| Dauer der letzten Ausführung | der letzten beendeten Ausführung, in Sekunden |
Eine laufende Ausführung behält in Funktioniert das Urteil der vorherigen: Ein fehlschlagender Flow, der neu läuft, wirkt nicht für ein paar Sekunden repariert.
Der Schalter Aktiviert zeigt standardmäßig nur den Zustand. Mit Flows aus Gladys schalten erlauben aktiviert und deaktiviert er den Flow: Klicke nach dem Ändern der Option im Tab Entdecken bei den Geräten auf Aktualisieren. Ein nie veröffentlichter Flow kann nicht aktiviert werden.
Das Gerät Activepieces liefert Erreichbar (Nein, solange Activepieces nicht antwortet), die Version, die Aktivierte Flows, die Fehlschläge in 24 h und die Flows insgesamt.
Dashboard
Das Widget Activepieces-Flows zeigt drei Kacheln (aktivierte Flows, Fehlschläge in 24 Stunden, laufende Ausführungen), dann eine Zeile pro Flow: zuerst die fehlschlagenden, dann die laufenden, dann die übrigen, mit dem Zustand der letzten Ausführung, ihrer Startzeit und den Fehlschlägen des Tages. Standardmäßig zeigt es die aktivierten Flows; wähle andere in seinen Einstellungen (zu Gladys hinzugefügte Geräte, mit dem Namen, den du ihnen gegeben hast). Die Schaltfläche Aktualisieren liest Activepieces neu; eine Einstellung blendet sie aus.
Szenen
Auslöser
- Eine Flow-Ausführung schlägt fehl: Eine Ausführung endet fehlgeschlagen, mit Zeitüberschreitung, ohne Speicher, über einem Kontingent oder einer Protokollgrenze oder mit einem internen Fehler. Filter: die Flows (leer: alle). Weitergegebene Informationen: Name des Flows, Fehlermeldung, fehlerhafter Schritt, Status der Ausführung, Link zur Ausführung in Activepieces.
- Ein Flow wird deaktiviert: Ein aktivierter Flow wird deaktiviert, von Hand, von Activepieces oder durch eine Szene: Sein Auslöser läuft nicht mehr. Filter: die Flows. Weitergegebene Information: Name des Flows.
Die erste Abfrage merkt sich nur, was schon passiert ist: Für die Vergangenheit wird nichts gemeldet. Ein Fehlschlag während eines Neustarts von Gladys oder der Integration wird einmal gemeldet, bei der nächsten Abfrage. Für „Activepieces antwortet nicht“ nutze die Funktion Erreichbar des Geräts Activepieces in einer Szene.
Aktionen
- Activepieces-Flow starten: Der Flow muss mit dem Auslöser Catch
Webhook (Authentifizierung: None) beginnen und veröffentlicht sein. Wähle
in der Szene den Flow (ein zu Gladys hinzugefügtes Gerät) oder füge für
einen nicht hinzugefügten Flow die vom Auslöser angezeigte URL ein
(
…/api/v1/webhooks/…). Inhalt: JSON wie{"raum": "Wohnzimmer"}oder ein Text, der als{"text": "…"}gesendet wird; Werte der Szene können eingefügt werden, der Flow liest sie intrigger.body. Ohne Auf die Antwort warten antwortet Activepieces sofort und die Ausführung läuft allein weiter. Mit dieser Option muss der Flow mit einem Schritt Return Response (Webhook-Piece) enden, in höchstens 30 Sekunden. Ergebnisse: erfolgreich beantwortet, HTTP-Status (404: Der Flow ist deaktiviert oder nicht veröffentlicht; 0: keine Antwort rechtzeitig), Antwortnachricht (das Feldmessageodertextder Antwort), vollständige Antwort. - Zustand eines Flows: aktiviert oder nicht, letzte Ausführung fehlgeschlagen oder nicht, Zustand, Fehlschläge in 24 h, letzter Start, Dauer, letzter Fehler und ein fertiger Satz, für die nächsten Aktionen (eine Nachricht, eine Bedingung).
- Flow aktivieren / Flow deaktivieren: zum Beispiel ein Flow, der nur im Urlaub laufen soll. Diese Aktionen funktionieren unabhängig von der Option des Schalters.
Szenenideen
- Eine Flow-Ausführung schlägt fehl → eine Nachricht senden: „Activepieces: {flow} ist im Schritt {schritt} fehlgeschlagen: {fehler}“ mit dem Link zur Ausführung.
- Eine Schaltfläche im Dashboard oder „Ich gehe“ → Activepieces-Flow
starten mit
{"benutzer": "…"}und Auf die Antwort warten, dann die Antwortnachricht des Flows senden. - Ein Flow wird deaktiviert → eine Nachricht senden: Ein Flow, auf den du dich verlässt, ist gestoppt.
- Jeden Morgen → Zustand eines Flows „Nächtliche Sicherung“ → nur weitermachen, wenn „Letzte Ausführung fehlgeschlagen“ wahr ist → den Satz senden.
Fehlerbehebung
- E-Mail-Adresse oder Passwort abgelehnt: Prüfe sie auf der Anmeldeseite von Activepieces. Ein über Google angelegter Benutzer hat kein Passwort.
- Von Activepieces abgelehnt: Dieser Benutzer darf das nicht: Der Benutzer ist kein Mitglied des Projekts, oder seine Rolle darf Flows nicht ändern.
- Projekt nicht gefunden: Prüfe die ID oder lass das Feld leer.
- Keine Activepieces-API unter dieser Adresse: Prüfe die Adresse (Port 8080 mit der offiziellen docker-compose-Datei). Hinter einem Reverse-Proxy mit Unterpfad gehört der Unterpfad in die Adresse.
- Die Adresse leitet um: Gib die
https://-Adresse ein. - Zertifikat abgelehnt: Ein selbst signiertes Zertifikat wird nicht
akzeptiert; nutze im lokalen Netz die
http://-Adresse. - Der Webhook antwortet 404: Der Flow ist deaktiviert, wurde nie
veröffentlicht, oder sein Auslöser ist nicht Catch Webhook. Die Test-URL
(
/draft) wird nicht akzeptiert. - Auf die Antwort warten liefert Status 0 oder eine leere Antwort: Füge am Ende des Flows einen Schritt Return Response hinzu.
- Protokolle: In Gladys zeigt die Seite der Integration die Protokolle ihres
Containers;
LOG_LEVEL=debugzeigt jede Abfrage.
Grenzen
- Entwickelt und getestet mit Activepieces 0.82 in Docker, ohne Activepieces Cloud und ohne die kostenpflichtigen Editionen: Rückmeldungen sind willkommen.
- Ein Projekt pro Konfiguration; das Passwort des Benutzers speichert Gladys wie die anderen Geheimnisse der Integrationen.
- API-Schlüssel der kostenpflichtigen Editionen werden noch nicht unterstützt.
- Flows werden in Gladys weder erstellt noch bearbeitet.
- Pro Abfrage werden höchstens 500 fehlgeschlagene Ausführungen der letzten 24 Stunden gelesen und höchstens 10 Fehlschläge gemeldet.
- Mit Basic- oder Header-Authentifizierung geschützte Webhooks werden nicht unterstützt.
- Activepieces behält die Ausführungen standardmäßig 30 Tage
(
AP_EXECUTION_DATA_RETENTION_DAYS).
Konfigurationseinstellungen
Diese Einstellungen fragt Activepieces in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Activepieces | section | Nein | Gib die Adresse von Activepieces sowie E-Mail-Adresse und Passwort eines Benutzers ein: Die Community Edition hat keine API-Schlüssel. Füge dann die zu verfolgenden Flows im Tab „Entdecken“ hinzu. |
| Activepieces-Adresse | string | Nein | Die Adresse, mit der du Activepieces öffnest. Zu einer reinen IP-Adresse wird Port 8080 ergänzt. |
| E-Mail-Adresse | string | Nein | Des Activepieces-Benutzers, dessen Flows Gladys verfolgt. Am besten ein eigener Benutzer. |
| Passwort | secret | Nein | |
| Projekt (optional) | string | Nein | Leer: das eigene Projekt des Benutzers. Sonst seine ID oder die Adresse einer seiner Seiten. |
| Optionen | section | Nein | |
| Aktualisierungsintervall | select | Nein | Wie oft Activepieces gelesen wird: jedes Mal mindestens vier API-Anfragen. |
| Flows aus Gladys schalten erlauben | boolean | Nein | Aus: Der Schalter „Aktiviert“ zeigt nur den Zustand. An: Er aktiviert und deaktiviert den Flow (klicke danach im Tab „Entdecken“ auf „Aktualisieren“). |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen (beim Hinzufügen eines Geräts festgelegt), der Zustände und der Szenenergebnisse. |
So installierst du Activepieces in Gladys
- Öffne in Gladys Integrationen: Activepieces erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-activepieces:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-activepieces.
Activepieces benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Activepieces ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation