PlatoForms User Guide
統合とAPI
タブ
トラッカーが表示するすべての情報は他のシステムでも利用可能です。実行が進むとWebhookが発火し、REST APIは実行を読みタスクに作用します。MCPサーバーはAIアシスタントに同じ情報を公開します。
Webhooks
APIとWebhooksの下でイベントワークフローを使用してWebhookを追加します。チームのすべてのワークフロー、または特定のフォームを使用するワークフローのみを受け取ります。各呼び出しにはイベント名、実行、そして存在する場合はタスクとその提出IDが含まれます。
| イベント | 発生時 |
|---|---|
workflow.run.started |
開始フォームが提出されました。 |
workflow.run.restarted |
拒否された実行が再開ボタンから再開されました。 |
workflow.task.created |
ステップが誰かに割り当てられました。 |
workflow.task.completed |
フォームステップが提出されました。 |
workflow.task.decided |
承認が決定されました。ペイロードには結果とコメントが含まれます。 |
workflow.run.completed |
すべてのパスが完了しました。 |
workflow.run.rejected |
送り返しで実行が終了しました。 |
workflow.run.cancelled |
トラッカーまたはAPIを通じて誰かが実行をキャンセルしました。 |
個々のフォームのフォームレベルのWebhookは、提出に対して引き続き発火します。
REST API
API v4は実行とタスクへの読み書きアクセスを持っています。すべてのルートは/api/v4/の下にあります。
| メソッドとルート | その機能 |
|---|---|
GET workflow/<workflow>/definition/ |
ワークフローのステップと接続、読み取り専用。 |
GET workflow/<workflow>/runs/ |
ワークフローの実行、ステータス、担当者、期限切れでフィルタリング可能、ページング。 |
GET workflow/run/<run>/ |
1つの実行とそのタスクおよびタイムライン。 |
GET workflow/run/<run>/final-pdf/ |
完了したPDFへの時間制限付きリンク、承認記録ページがある場合。 |
POST workflow/run/<run>/cancel/ |
実行をキャンセル、オプションで理由を追加。 |
GET workflow/tasks/ |
ワークフロー全体のタスク、担当者のメールとステータスでフィルタリング可能、受信箱スタイルのクライアント向け。 |
POST workflow/task/<task>/decide/ |
承認タスクを決定：結果とコメント。 |
POST workflow/task/<task>/nudge/ |
タスクのメールを再送信。 |
POST workflow/task/<task>/reassign/ |
タスクをメールアドレスまたはチームメンバーに引き渡す。 |
ワークフローステップの提出とステップごとのワークフローの提出リストのための古いルートは変更されていません。
MCPツール
PlatoForms MCPサーバーはAIアシスタントに同じビューを提供します。list_workflow_runs（ワークフロー、ステータスまたは期限切れで）、get_workflow_run、list_my_workflow_tasks、decide_workflow_task、nudge_workflow_task。タスクを決定するには、接続されたユーザーがその担当者の1人またはチームオーナーである必要があります。そのため、アシスタントはあなたの代わりに承認できますが、他の人の代わりにはできません。