Integrationen und API
Tabs
Alles, was der Tracker zeigt, ist auch für andere Systeme verfügbar. Webhooks werden ausgelöst, wenn Abläufe sich bewegen. Die REST-API liest Abläufe und bearbeitet Aufgaben, und der MCP-Server stellt dasselbe für KI-Assistenten bereit.
Webhooks
Fügen Sie einen Webhook mit dem Ereignis Workflow unter API und Webhooks hinzu. Er empfängt jeden Workflow des Teams oder nur die Workflows, die ein bestimmtes Formular verwenden, wenn Sie eines auswählen. Jeder Aufruf enthält den Ereignisnamen, den Ablauf und, falls vorhanden, die Aufgabe und deren Einreichungs-ID:
| Ereignis | Wann |
|---|---|
workflow.run.started |
Das Startformular wurde eingereicht. |
workflow.run.restarted |
Ein abgelehnter Ablauf wurde erneut über die Erneut starten-Schaltfläche gestartet. |
workflow.task.created |
Ein Schritt wurde jemandem zugewiesen. |
workflow.task.completed |
Ein Formularschritt wurde eingereicht. |
workflow.task.decided |
Eine Genehmigung wurde entschieden. Die Nutzlast enthält das Ergebnis und den Kommentar. |
workflow.run.completed |
Jeder Pfad wurde abgeschlossen. |
workflow.run.rejected |
Eine Rücksendung beendete den Ablauf. |
workflow.run.cancelled |
Jemand hat den Ablauf im Tracker oder über die API abgebrochen. |
Formularspezifische Webhooks auf den einzelnen Formularen werden weiterhin für ihre Einreichungen ausgelöst.
REST API
Die API v4 bietet Lese- und Schreibzugriff auf Abläufe und Aufgaben. Alle Routen befinden sich unter /api/v4/:
| Methode und Route | Was sie tut |
|---|---|
GET workflow/<workflow>/definition/ |
Die Schritte und Verbindungen eines Workflows, nur lesbar. |
GET workflow/<workflow>/runs/ |
Die Abläufe des Workflows, filterbar nach Status, Zuständiger und überfällig, mit Seitenangabe. |
GET workflow/run/<run>/ |
Ein Ablauf mit seinen Aufgaben und seinem Zeitverlauf. |
GET workflow/run/<run>/final-pdf/ |
Ein zeitlich begrenzter Link zum abgeschlossenen PDF, mit der Genehmigungsaufzeichnungsseite, falls vorhanden. |
POST workflow/run/<run>/cancel/ |
Einen Ablauf abbrechen, mit optionalem Grund. |
GET workflow/tasks/ |
Aufgaben über Workflows hinweg, filterbar nach E-Mail des Zuständigen und Status, für Inbox-ähnliche Clients. |
POST workflow/task/<task>/decide/ |
Eine Genehmigungsaufgabe entscheiden: das Ergebnis und ein Kommentar. |
POST workflow/task/<task>/nudge/ |
Die E-Mail der Aufgabe erneut senden. |
POST workflow/task/<task>/reassign/ |
Die Aufgabe an eine E-Mail-Adresse oder ein Teammitglied übergeben. |
Die älteren Routen zum Einreichen eines Workflow-Schritts und zum Auflisten der Einreichungen eines Workflows nach Schritt bleiben unverändert.
MCP-Tools
Der PlatoForms MCP-Server bietet KI-Assistenten dieselbe Ansicht: list_workflow_runs (nach Workflow, Status oder überfällig), get_workflow_run, list_my_workflow_tasks, decide_workflow_task und nudge_workflow_task. Um eine Aufgabe zu entscheiden, muss der verbundene Benutzer einer der Zuständigen oder ein Teambesitzer sein, sodass ein Assistent in Ihrem Namen, aber nicht im Namen eines anderen genehmigen kann.