翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Salesforce との統合
<a name="salesforce-integration"></a>

Amazon Quick の Salesforce アクションコネクタを使用すると、レコードの管理、データのクエリ、Salesforce APIs とのやり取りなど、Salesforce 組織内でアクションを実行できます。Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

**注記**  
Salesforce Spring '26 リリース (2026 年 2 月) の時点で、すべての Salesforce 組織で新しい接続アプリケーションの作成はデフォルトで無効になっています。このガイドでは、Amazon Quick Salesforce コネクタと完全に互換性がある Salesforce の外部クライアントアプリケーション (ECAs) を使用します。

## 前提条件
<a name="salesforce-integration-prerequisites"></a>

Salesforce 統合を設定する前に、以下があることを確認してください。
+ システム管理者アクセス権を持つ Salesforce 組織。
+ Amazon Quick Author ロール以上。
+ Amazon Quick インスタンス URL ( など`https://us-east-1.quicksight.aws.amazon.com`)。

## ステップ 1: Salesforce で外部クライアントアプリを作成する
<a name="salesforce-eca-setup"></a>

Salesforce で外部クライアントアプリ (ECA) を作成して、Amazon Quick による OAuth 認証を有効にします。

### External Client App Manager に移動する
<a name="salesforce-eca-navigate"></a>

1. Salesforce 組織にサインインし、**Setup** (右上の歯車アイコン) を選択します。

1. ナビゲーションペインで、**プラットフォームツール** > **アプリ** > **外部クライアントアプリ** > **外部クライアントアプリマネージャー**を展開します。

1. **新しい外部クライアントアプリ**を選択します。

### 基本情報を入力する
<a name="salesforce-eca-basic-info"></a>

外部クライアントアプリの次の基本情報を入力します。


**外部クライアントアプリの基本情報**  

| フィールド | 値 | 
| --- | --- | 
| 外部クライアントアプリ名 | わかりやすい名前 (「Amazon Quick Integration」など) | 
| API 名 | アプリ名から自動生成 | 
| 連絡先 E メール | 管理者の E メールアドレス | 
| ディストリビューションの状態 | Local (デフォルト) | 

## ステップ 2: OAuth 設定を構成する
<a name="salesforce-oauth-setup"></a>

### OAuth を有効にする
<a name="salesforce-enable-oauth"></a>

**API (OAuth 設定の有効化)** セクションで、**OAuth を有効にする** を選択して OAuth 設定パネルを展開します。

### コールバック URL の設定
<a name="salesforce-callback-url"></a>

コールバック URL フィールドに Amazon Quick OAuth **コールバック URL** を入力します。

`{{<your-quick-instance-url>}}/sn/oauthcallback`

例: `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`

### OAuth スコープを追加する
<a name="salesforce-oauth-scopes"></a>

次のスコープを**使用可能な OAuth スコープ**から**選択した OAuth スコープ**に移動します。
+ ID URL サービス (ID、プロファイル、E メール、アドレス、電話) にアクセスする
+ API (api) でユーザーデータを管理する
+ ウェブブラウザ (ウェブ) を使用してユーザーデータを管理する
+ フルアクセス (フル)
+ Visualforce アプリケーションにアクセスする (visualforce)
+ リクエストを随時実行する (refresh\_token、offline\_access)
+ 一意のユーザー識別子 (openid) にアクセスする
+ カスタムアクセス許可 (custom\_permissions) にアクセスする
+ Access Connect REST API リソース (chatter\_api)
+ Analytics REST API リソースへのアクセス (wave\_api)
+ Analytics REST API Charts Geodata リソースへのアクセス (eclair\_api)
+ Pardot サービスを管理する (pardot\_api)

### OAuth フローを有効にする
<a name="salesforce-oauth-flows"></a>

次のフローオプションを選択します。
+ **クライアント認証情報フローを有効にする**
+ **認可コードと認証情報フローを有効にする**
+ **トークン交換フローを有効にする**

### セキュリティ設定を有効にする
<a name="salesforce-security-settings"></a>

次のセキュリティオプションを選択します。
+ **Code Exchange (PKCE) の証明キーを要求する**
+ **ウェブサーバーフローのシークレットを要求する** (デフォルトで選択)
+ **更新トークンフローのシークレットを要求する** (デフォルトで選択)

**Create** を選択して、外部クライアントアプリを保存します。

## ステップ 3: コンシューマー認証情報を取得する
<a name="salesforce-consumer-details"></a>

1. 作成後、ECA の詳細ページが表示されます。

1. **設定**タブに移動するか、**コンシューマーの詳細の管理**を選択します。

1. ID (E メール検証コード) の検証が必要になる場合があります。

1. **コンシューマーキー** (クライアント ID) と**コンシューマーシークレット** (クライアントシークレット) をコピーします。

**重要**  
これらの認証情報を安全に保存します。Amazon Quick でコネクタを設定するときに必要になります。

## ステップ 4: Amazon Quick で Salesforce コネクタを設定する
<a name="salesforce-integration-setup"></a>

### コネクタに移動する
<a name="salesforce-navigate-connectors"></a>

1. Amazon Quick を開き、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **Salesforce** を検索して選択します。

1. コネクタがすでに存在することを求められたら、**いいえを選択し、新しい を作成します**。

### 接続の詳細を入力する
<a name="salesforce-connection-details"></a>

次の接続の詳細を入力します。


**Salesforce コネクタの接続の詳細**  

| フィールド | 値 | 
| --- | --- | 
| 名前 | わかりやすい名前 (「Salesforce ECA」など) | 
| ネットワーク | パブリックネットワーク | 
| 認証タイプ | カスタム OAuth アプリ | 
| ベース URL | https://{{<your-domain>}}.my.salesforce.com/services/data/v60.0 | 
| クライアント ID | ステップ 3 のコンシューマーキー | 
| クライアントシークレット | ステップ 3 のコンシューマーシークレット | 
| トークン URL | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/token | 
| 認可 URL | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/authorize | 
| リダイレクト URL | 事前入力済み (変更なし) | 

**次へ** をクリックして先に進みます。

## ステップ 5: 検証して公開する
<a name="salesforce-verify-publish"></a>

1. **レビュー**ページで、使用可能な Salesforce アクション (最大 42 アクション) を確認します。

1. **次**へ を選択して、ユーザー共有に進みます。

1. このコネクタにアクセスできるユーザーまたはグループを選択します。

1. **パブリ**ッシュを選択してコネクタをパブリッシュします。

コネクタを発行したら、Amazon Quick チャット、フロー、オートメーションで Salesforce アクションを使用できます。

## 使用可能なアクション
<a name="salesforce-integration-actions"></a>

コネクタを設定すると、次の Salesforce アクションを使用できます。
+ 標準オブジェクトとカスタムオブジェクトに対する作成、読み取り、更新、削除 (CRUD) オペレーション。
+ SOQL (Salesforce オブジェクトクエリ言語) を使用して Salesforce データをクエリします。
+ リード、アカウント、連絡先、機会を管理します。
+ Apex メソッドとカスタムロジックを実行します。
+ ケース、タスク、アクティビティを管理します。
+ レポートとダッシュボードにアクセスします。

**注記**  
Salesforce 統合はアクション実行のみをサポートします。データアクセスとナレッジベースの作成は、Salesforce システムでは利用できません。

## トラブルシューティング
<a name="salesforce-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。
+ **「URL が存在しなくなりました」エラー** – トークン URL と認可 URL で正しい Salesforce ドメインを使用していることを確認します。レガシーエンドポイントは使用しないでください。
+ **OAuth 検証が失敗**する – ECA で PKCE が有効になっていること、およびコールバック URL が `/sn/oauthcallback`が追加された Amazon Quick インスタンス URL と正確に一致することを確認します。
+ **スコープ不足エラー** – Salesforce の ECA 設定に戻り、必要なすべての OAuth スコープが**選択済み**リストにあり、まだ**利用可能**になっていないことを確認します。
+ **「Connected App」オプションがグレー表示** – これは Salesforce Spring '26 以降に想定されます。代わりに外部クライアントアプリを使用します。ECAs はサポートされている置き換えです。