Zum Hauptinhalt springen

iPaaS-Middleware (Zapier, Make, n8n, Power Automate, Workato)

No-Code-Integrationsplattformen (iPaaS) verbinden FoxPlan ohne Entwicklung mit Ihren anderen Werkzeugen (ERP, CRM, Ticketing, Messaging, Tabellen…). FoxPlan liefert fünf Konnektoren standardmäßig, auf jeder Instanz: Sie erscheinen unter Einstellungen → Konnektoren für Ihre Arbeitsbereichs- oder Unternehmensadministratoren, ohne vorherige Freischaltung.

KonnektorAnbieterIm Tool zu verwendender Webhook-Auslöser
ZapierZapierWebhooks by Zapier › Catch Hook
MakeCelonis (Make.com)Modul Webhooks › Custom webhook
n8nn8nKnoten Webhook (Methode POST, Produktions-URL)
Microsoft Power AutomateMicrosoftAuslöser Wenn eine HTTP-Anforderung empfangen wird
WorkatoWorkatoAuslöser Webhooks › New event via webhook

Alle fünf Konnektoren arbeiten genau gleich, in beide Richtungen:

RichtungMechanismusWo konfigurieren
FoxPlan → Middleware (ausgehend)FoxPlan sendet ein strukturiertes JSON-Ereignis an die Webhook-URL Ihres SzenariosRegisterkarte Konfiguration der Konnektorseite, dann Flows
Middleware → FoxPlan (eingehend)Das Szenario ruft die FoxPlan-REST-API mit einem API-Konto aufRegisterkarte API der Konnektorseite

Einrichtung, Konnektor für Konnektor​

Das Vorgehen ist immer gleich: Webhook-Auslöser im Tool anlegen, seine URL in FoxPlan einfügen, testen, dann die Flows aktivieren.

Zapier​

  1. Erstellen Sie einen Zap mit dem Auslöser Webhooks by Zapier › Catch Hook. Zapier zeigt eine URL der Form https://hooks.zapier.com/hooks/catch/….
  2. Öffnen Sie in FoxPlan Einstellungen → Konnektoren → Zapier, fügen Sie die URL in Zapier-Webhook-URL ein, setzen Sie optional ein gemeinsames Token und speichern Sie.
  3. Klicken Sie auf Testen: Zapier erhält ein Ereignis connection.test und bietet es als Beispiel an („Find new records“).
  4. Registerkarte Flows: aktivieren Sie Aufgabenereignisse und/oder Aufgabenkommentare.
  5. Setzen Sie Ihren Zap mit beliebigen Aktionen fort; um auf FoxPlan zu wirken, verwenden Sie Webhooks by Zapier › Custom Request gegen die REST-API (siehe unten).

Make​

  1. Fügen Sie in einem Szenario das Modul Webhooks › Custom webhook hinzu, legen Sie einen Webhook an und kopieren Sie seine Adresse (https://hook.eu1.make.com/…).
  2. Öffnen Sie in FoxPlan die Seite Make, fügen Sie die URL ein, speichern Sie und klicken Sie auf Testen: Make erkennt die Datenstruktur automatisch.
  3. Aktivieren Sie die gewünschten Flows in der Registerkarte Flows.
  4. Um in FoxPlan zu schreiben, fügen Sie ein Modul HTTP › Make a request mit dem Header Authorization: Bearer … hinzu (siehe API-Abschnitt).

n8n​

  1. Fügen Sie in einem Workflow einen Knoten Webhook hinzu, Methode POST, und kopieren Sie die Produktions-URL.
  2. In FoxPlan, Seite n8n: URL einfügen, speichern, dann Testen, während der Knoten lauscht („Listen for test event“), um ein Beispiel zu erhalten.
  3. Aktivieren Sie die Flows in der Registerkarte Flows.
  4. Um FoxPlan aufzurufen, verwenden Sie einen Knoten HTTP Request mit einer Header Auth-Anmeldung (Authorization / Bearer …).

Microsoft Power Automate​

  1. Erstellen Sie einen Flow mit dem Auslöser Wenn eine HTTP-Anforderung empfangen wird. Die URL erscheint erst nach dem ersten Speichern des Flows.
  2. Fügen Sie das JSON-Beispiel unten in „Beispielnutzlast zum Generieren des Schemas verwenden“ ein, um die Felder in den nächsten Schritten nutzen zu können.
  3. In FoxPlan, Seite Microsoft Power Automate: URL einfügen, speichern, Testen, dann die Flows aktivieren.
  4. Um auf FoxPlan zu wirken, fügen Sie eine Aktion HTTP mit dem Header Authorization hinzu.
Power-Automate-Lizenz

HTTP-Auslöser und HTTP-Aktion sind bei Microsoft Premium-Konnektoren.

Workato​

  1. Wählen Sie in einem Rezept den Auslöser Webhooks › New event via webhook und kopieren Sie die Webhook-URL.
  2. In FoxPlan, Seite Workato: URL einfügen, speichern, Testen, dann die Flows aktivieren.
  3. Um in FoxPlan zu schreiben, verwenden Sie den HTTP-Konnektor von Workato mit Header-Authentifizierung (Authorization: Bearer …).

Ausgehend: das JSON-Ereignis​

Die Schaltfläche Testen sendet sofort ein Ereignis connection.test. Die Flows Aufgabenereignisse (task.status-changed, task.owner-changed, task.planning-assignment-changed) und Aufgabenkommentare (task.comment-added) senden danach bei jedem Ereignis ein JSON der Form:

{
  "schemaVersion": "1",
  "source": "foxplan",
  "event": "task.status-changed",
  "occurredAt": "2026-09-08T16:05:12.345Z",
  "environmentId": "…",
  "actor": { "id": "…", "name": "Jane Doe", "email": "jane@beispiel.de" },
  "project": { "id": "…", "name": "Projekt Alpha", "code": "ALP" },
  "task": { "id": "…", "projectId": "…", "name": "…", "status": "…", "owner": "…", "priority": 1, "startDate": "…", "endDate": "…", "percentComplete": 40, "description": "…", "lastModifiedDate": "…" },
  "previous": { "…": "Zustand der Aufgabe vor der Änderung" },
  "comment": { "author": "…", "text": "…" }
}

Zwei HTTP-Header begleiten jeden Aufruf: X-Foxplan-Event (Ereignistyp) und, wenn in der Konfiguration ein gemeinsames Token gesetzt ist, X-Foxplan-Token. Prüfen Sie dieses Token in Ihrem Szenario, um nur Aufrufe von FoxPlan zu akzeptieren.

Kopplung mit den Projektbenachrichtigungen

Wie bei den Chat-Konnektoren werden diese Flows nur ausgelöst, wenn die entsprechenden Benachrichtigungsoptionen des Projekts in der Projektdefinition aktiviert sind.

Eingehend: die FoxPlan-API aus dem Szenario aufrufen​

Die Registerkarte API jeder Konnektorseite listet die für ein Automatisierungsszenario empfohlenen REST-API-Operationen, nach Bereich gruppiert (Authentifizierung, Projekte, Aufgaben, Kommentare, Ressourcen, Portfolios): Aufgaben auflisten oder anlegen, Status ändern, kommentieren, Projekt lesen, Zuweisung erstellen… Sie zeigt die zu verwendende Basis-URL und verlinkt auf die vollständige Swagger-Dokumentation.

Authentifizierung in drei Schritten:

  1. Erstellen Sie ein API-Konto unter Einstellungen → Arbeitsbereich → Registerkarte API und weisen Sie ihm eine Rolle zu (z. B. Arbeitsbereichsmanager).
  2. Rufen Sie POST /api/auth mit Basic-Authentifizierung auf (Auth ID:Auth Token, base64-kodiert): die Antwort enthält ein id_token.
  3. Senden Sie bei jedem Aufruf den Header Authorization: Bearer <id_token>.

Das detaillierte Vorgehen steht im Leitfaden zur API-Nutzung.

Die OpenAPI-Spezifikation ins Tool importieren​

Die Registerkarte API bietet auch das OpenAPI-Dokument (3.x) zum Herunterladen: Es entspricht genau dem Umfang der angezeigten Liste, verwendet die Adresse Ihrer Instanz als Server und lässt die internen Dienste von FoxPlan weg. Make (Custom apps › Import OpenAPI), Zapier (Platform UI › Import an OpenAPI spec) und Workato (Connector SDK › Import OpenAPI) machen daraus in wenigen Klicks einen eigenen Konnektor. n8n importiert kein OpenAPI: Die Datei dient als Referenz für HTTP-Request-Knoten. Power Automate akzeptiert derzeit nur Version 2.0: Die Datei wird in 3.x geliefert und ist bis zur Unterstützung zu konvertieren.

Trennung je Instanz​

Eine Middleware kann nur auf die Instanz (den Mandanten) wirken, an die sie angebunden ist — in beide Richtungen:

  • Ausgehend: Der Konnektor ist auf einem Arbeitsbereich installiert; er erhält nur die Ereignisse dieses Arbeitsbereichs, und der Kontext der sendenden Instanz bleibt bis zum Versand des Webhooks erhalten.
  • Eingehend: Das API-Konto gehört zu einem Unternehmen; das erhaltene Token trägt dieses Unternehmen, und allein dieses bestimmt die erreichbaren Daten. Ein im Szenario gefälschter Header kann es nicht wechseln, und die Rechte des Kontos (Projektrollen) gelten wie für jeden Benutzer.