View a markdown version of this page

Salesforce 整合 - Amazon Quick

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

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

  1. 登入您的 Salesforce 組織,然後選擇設定 (右上角的齒輪圖示)。

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

  3. 選擇新的外部用戶端應用程式

填寫基本資訊

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

外部用戶端應用程式基本資訊
欄位 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:取得消費者登入資料

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

  2. 導覽至設定索引標籤,或選擇管理消費者詳細資訊

  3. 您可能需要驗證您的身分 (電子郵件驗證碼)。

  4. 複製取用者金鑰 (用戶端 ID) 和取用者秘密 (用戶端秘密)。

重要

安全地儲存這些登入資料。在 Amazon Quick 中設定連接器時需要它們。

步驟 4:在 Amazon Quick 中設定 Salesforce 連接器

導覽至連接器

  1. 開啟 Amazon Quick 並選擇連接器

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 Salesforce

  4. 如果提示連接器已存在,請選擇否,建立新連接器。

填寫連線詳細資訊

輸入下列連線詳細資訊:

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:驗證並發佈

  1. 檢閱頁面上,驗證可用的 Salesforce 動作 (最多 42 個動作)。

  2. 選擇下一步以繼續使用者共用。

  3. 選取應可存取此連接器的使用者或群組。

  4. 選擇發佈以發佈連接器。

發佈連接器後,您可以在 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 是支援的取代。