workflows-list

Zapier ワークフロー一覧

パブリック SDK の CLI 実験的コマンドサーフェスを使用してください。zapier-sdk-code-substrate は使用しないでください。

互換性チェック

このスキルを使用する前に、workflows-doctor バンドルの互換性チェックを実行してください。workflows-doctor がインストールされていない、または読み込めない場合は、続行する前に workflows-install を実行するか、zapier/agent-skills から workflows-doctor をインストールしてください。workflows-doctor が SDK／スキルの不整合を報告した場合は、その更新手順に従い、このスキルの呼び出しを停止してください。必要に応じてエージェントのワークスペースを再読み込みし、元のリクエストを再実行するようユーザーに依頼してください。

前提条件の確認

zapier-sdk --version
zapier-sdk get-profile --json
zapier-sdk --stability experimental --help

認証に失敗した場合は、対話型ターミナルで zapier-sdk login を実行してから再試行するようユーザーに依頼してください。

ワークフローの一覧表示

zapier-sdk --stability experimental list-workflows --json

JSON 出力を解析し、ユーザーの依頼に合わせて整形してください。よく使われる有用なフィールドには、id、name、enabled、is_private、created_by_user_id、created_at、updated_at、description、current_version、および存在する場合はトリガー関連のメタデータなどがあります。

id を持つ各ワークフローについて、Zapier エディターへのリンクを含めてください。

https://zapier.com/workflow/<workflow-id>

trigger_url はアカウントに依存する情報として扱ってください。この URL を呼び出すと、認証済みアカウントとしてワークフローが実行されます。そのため、URL 内のトークンは単独で認証情報として機能しなくなっていますが、必要もないのに表示するものではありません。ユーザーが明示的に求めない限り、trigger_url を表示しないでください。

トリガーの種類にかかわらず、triggers[] の各エントリーについて details.webhook_url を確認してください。これが存在するだけで、キャッチ URL があることがわかります。trigger_url とは異なり、webhook_url は共有を前提とした URL です。ユーザーが外部サービスに貼り付ける URL なので、存在する場合はそのまま提示してください。ほとんどのトリガーには webhook_url がありませんが、それが通常です。ユーザーが特に期待している場合（たとえば「Webhooks by Zapier」に言及している場合）を除き、存在しないことを問題として指摘しないでください。その場合、インストール済み SDK がこのフィールドより前のバージョンである可能性があります。

下書きを開く

ワークフローの公開状態がすべてではありません。サーバー上に未公開の下書きが残っている場合があり、開いている下書きには必ず未公開の作業が含まれます（公開すると下書きは消費されます）。ユーザーが未公開の変更や進行中の作業について尋ねた場合、またはエディターの表示が公開中の内容と異なる理由を尋ねた場合は、次を確認してください。

zapier-sdk --stability experimental list-workflow-drafts <workflow-id> --json

各オープン状態の下書きについて、slug、last_edited_at、last_edited_by_user_id と、base_version_id が最新の公開バージョンと一致するかどうかを提示してください。基準となるバージョンが古い場合、その下書きは現在公開中のバージョンより前のものです。下書きのエディターリンクも含めてください。https://zapier.com/workflow/<workflow-id>/draft/<draft-slug>/workflow.ts — 最後のセグメントは、その下書きの source_files キーの 1 つです（このバンドルのフローでは workflow.ts）。通常の一覧表示で、すべてのワークフローの下書きを取得しないでください。ワークフローごとに 1 回のリクエストが必要なので、ユーザーから依頼された場合、または話題になっているワークフローに限って取得してください。

所有者の絞り込み

list-workflows は、チームのワークフローを含め、認証済みユーザーが閲覧できるすべてのワークフローを返す場合があります。ユーザーが「自分のワークフロー」を求めた場合は、誤った ID で勝手に絞り込まず、まず該当する可能性が高いワークフローを示し、不確かな点を説明してください。

既知の注意点：zapier-sdk get-profile が返す UUID は、list-workflows[].created_by_user_id と一致しない場合があります。後者は別の数値ユーザー ID である可能性があります。これらの ID を確実に対応付けられない場合は、その旨を伝え、ユーザーが選べるよう十分な情報を添えて絞り込みなしの一覧を提示してください。

最終実行時刻

ユーザーが最近のアクティビティを尋ねた場合は、関連する各ワークフローの実行履歴を取得してください。

zapier-sdk --stability experimental list-workflow-runs <workflow-id> --json

最も最近の実行を使用してください。大規模なアカウントでは、API の呼び出し量に注意してください。