これは何で、何に使うものですか
n8n、Make、またはZapierを使用して、PaperOffice AIを他のシステムに接続します。これらのツールの標準的なビルディングブロックであるREST APIへのHTTPリクエストとWebhookを使用します。n8nは、そのMCPクライアントを使ってPaperOffice MCPサーバーにも接続できます。ワークフローエージェントにおけるWebhookターゲットは、Professionalプランからのみ利用可能です。
仕組み
- APIキーページでキーを作成します。これをHTTPノードにBearerトークンとして入力します。
- REST APIを呼び出して、例えばファイルのアップロードや検索を行います。エンドポイントについてはAPI ドキュメントをご覧ください。
- 結果を受け取るには、Workflow AI → Workflow Agentsを開き、保存されたエージェントを編集してWebhooksタブを選択します。
- Webhookターゲットを追加をクリックします。ターゲット URLとしてn8n、Make、またはZapierのWebhookアドレスを入力します。
- 送信タイミングで、実行完了、実行失敗、またはその両方を選択します。
- 人間の確認が必要な場合、フローは確認タスクを作成しWebhookを待機します。task.completedイベントは、Workflow AI → Human In The Loop Tasksからの判断を報告します。
豆知識
- 各成功したWebhook配信には課金されます。リトライ、テストイベント、および失敗した配信は無料です。
- API呼び出しには課金されます。
- {trigger.pofid}のようなプレースホルダーは、パス、クエリ、ヘッダーでは許可されますが、ホスト名では許可されません。
- PaperOfficeからのWebhookはX-PaperOffice-Signatureヘッダーで署名されます。フロー内でこれを確認してください。
- MakeとZapierには、それぞれのHTTPおよびWebhookモジュールを使用します。