

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Salesforce 整合
<a name="salesforce-integration"></a>

透過 Amazon Quick 中的 Salesforce 動作連接器，您可以在 Salesforce 組織內執行動作，包括管理記錄、查詢資料以及與 Salesforce APIs 互動。此動作連接器僅支援任務執行，且需要 Amazon Quick Pro 層或更高層。

## 您可以做什麼
<a name="salesforce-integration-capabilities"></a>

透過 Salesforce 整合，您可以透過動作連接器在 Salesforce 組織內執行動作。

**動作連接器**  
建立、更新和查詢 Salesforce 物件，例如潛在客戶、帳戶、聯絡人和機會。

**注意**  
Salesforce 整合不支援資料存取或知識庫建立。它專為任務執行和 API 與 Salesforce 物件的互動而設計。

## 開始之前
<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 帳戶，並使用右上角的設定圖示導覽至設定頁面。

1. 在快速尋找列中，輸入 **Apps**，然後遵循下列步驟：
   + 選取**外部用戶端應用程式**
   + 選取**設定**
   + 在設定下，建立新的連線應用程式

1. 選擇**新的連線應用程式**。

1. 選擇**建立連線的應用程式**。

1. 在基本資料區段中，輸入下列必要資訊：
   + **連線的應用程式名稱** - 連線應用程式的描述性名稱。
   + **API 名稱** - 您應用程式的唯一 API 名稱。
   + **聯絡人電子郵件** - 您的聯絡人電子郵件地址。

1. 在 OAuth 設定區段中，選取下列核取方塊：
   + **啟用 OAuth 設定**
   +  **支援授權流程需要程式碼交換 (PKCE) 延伸的證明金鑰 ***（建議）* 

      啟用此選項，將額外的安全層新增至授權碼流程。
   + **需要 Web 伺服器流程的秘密**
   + **重新整理權杖流程需要秘密**
   + **啟用用戶端登入資料流程**
   + **啟用授權碼和登入資料流程**
   + **啟用權杖交換流程**
   + **權杖交換流程需要秘密**

1. 新增下列必要的 OAuth 範圍：
   + `api` - 存取 Salesforce APIs
   + `refresh_token` - 在使用者離線時維護存取權
   + `offline_access` - 隨時執行請求
   + `full` - 完整存取所有資料
   + `web` - Web 型存取
   + `visualforce` - 存取 Visualforce 頁面
   + `custom_permissions` - 存取自訂許可
   + `chatter_api` - 存取 Chatter API
   + `wave_api` - Access Analytics API
   + `eclair_api` - 存取 Einstein Analytics API
   + `pardot_api` - Access Pardot API
   + `id` - 存取身分資訊
   + `email` - 存取電子郵件地址
   + `profile` - 存取基本設定檔資訊
   + `address` - 存取地址資訊
   + `phone` - 存取電話號碼
   + `open_id` - 存取 OpenID Connect

1. 以下列格式輸入回呼 URL： `<quicksuite-url>/sn/oauthcallback`

1. 選擇**儲存**。

## 步驟 2：設定消費者詳細資訊和執行使用者
<a name="salesforce-consumer-details"></a>

設定取用者詳細資訊，並為用戶端登入資料流程設定執行使用者。

1. 在管理連線應用程式頁面中，選擇**管理消費者詳細資訊**。您可能需要驗證您的身分。

1. 複製**消費者金鑰 （用戶端 ID)** 和**消費者秘密 （用戶端秘密）**。

1. 選擇**套用**。

1. 選擇**初始存取字符**，然後選擇**確定**。

1. 設定執行使用者：

   1. 從連線的應用程式詳細資訊頁面，選擇動作欄下的**編輯**。

   1. 在 OAuth 政策 > 重新整理權杖政策下，選取**立即過期重新整理權杖**。

   1. 在用戶端登入資料流程下，針對執行身分，選擇要指派用戶端登入資料流程的使用者。

   1. 選擇**儲存**。

## 步驟 3：設定 Salesforce 動作連接器
<a name="salesforce-integration-setup"></a>

準備 Salesforce 連線的應用程式登入資料後，請在 Amazon Quick 中建立 Salesforce 動作連接器。

Salesforce 整合僅支援動作執行 - Salesforce 系統無法使用資料存取和知識庫建立。

1. 在 Amazon Quick 主控台中，選擇**整合**。

1. 從整合選項中選擇 **Salesforce**，然後按一下新增 （加 "\$1") 按鈕。

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. 按一下 **Next (下一步)**。

## 步驟 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 動作的完整清單。
+ **刪除動作連接器** - 移除動作連接器並撤銷相關聯的身分驗證。