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

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

透過 Amazon Quick 中的 Salesforce 動作連接器，您可以在 Salesforce 組織內執行動作，包括管理記錄、查詢資料以及與 Salesforce APIs 互動。如需 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 身分驗證。

### 導覽至外部用戶端 App Manager
<a name="salesforce-eca-navigate"></a>

1. 登入您的 Salesforce 組織，然後選擇**設定** （右上角的齒輪圖示）。

1. 在導覽窗格中，展開**平台工具** > **應用程式** > **外部用戶端應用程式 > ****外部用戶端應用程式管理員**。

1. 選擇**新的外部用戶端應用程式**。

### 填寫基本資訊
<a name="salesforce-eca-basic-info"></a>

為您的外部用戶端應用程式輸入下列基本資訊：


**外部用戶端應用程式基本資訊**  

| 欄位 | Value | 
| --- | --- | 
| 外部用戶端應用程式名稱 | 描述性名稱 （例如，「Amazon Quick Integration」) | 
| API 名稱 | 從應用程式名稱自動產生 | 
| 聯絡人電子郵件 | 您的管理員電子郵件地址 | 
| 分佈狀態 | 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 範圍**：
+ 存取身分 URL 服務 (id、設定檔、電子郵件、地址、電話)
+ 透過 API 管理使用者資料 (api)
+ 透過 Web 瀏覽器管理使用者資料 (web)
+ 完整存取 （完整）
+ 存取 Visualforce 應用程式 (visualforce)
+ 隨時執行請求 (refresh\_token, offline\_access)
+ 存取唯一使用者識別符 (openid)
+ 存取自訂許可 (custom\_permissions)
+ Access Connect REST API 資源 (chatter\_api)
+ Access Analytics REST API 資源 (wave\_api)
+ Access 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)**
+ **需要 Web 伺服器流程的秘密** （預設為選取）
+ **需要秘密才能重新整理權杖流程** （預設為選取）

選擇**建立**以儲存外部用戶端應用程式。

## 步驟 3：取得消費者登入資料
<a name="salesforce-consumer-details"></a>

1. 建立之後，您會在 ECA 詳細資訊頁面上。

1. 導覽至**設定**索引標籤，或選擇**管理消費者詳細資訊**。

1. 您可能需要驗證您的身分 （電子郵件驗證碼）。

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 連接器連線詳細資訊**  

| 欄位 | Value | 
| --- | --- | 
| 名稱 | 描述性名稱 （例如，「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 Chat、流程和自動化中使用 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 是支援的取代。