Zapierでdosyaの新規ファイルトリガーを使う

New Fileは指定必須のワークスペースについて、1つのZapのWebhookをfile.uploadedイベントに登録します。新規ファイルレコードのみを返し、既存ファイルの新しいバージョンを作るアップロードは意図的に無視します。

手順

1. https://app.dosya.dev/profile/apiでfullのdosya APIキーを作成してください。RESTはフォルダーに制限されたキーを拒否するため、フォルダー制限を設定しないでください。アクセス範囲を狭める必要がある場合はキーを1つのワークスペースに限定してください。
2. ZapierでdosyaのNew Fileトリガーを追加し、そのキーを接続してください。接続テストは現在のユーザーエンドポイントを呼び出し、Zapを有効にする前にfull以外の権限を拒否します。
3. Workspaceを選択してください。登録時にこのZapとイベント用のWebhookエンドポイントが1つ作成され、ZapierがIDを提供した場合はZapier (Zap <id>)と命名されます。
4. 選択したワークスペースに新しい機密でないファイルを1つアップロードしてください。is_new_version: trueの配信はトリガー項目を返さないため、このテストで既存ファイルを上書きしないでください。
5. Zapierのトリガーテストでサンプルを読み込んでください。サンプル取得はワークスペースのルートを一覧し、次に最近の行を約25件見つけるまで最大12フォルダーを調べます。非常に大きいワークスペースは意図的にすべて走査されません。
6. File ID、File name、Size in bytes、Folder ID、Versionを確認してからZapを公開してください。Zapierが保存済みWebhookエンドポイントを削除できるよう、停止するときは通常の手順でオフにしてください。

登録解除でCannot unsubscribe: no dosya webhook endpoint id was stored for this Zapと表示された場合、アプリは後処理が成功したふりをしません。Webhookの上限に対してエンドポイントが残らないよう、古い接続の問題を解決してください。

期待される結果

選択したワークスペースに新しく作成されたファイル1件から、idとfile_idが安定したファイルIDであるトリガー項目が1件生成されます。新しいバージョンは無視され、同じイベントの再配信には同じidが使用されるためZapierで重複排除できます。

関連ガイド

• Zapierを接続する
• n8nを接続する