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

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

Amazon Quick の Salesforce アクションコネクタを使用すると、レコードの管理、データのクエリ、Salesforce APIs とのやり取りなど、Salesforce 組織内でアクションを実行できます。このアクションコネクタはタスク実行のみをサポートし、Amazon Quick Pro 階層以上が必要です。

## できること
<a name="salesforce-integration-capabilities"></a>

Salesforce 統合を使用すると、アクションコネクタを使用して Salesforce 組織内でアクションを実行できます。

**アクションコネクタ**  
リード、アカウント、連絡先、機会などの Salesforce オブジェクトを作成、更新、クエリします。

**注記**  
Salesforce 統合では、データアクセスやナレッジベースの作成はサポートされていません。これは、タスクの実行と Salesforce オブジェクトとの API インタラクション専用に設計されています。

## [開始する前に]
<a name="salesforce-integration-prerequisites"></a>

Salesforce 統合を設定する前に、以下があることを確認してください。
+ 適切なアクセス許可を持つ Salesforce 組織。
+ Salesforce 接続アプリケーションまたは API アクセス認証情報。
+ Amazon Quick Author 以上。
+ OAuth アプリケーションを設定するための管理アクセス (ユーザー認証を使用している場合）。

## ステップ 1: Salesforce 接続アプリを設定する
<a name="salesforce-connected-app-setup"></a>

**注記**  
Salesforce で接続されたアプリを作成します。外部クライアントアプリを作成しないでください。外部クライアントアプリケーションは、この統合と互換性がありません。

Salesforce で接続されたアプリを作成して、Amazon Quick で OAuth 認証を有効にします。

1. Salesforce アカウントにサインインし、右上の Setup アイコンを使用して Setup ページに移動します。

1. クイック検索バーで、「」と入力し**Apps**、次のステップに従います。
   + **外部クライアントアプリ**の選択
   + **設定**の選択
   + 設定 で、新しい接続アプリケーションを作成します。

1. **新しい接続されたアプリ**を選択します。

1. **接続されたアプリを作成する** を選択します。

1. 基本情報セクションに、次の必須情報を入力します。
   + **接続されたアプリ名** - 接続されたアプリのわかりやすい名前。
   + **API 名** - アプリケーションの一意の API 名。
   + **連絡先 E** メール - 連絡先 E メールアドレス。

1. OAuth 設定セクションで、次のチェックボックスをオンにします。
   + **OAuth 設定を有効にする**
   +  **サポートされる認可フローのコード交換 (PKCE) 拡張に証明キー**を要求する * (推奨)* 

      このオプションを有効にして、認可コードフローにセキュリティレイヤーを追加します。
   + **ウェブサーバーフローのシークレットを要求する**
   + **更新トークンフローにシークレットを要求する**
   + **クライアント認証情報フローを有効にする**
   + **認可コードと認証情報フローを有効にする**
   + **トークン交換フローを有効にする**
   + **トークン交換フローにシークレットを要求する**

1. 以下の必要な OAuth スコープを追加します。
   + `api` - Salesforce APIsにアクセスする
   + `refresh_token` - ユーザーがオフラインのときにアクセスを維持する
   + `offline_access` - いつでもリクエストを実行する
   + `full` - すべてのデータへのフルアクセス
   + `web` - ウェブベースのアクセス
   + `visualforce` - Visualforce ページにアクセスする
   + `custom_permissions` - カスタムアクセス許可にアクセスする
   + `chatter_api` - Chatter API にアクセスする
   + `wave_api` - 分析 API にアクセスする
   + `eclair_api` - Einstein Analytics API にアクセスする
   + `pardot_api` - Pardot API にアクセスする
   + `id` - ID 情報にアクセスする
   + `email` - E メールアドレスにアクセスする
   + `profile` - 基本的なプロファイル情報にアクセスする
   + `address` - アドレス情報にアクセスする
   + `phone` - 電話番号にアクセスする
   + `open_id` - OpenID Connect にアクセスする

1. コールバック URL を 形式で入力します。 `<quicksuite-url>/sn/oauthcallback`

1. **[保存]** を選択します。

## ステップ 2: コンシューマーの詳細と実行ユーザーを設定する
<a name="salesforce-consumer-details"></a>

コンシューマーの詳細を設定し、クライアント認証情報フローの実行ユーザーを設定します。

1. 接続されたアプリの管理ページで、**コンシューマーの詳細の管理**を選択します。ID の検証が必要になる場合があります。

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

1. **[Apply]** (適用) を選択します。

1. **「初期アクセストークン**」を選択し、**「OK**」を選択します。

1. 実行ユーザーを設定します。

   1. 接続されたアプリケーションの詳細ページから、アクション列で**編集**を選択します。

   1. OAuth ポリシー > トークンポリシーの更新で、更新**トークンをすぐに期限切れにする**を選択します。

   1. クライアント認証情報フローの Run As で、クライアント認証情報フローを割り当てるユーザーを選択します。

   1. **[保存]** を選択します。

## ステップ 3: Salesforce アクションコネクタを設定する
<a name="salesforce-integration-setup"></a>

Salesforce に接続されたアプリケーションの認証情報を準備したら、Amazon Quick で Salesforce アクションコネクタを作成します。

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

1. Amazon Quick コンソールで、**統合**を選択します。

1. 統合オプションから **Salesforce** を選択し、追加 (プラス「＋」) ボタンをクリックします。

1. 統合の詳細を入力します。
   + **名前** - Salesforce アクションコネクタの説明名。
   + **説明** (オプション) - アクションコネクタの目的。

1. 接続タイプを選択します。
   + **ユーザー認証** - 個々のユーザーアクセスのための OAuth ベースの認証。
   + **サービス認証** - Service-to-service認証。

1. 選択した認証方法 (ユーザーまたはサービス) に基づいて接続設定を入力します。

   1. **ユーザー認証 (OAuth)** では、次のフィールドを設定します。
     + **ベース URL** - Salesforce インスタンス URL (https://your-domain.salesforce.com など）。
     + **クライアント ID** - Salesforce 接続アプリケーションコンシューマーキー。
     + **クライアントシークレット** - Salesforce 接続アプリケーションコンシューマーシークレット。
     + **トークン URL** - Salesforce OAuth トークンエンドポイント。
     + **認証 URL** - Salesforce OAuth 認可エンドポイント。
     + **リダイレクト URL** - 接続されたアプリで設定された OAuth リダイレクト URI。

1. **作成して続行**を選択します。

1. 統合を共有するユーザーを選択します。

1. **[次へ]** をクリックします。

## ステップ 4: アクションコネクタをオートメーショングループに関連付ける
<a name="salesforce-automation-group-setup"></a>

オートメーションで Salesforce アクションを使用するには、アクションコネクタをオートメーショングループに関連付ける必要があります。

1. オートメーショングループ設定に移動します。

1. Salesforce アクションコネクタを、これらのアクションを使用するオートメーショングループに関連付けます。

1. ワークフロー内の Salesforce アクションにアクセスするための自動化グループの新しい自動化を作成します。

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

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

## 統合の共有
<a name="salesforce-integration-sharing"></a>

Salesforce アクションコネクタは、組織内の他のユーザーと共有できます。以下の手順に従ってください。

1. 統合を作成したら、**統合の共有**を選択します。

1. 統合を共有するユーザーまたはグループを選択します。

1. 共有アクセスに適切なアクセス許可を設定します。

1. 共有設定を確認します。

共有ユーザーは Salesforce 統合を使用して、元の認証設定で設定されたアクセス許可に従って、接続された Salesforce 組織内でアクションを実行できます。

## Salesforce アクションコネクタを管理する
<a name="salesforce-integration-management"></a>

Salesforce アクションコネクタを作成したら、次のオプションを使用して管理できます。
+ **アクションコネクタの編集** - 認証設定または Salesforce インスタンス設定を更新します。
+ **アクションコネクタを共有する** - 組織内の他のユーザーがアクションコネクタを使用できるようにします。
+ **使用状況のモニタリング** - アクションコネクタのアクティビティと API 使用状況メトリクスを表示します。
+ **アクションの確認** - 使用可能な Salesforce アクションの完全なリストを参照してください。
+ **アクションコネクタの削除** - アクションコネクタを削除し、関連する認証を取り消します。