ZapierにおけるMinds: プライベート統合とクリエイティブドラフト

MindsのZapierアプリは、自動化ワークフローをMindsのAudienceおよびStudyとシームレスに接続します。Mindsは定性・定量調査を単一の統合プラットフォームで完結させる商用シンセティックリサーチの包括的プラットフォームです。現在本アプリはプライベート版であり、Zapier App Directoryでの一般公開は行われていません。クリエイティブ拡張機能は、統合の重複作成を避け、既存のMinds登録を再利用しています。

登録状況、バージョン、リリースステータス

2026-10-01時点のステータス確認。既存の統合ID 246865が登録済みMindsアプリとして維持されています。バージョン1.0.0はプライベート公開でZap利用者は1名、プライベート1.2.0ではReview URLの出力とGet Completed Research Resultsが追加されています。実際のホステッド環境における1.2.0の実行では、プライベートQA Studyを作成し、レビューリンク付きドラフトを保存し、確認前には結果が返されない動作が確認されました。これはホステッドランタイム環境での動作エビデンスであり、Zapエディターへの正式採用や公開ディレクトリ承認を保証するものではありません。既存ユーザーの自動移行は行われていません。

バージョン1.2.0の検証では27項目のチェックに合格し、公開に関する警告は発生しませんでした。全般的なD004警告は、個別のドラフト一覧エンドポイントではなくPreview Research PlanからマッピングされたDraft Plan IDに起因するものです。一般公開申請ではS001が報告されており、これにはアクティブなZapを持つ実ユーザーが最低3名必要ですが、現在の登録数は1名です。これは実利用に関する要件です。公開チェックを通過させるためにアカウントやイベントを偽装せず、実際のテスター向けに有用なZapを構築してください。

プッシュや検証の成功はプロバイダーによる承認を意味しません。プライベート配布、バージョン移行、プロモーション、公開ディレクトリ審査はそれぞれ独立したプロセスです。

前提条件とセキュアな接続

プライベートアプリへのアクセス権限を持つZapierアカウント、Mindsアカウント、およびサポートされているAPIキー設定から発行されたMinds APIキーが必要です。リサーチをプレビューする前に、対象のAudienceを設定した既存のStudyを作成してください。キーが意図したアカウントおよびワークスペースに紐づいていることを確認します。

APIキーはZapier標準のMinds接続フォームにのみ入力してください。リサーチリクエスト、アセットURL、Zapタイトル、ガイド、スクリーンショット等に記載してはいけません。ZapierはAPIキー認証を使用しますが、Canva、Figma、AdobeパネルはOAuthゲートウェイを使用しており、これらは異なる接続メカニズムです。

アプリ所有者がZapier経由でテスターアクセスを提供します。プライベート招待リンクは公開ドキュメントに記載しないでください。クリエイティブ拡張機能のフィールドをマッピングする前に、エディターに表示されているバージョンを確認してください。

既存のオペレーション

New Studyは最新100件のStudyをポーリングし、Zapierの重複排除にStudy IDを使用します。Audienceリストは既存の調査対象母集団を提供します。Create Studyはリサーチコンテナを作成するものであり、回答者リサーチを即座に実行するわけではありません。Find Studyは既存のStudyを検索します。

Preview Research Planは保存済みのリサーチドラフトを作成します。Get Study Summaryは既存のStudyから生成された要約を読み取ります。下流工程に結果を渡す前に、返されたステータスを確認してください。作成やプレビューの成功はリサーチの完了を意味せず、要約が存在しないことは調査結果ではありません。

クリエイティブレビューZapの構築

承認済み素材のソーストリガーを選択し、プライベート版MindsのPreview Research Planステップを追加します。既存のStudyを選択し、具体的なResearch RequestとStudy Languageをマッピングします。たとえば「このキャンペーンメッセージ内のどの主張について、StudyのAudience向けに補足説明が必要か？」といった質問を設定します。

拡張機能ではMaterial to Reviewにテキストを直接指定するか、読み取り可能なHTTPSのMaterial URLを指定するかのいずれか一方のみを受け付けます（両方の同時指定は不可）。URLを使用する場合は、Material Typeとしてimage、video、document/PDF、webpageのいずれかを選択します。レビュー担当者が対象アセットを識別できるよう、簡潔なMaterial Labelを追加してください。

ログインが必要なリンク、読み取り不可能なリソース、認証情報が埋め込まれたURLは使用できません。Zapを動作させるために機密素材のアクセス保護を解除しないでください。アカウント管理ポリシーに従い、アクセスが許可された読み取り可能リソースまたはサポート対象の自社ソースパスを使用してください。Mindsはプレビュー準備中にソースをインポートします。URL文字列が保存されたこと自体はインポートの成功を証明するものではありません。

ドラフトのソース、調査目的、言語、設問を確認してください。不要な個人識別情報をリクエストに含めず、転送が許可されている素材のみを使用してください。

リトライ識別子

Preview Request Identifierは、ソースイベントに由来する任意の安定した識別子です。同一のStudy、リクエスト、素材に対するリトライには同じ識別子を再利用します。これらの入力が変更された場合は識別子も変更してください。アダプターは英数字、アンダースコア、ハイフンで構成される最大128文字まで受け付けます。

明示的な識別子がない場合、独立したZapのリトライが同一ドラフトを指しているとみなしてはなりません。ソースイベントの識別性とリサーチ結果は区別して管理してください。上流のトリガーがイベントを再実行する際は、既存のプレビューをリトライすべきか、新規にプレビューを作成すべきかを判断してください。

確認、実行、要約

リサーチを明示的に確定する前に、Mindsで保存された正確なドラフトを開き、素材、設問、Audience、想定クレジット消費量を確認してください。結果として取得するのは、そのドラフトの完了済み実行によるデータのみに限定してください。プロバイダー登録と公開マーケットプレイスの承認は独立したゲートです。

Preview Research Planの出力であるStudy IDとDraft Plan IDをGet Completed Research Resultsにマッピングします。独自に設定したワークフロー経由で担当レビュアーにReview URLを共有し、レビュアーがMinds上でリサーチを確認・完了するのを待ってから検索をテストします。この検索は実行が完了するまでアイテムを返しません。これに合わせてZapのリトライや後続スケジュールを設定してください。このステップがリサーチを開始したり、人間の判断を待つ間に実行状態を維持したりすることはありません。完了した成果物と集計データのみを下流に渡してください。

Get Study Summaryは、既存のStudy全体の集計要約を取得するための独立した操作です。ドラフト固有の結果の代わりにこれを使用しないでください。過去のリサーチ結果が返されるリスクがあります。下流への書き込みを有効化する前に、完了済みドラフトと未実行ドラフトの両方で新しい検索をテストしてください。

保存された計画のレビュー、確認、実行

保存済みドラフトのワークフローにより、Minds上で正確なリサーチ計画が開かれます。ゲートウェイおよびプライベートZapier 1.2.0パッケージは、そのドラフトに紐づく完了済みインサイトを返します。レビューと実行はMinds内で行われます。公開マーケットプレイスでの提供可否は各プロバイダーの登録と承認状況に依存します。次の手順に従ってください。

1. パネルからMindsのStudyを開くか、Zapierから返されたReview URLを開きます。ドラフトを作成したアカウントでサインインしてください。
2. インポートされたソース、調査目的、言語、各設問、選択されたAudienceを確認します。素材と母集団が意思決定の目的に合致しているかを検証してください。
3. 不足している入力項目や確認用の設問に回答し、修正した計画を保存します。更新された設問を再度確認してください。確定処理はその修正版に対して適用されます。
4. 利用可能なレスポンス枠と、算出可能な手法における推定使用量を確認します。実行中に追加の設問を生成する手法では、不正確な固定合計値は表示されません。未設定のAudience、空の母集団、アカウントの上限エラーがあれば、確定前に解決してください。
5. リサーチの明示的な確認チェックボックスをオンにします。高度な手法を使用する計画の場合は、個別のオプトインを確認して同意します。「Confirm and run」を1回クリックします。リンクを開く、素材をインポートする、計画をプレビューするだけの段階ではリサーチは実行されません。
6. 実行ステータス（queued、running、completed、failed）を確認します。同じドラフトを再読み込みすると、新規実行を作成するのではなく確認済みの実行が再開されます。確定前の再読み込みには再度の同意が必要です。エラーが発生した場合でも保存済みドラフトは保持され、確認と再試行が可能です。
7. 元のパネルに戻って「Load findings」を選択するか、ZapierのGet Completed Research Results検索を保存済みのStudy IDおよびDraft Plan IDとともに使用します。このドラフトの確認済み実行から得られた完了結果のみが返されます。未完了、失敗、存在しない実行が過去のStudy要約にフォールバックすることはありません。

リサーチの実行中は元のパネルを開いたままにしてください。短時間の接続情報とドラフト選択状態はメモリ上に保持されます。ホストパネルの再読み込みや再接続を行うと、素材の再選択やドラフトの再作成が必要になる場合があります。パネルセッションが終了しても、保存されたドラフトと確認済みの実行はMinds内に保持されます。保持された結果を確認するには、MindsのStudyに戻ってください。

プライベートテストと実行タイミング

ワークフローで使用する実際のトリガー、アクション、検索をテストしてください。無効な認証、Studyへのアクセス権不足、読み取り不能なソース、不正なタイプ、重複イベント、要約の欠落などのケースを網羅します。テスト素材は匿名化を保ち、チケットにプライベートステップのペイロードを直接コピーしないようにしてください。

Zapierはポーリング、アクション、検索の各ステップに実行時間制限を適用します。無作為にプランニングを再実行するのではなく、制限付きリクエストを使用し、タイムアウトの原因を検証してください。プライベート移行はアプリ所有者と連携して進めてください（新しいパッケージをプッシュしても全ユーザーが自動移行されるわけではありません）。未使用のキーは標準のアカウント管理画面から失効させ、保持素材はMinds privacy policyに基づいて管理してください。

トラブルシューティング

公開ゲートと関連ガイド

ディレクトリへの申請前に、実ユーザーによるプライベート検証、サポートされているプレビューから実行までの処理、レビュアーアクセス、公開チェックを完了させてください。昇格対象となる正確なバージョンでチェックを再実行してください（過去のパッケージでの結果は後継バージョンの承認を意味しません）。プライベート統合を公開版と偽ったり、ゲートを通過するために架空の利用実績を作成したりしないでください。

Zapier integration checksおよびpublishing requirementsを参照してください。Canva、Figma Creative Review、Adobe Express、GenStudio、integration directoryの各ガイドもあわせてご確認ください。