本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Salesforce 整合
透過 Amazon Quick 中的 Salesforce 動作連接器,您可以在 Salesforce 組織內執行動作,包括管理記錄、查詢資料以及與 Salesforce APIs 互動。如需 Amazon Quick 訂閱需求,請參閱 在主控台中設定整合。
注意
截至 Salesforce Spring '26 版本 (2026 年 2 月),所有 Salesforce 組織預設會停用新的連線應用程式建立。本指南使用與 Amazon Quick Salesforce 連接器完全相容的 Salesforce 外部用戶端應用程式 (ECAs)。
先決條件
在您設定 Salesforce 整合之前,請確定您有下列項目:
-
具有系統管理員存取權的 Salesforce 組織。
-
Amazon Quick Author 角色或更高版本。
-
您的 Amazon Quick 執行個體 URL (例如
https://us-east-1.quicksight.aws.amazon.com)。
步驟 1:在 Salesforce 中建立外部用戶端應用程式
在 Salesforce 中建立外部用戶端應用程式 (ECA),以使用 Amazon Quick 啟用 OAuth 身分驗證。
導覽至外部用戶端 App Manager
-
登入您的 Salesforce 組織,然後選擇設定 (右上角的齒輪圖示)。
-
在導覽窗格中,展開平台工具 > 應用程式 > 外部用戶端應用程式 > 外部用戶端應用程式管理員。
-
選擇新的外部用戶端應用程式。
填寫基本資訊
為您的外部用戶端應用程式輸入下列基本資訊:
| 欄位 | Value |
|---|---|
| 外部用戶端應用程式名稱 | 描述性名稱 (例如,「Amazon Quick Integration」) |
| API 名稱 | 從應用程式名稱自動產生 |
| 聯絡人電子郵件 | 您的管理員電子郵件地址 |
| 分佈狀態 | Local (預設) |
步驟 2:設定 OAuth 設定
啟用 OAuth
在 API (啟用 OAuth 設定) 區段中,選取啟用 OAuth 以展開 OAuth 組態面板。
設定回呼 URL
在回呼 URL 欄位中輸入 Amazon Quick OAuth 回呼 URL:
<your-quick-instance-url>/sn/oauthcallback
例如:https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback
新增 OAuth 範圍
將下列範圍從可用的 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 流程
選取下列流程選項:
-
啟用用戶端登入資料流程
-
啟用授權碼和登入資料流程
-
啟用字符交換流程
啟用安全設定
選取下列安全選項:
-
需要 Code Exchange 的證明金鑰 (PKCE)
-
需要 Web 伺服器流程的秘密 (預設為選取)
-
需要秘密才能重新整理權杖流程 (預設為選取)
選擇建立以儲存外部用戶端應用程式。
步驟 3:取得消費者登入資料
-
建立之後,您會在 ECA 詳細資訊頁面上。
-
導覽至設定索引標籤,或選擇管理消費者詳細資訊。
-
您可能需要驗證您的身分 (電子郵件驗證碼)。
-
複製取用者金鑰 (用戶端 ID) 和取用者秘密 (用戶端秘密)。
重要
安全地儲存這些登入資料。在 Amazon Quick 中設定連接器時需要它們。
步驟 4:在 Amazon Quick 中設定 Salesforce 連接器
導覽至連接器
-
開啟 Amazon Quick 並選擇連接器。
-
選擇為您的團隊建立索引標籤。
-
尋找並選擇 Salesforce。
-
如果提示連接器已存在,請選擇否,建立新連接器。
填寫連線詳細資訊
輸入下列連線詳細資訊:
| 欄位 | Value |
|---|---|
| 名稱 | 描述性名稱 (例如,「Salesforce ECA」) |
| 網路 | 公有網路 |
| 驗證類型 | 自訂 OAuth 應用程式 |
| 基本 URL | https:// |
| 用戶端 ID | 步驟 3 中的取用者金鑰 |
| 用戶端秘密 | 步驟 3 中的消費者秘密 |
| 權杖 URL | https:// |
| 授權 URL | https:// |
| 重新導向 URL | 預先填入 (請勿變更) |
選擇下一步繼續進行。
步驟 5:驗證並發佈
-
在檢閱頁面上,驗證可用的 Salesforce 動作 (最多 42 個動作)。
-
選擇下一步以繼續使用者共用。
-
選取應可存取此連接器的使用者或群組。
-
選擇發佈以發佈連接器。
發佈連接器後,您可以在 Amazon Quick Chat、流程和自動化中使用 Salesforce 動作。
可用動作
設定連接器後,可使用下列 Salesforce 動作:
-
在標準和自訂物件上建立、讀取、更新和刪除 (CRUD) 操作。
-
使用 SOQL (Salesforce 物件查詢語言) 查詢 Salesforce 資料。
-
管理潛在客戶、帳戶、聯絡人和機會。
-
執行 Apex 方法和自訂邏輯。
-
管理案例、任務和活動。
-
存取報告和儀表板。
注意
Salesforce 整合僅支援動作執行。Salesforce 系統無法使用資料存取和知識庫建立。
疑難排解
若要編輯、共用或刪除連接器,請參閱 管理現有的整合。
-
「URL 不再存在」錯誤 – 請確定您在權杖 URL 和授權 URL 中使用正確的 Salesforce 網域。請勿使用舊版端點。
-
OAuth 驗證失敗 – 確認 ECA 上已啟用 PKCE,且回呼 URL 與
/sn/oauthcallback附加的 Amazon Quick 執行個體 URL 完全相符。 -
缺少範圍錯誤 – 返回 Salesforce 中的 ECA 組態,並確保所有必要的 OAuth 範圍都在選取的清單中,而不是仍在可用中。
-
"Connected App" 選項反灰 – 這是在 Salesforce Spring '26 之後預期的。請改用外部用戶端應用程式。ECAs 是支援的取代。