アプリを接続、管理、再接続する

Runner のアプリ接続状態を理解し、認可を安全に修復または接続を削除します。

このガイドを使用して、1 つのアプリをその接続ライフサイクル全体で実行します。接続を開始し、その実際の状態を確認し、必要に応じて認可を修復し、安全に切断します。

エントリパス: プロジェクト → アプリ

開始する前に

以下の場合に使用します:

アプリが接続、接続中...、再接続、またはレビュー待ちと表示されている;
前のプロバイダーフローが本当に完了したかどうかを確認する必要がある;
エージェントアプリが異なるツールアクセスを必要とする; または
接続を削除する予定があり、最初に警告を理解する必要がある。

プロジェクトへのアクセスと、外部プロバイダーが要求するアカウント、認証情報、または承認が必要です。一部のアプリは条件付きであり、すべてのワークスペースに表示されない場合があります。

行動する前にカードを読む

カード状態またはコントロール	意味	何をするか
読み込みインジケーター	Runner は保存された接続をチェックしています。	別のアクションを選択する前に待ちます。
接続	Runner はこのアプリに使用可能な接続がありません。	セットアップダイアログまたはプロバイダー認可フローを開きます。
接続中...	接続リクエストが進行中です。	プロバイダーフローを完了するか、Runner が結果を返すのを待ちます。
接続済み	Runner は使用可能な接続を認識しています。	変更が必要な場合は、その管理または切断コントロールを使用します。
管理	接続されたエージェントアプリには設定可能なツールがあります。	アプリの詳細を開き、ツールアクセスを確認します。
再接続	認可が不足しているか、期限切れであるか、その他の注意が必要です。	認可を再度開始します。古い接続がまだ機能していると仮定しないでください。
レビュー待ち	Stripe はアカウントを持っていますが、準備ができていません。	ステータスまたはアクション通知に従います。ラベルは接続ボタンではありません。
オンボーディングを続行	Stripe はまだ情報が必要です。	別のアカウントを作成する代わりに、既存のセットアップを続行します。
削除または切断	接続を削除できます。	プロバイダー固有の影響を読んで確認します。

ライフサイクルを完了する

アプリを開き、アプリを見つけます。
接続を選択します。
ダイアログに表示されているフィールドのみを入力します。アプリによっては、これはショップドメイン、 API キー、キーとシークレット、プロバイダー認証情報、または外部認可である可能性があります。
プロバイダーステップを完了してから、アプリに戻ります。
カードが接続されたバッジまたはプロバイダーの接続されたコントロールを表示していることを確認します。閉じたダイアログまたはプロバイダーウィンドウは成功の証拠ではありません。
カードが再接続またはオンボーディングを続行を表示する場合は、そのアクションを選択して既存の接続を続行します。
アプリを削除するには、その切断コントロールを選択し、確認を読み、記載されているワークスペース全体の影響が許容可能な場合のみ切断または確認を選択します。
アプリを再度開き、カードが切断された状態に戻ったことを確認します。

ストアアプリとエージェントアプリは異なります

ストアアプリはプロバイダー固有のコントロールを使用します:

メールはオン/オフスイッチを使用します。
Stripeはオンボーディング、レビュー、アクション必須、ダッシュボード、および切断コントロールを表示できます。
Shippo、CJ Dropshipping、4PX、およびShopifyはプロバイダー固有のセットアップデータを要求し、破壊的な切断確認を表示します。

接続の安全性

プロバイダーキーとシークレットをパスワードのように扱います。
接続がワークスペースに属するか、現在のプロジェクトのみに属するかを読みます。
プロバイダーウィンドウの完了は、Runner が使用可能な結果を受け取ったことを保証しません。
アクティブなストア操作中に、配送、支払い、メール、またはフルフィルメントプロバイダーを切断しないでください。警告と現在の注文を確認してください。
切断に失敗した場合、Runner は現在の状態を保持します。プロバイダーが削除されたと仮定しないでください。