適用於 Salesforce 的 CloudTools (預覽版)
Apptigent CloudTools 為 Salesforce 提供了一系列數據集成操作,任何連接雲的應用程序或工作流程都可以訪問這些操作。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 應用支持 |
| URL | https://www.apptigent.com/help |
| support@apptigent.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 應用 |
| 網站 | https://www.apptigent.com |
| 隱私策略 | https://www.apptigent.com/help/privacy-policy/ |
| 類別 | 生產力 |
透過 Salesforce 的無縫跨平台雲端整合,自動化關鍵業務流程。 輕鬆將 Power Apps 和 Power Automate 與您的 Salesforce 組織連線,以擷取客戶資訊、完成交易、建立記錄、轉換潛在客戶、執行大量作業、執行快速動作、上傳檔案、將文件與記錄建立關聯、更新摘要、擷取連結檔案等等。 您甚至可以使用 SOQL、SOSL 和 GraphQL 執行進階查詢和操作。 CloudTools 可從任何應用程式或工作流程輕鬆存取企業 CRM 資料,從而釋放企業 CRM 資料的潛力。
先決條件
CloudTools 需要有效的 Salesforce 授權、在 Salesforce 組織 (任何版本) 中安裝 CloudTools 受管理套件,以及目前的 CloudTools 訂閱 (另行計費)。 如需如何開始的逐步說明,請造訪 https://www.apptigent.com/solutions/cloudtools/configuration。
如何取得認證
依照下列簡單步驟產生授權 (API) 金鑰:
- 透過 Salesforce App Exchange 安裝 CloudTools 受管理封裝。
- 選取應用程式啟動器中的「Apptigent CloudTools」連結,以啟動 CloudTools 設定頁面。
- 依照畫面上的指示建立連線的應用程式並產生授權金鑰。
- 複製金鑰,並在 Power Apps、Power Automate 或 Azure Logic Apps 的新連線對話方塊中提供。
已知問題與限制
安裝和設定 CloudTools for Salesforce Sales Cloud 需要 Salesforce 中的系統管理員權限。 如果您在組織內沒有足夠的權限,請聯絡您的 Salesforce 管理員以取得協助。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 授權金鑰 | securestring | CloudTools 授權金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 作業 - 建立大量查詢作業 |
建立大量查詢任務 |
| 動作 - 執行快速動作 |
使用必要的資料執行快速動作 |
| 動作 - 描述快速動作 |
擷取快速動作的所有屬性 |
| 動作 - 擷取快速動作 |
擷取組織中所有快速動作的清單 |
| 工作 - 中止工作 |
中止工作 |
| 工作 - 刪除工作 |
刪除工作 |
| 工作 - 取得大量工作狀態 |
檢查作業的狀態 |
| 工作 - 建立大量插入工作 |
建立大量插入工作 |
| 工作 - 獲取批量工作結果 |
取得大量工作結果資訊 |
| 摘要 - 取得記錄摘要 |
擷取 Chatter 記錄摘要 |
| 摘要 - 建立摘要項目 |
建立與記錄相關聯的新摘要項目 |
| 查詢 - GraphQL 查詢 |
執行 Graph QL 查詢以擷取物件和記錄資料 |
| 查詢 - SOQL 查詢 |
執行 SOQL 查詢 |
| 查詢 - 搜尋查詢 |
執行搜尋 (SOSL) 查詢 |
| 檔案 - 共用文件 |
將檔案 (ContentDocument) 與記錄建立關聯,並設定共用屬性 |
| 檔案 - 取得版本 |
擷取個別檔案版本 (ContentVersion) |
| 檔案 - 建立公用連結 |
建立未經驗證的使用者可以存取的公用檔案連結 |
| 檔案 - 建立版本 |
將檔案上傳為新的 ContentVersion 物件 |
| 檔案 - 文件中繼資料 |
擷取檔案的相關資訊 (ContentDocument) |
| 檔案 - 文件版本 |
擷取個別檔案的版本資訊清單 (ContentDocument) |
| 檔案 - 版本資訊 |
擷取個別檔案版本的相關資訊 (ContentVersion) |
| 潛在客戶 - 轉換潛在客戶 |
轉換待開發客戶 |
|
物件 - 列出 s |
擷取組織中所有 sObject 的清單 |
| 物件 - 描述物件 |
擷取 sObject 的所有中繼資料和欄位 |
| 物件 - 物件中繼資料 |
擷取 sObject 的中繼資料 |
| 物件 - 物件可更新欄位 |
擷取 sObject 的可更新欄位 |
| 物件 - 物件欄位 |
擷取 sObject 的欄位 |
| 組織 - 列出 API 版本 |
取得組織中所有支援的 API 版本清單 |
| 組織 - 最新 API 版本 |
取得組織支援的最新 API 版本 |
| 職位 - 獲取所有職位 |
取得所有工作的相關資訊 |
| 記錄 - 刪除記錄 |
刪除指定物件類型的記錄 |
| 記錄 - 取得記錄 |
擷取指定物件類型的記錄 |
| 記錄 - 建立記錄 |
建立指定物件類型的新記錄 |
| 記錄 - 更新記錄 |
更新指定物件類型的記錄 |
| 記錄 - 連結檔案 |
擷取連結至記錄之所有檔案的相關資訊 |
作業 - 建立大量查詢作業
建立大量查詢任務
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
查詢作業
|
operation | string |
查詢作業類型 |
|
|
資料行分隔符號
|
delimiter | string |
輸出檔案中的直欄分隔符號 |
|
|
行尾
|
lineEnding | string |
輸出檔案的行終止符。 適用於 Unix/Linux/Mac OS 的 LF,適用於 Windows 的 CRLF |
|
|
Query
|
query | string |
大型結果集 SOQL 查詢 (未編碼) |
傳回
- response
- object
動作 - 執行快速動作
使用必要的資料執行快速動作
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
快速動作名稱 |
|
資料
|
data | True | object |
快速動作數據 |
傳回
動作 - 描述快速動作
動作 - 擷取快速動作
工作 - 中止工作
中止工作
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
物件識別碼 |
|
類型
|
type | True | string |
物件類型 |
傳回
工作 - 刪除工作
刪除工作
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
物件識別碼 |
|
類型
|
type | True | string |
物件類型 |
傳回
工作 - 取得大量工作狀態
檢查作業的狀態
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
物件識別碼 |
|
類型
|
type | True | string |
物件類型 |
傳回
工作 - 建立大量插入工作
建立大量插入工作
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
物件名稱
|
objectName | string |
sObject 型別的名稱 (例如 Opportunity) |
|
|
檔案格式
|
fileFormat | string |
檔案格式(目前僅支援 CSV) |
|
|
行尾
|
lineEnding | string |
輸入檔案的行終止符。 適用於 Unix/Linus/Mac OS 的 LF,適用於 Windows 的 CRLF |
|
|
檔案
|
file | file |
二進位檔案資料 (25MB 限制) |
傳回
- response
- object
工作 - 獲取批量工作結果
取得大量工作結果資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
jobId | string |
作業識別碼 |
|
|
工作類型
|
jobType | string |
工作類型 |
|
|
結果類型
|
resultType | string |
要擷取的結果集類型 |
|
|
定位器
|
locator | string |
記錄定位器 |
|
|
最大記錄
|
maxRecords | string |
要傳回的記錄數目上限 |
傳回
- response
- object
摘要 - 取得記錄摘要
摘要 - 建立摘要項目
建立與記錄相關聯的新摘要項目
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
摘要內容
|
body | True | string |
摘要項目內容。 接受純文字值或「messageSegments」JSON物件,以取得更複雜的貼文型別(請參閱)。https://bit.ly/4706k0M |
|
記錄識別碼
|
recordId | True | string |
相關聯的記錄識別碼 |
傳回
- response
- object
查詢 - GraphQL 查詢
執行 Graph QL 查詢以擷取物件和記錄資料
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
GraphQL 查詢文字 |
傳回
- response
- object
查詢 - SOQL 查詢
查詢 - 搜尋查詢
檔案 - 共用文件
將檔案 (ContentDocument) 與記錄建立關聯,並設定共用屬性
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
documentId | True | string |
檔案的識別碼 (ContentDocument 物件) |
|
記錄識別碼
|
recordId | True | string |
檔案將與之相關聯的記錄 ID |
|
可見度
|
visibility | True | string |
可以存取檔案的使用者 |
|
權限
|
permissions | True | string |
共用權限(檢視者[僅檢視]、協作者[檢視/編輯/共用]、從相關記錄推斷) |
傳回
- response
- object
檔案 - 取得版本
擷取個別檔案版本 (ContentVersion)
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
版本識別碼
|
versionId | True | string |
要擷取的檔案版本 ID |
傳回
- response
- object
檔案 - 建立公用連結
建立未經驗證的使用者可以存取的公用檔案連結
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
版本識別碼
|
versionId | True | string |
檔案的內容版本識別碼 |
|
檔案名稱
|
name | True | string |
檔案名稱 |
|
在瀏覽器中檢視
|
viewInBrowser | boolean |
建立預覽連結以在瀏覽器中檢視 |
|
|
允許下載
|
allowDownload | boolean |
建立下載連結以擷取檔案內容 |
|
|
密碼
|
password | boolean |
密碼 |
|
|
Expiration
|
expiration | string |
到期日(可選) |
傳回
檔案 - 建立版本
將檔案上傳為新的 ContentVersion 物件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | string |
檔案名稱 (包括副檔名) |
|
|
Title
|
title | string |
檔案標題 |
|
|
文件 ID
|
documentId | string |
(選用)ContentDocument 物件的 ID (僅在將新版本附加至現有檔案時使用) |
|
|
變更原因
|
reasonForChange | string |
(選用)變更說明 |
|
|
檔案
|
file | file |
二進位檔案資料 |
傳回
- response
- object
檔案 - 文件中繼資料
擷取檔案的相關資訊 (ContentDocument)
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
documentId | True | string |
要擷取的檔案內容文件 ID |
傳回
- response
- object
檔案 - 文件版本
擷取個別檔案的版本資訊清單 (ContentDocument)
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
版本識別碼
|
documentId | True | string |
包含要擷取版本的內容文件物件的 ID |
傳回
- response
- object
檔案 - 版本資訊
擷取個別檔案版本的相關資訊 (ContentVersion)
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
版本識別碼
|
versionId | True | string |
要擷取的檔案內容版本的ID |
傳回
- response
- object
潛在客戶 - 轉換潛在客戶
轉換待開發客戶
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
商機識別碼
|
leadId | True | string |
潛在客戶識別碼 |
|
創造機會
|
createOpportunity | boolean |
轉換時建立機會記錄。 預設值是「true」。 |
|
|
機會名稱
|
opportunityName | string |
設定要建立的機會名稱。 如果未指定名稱,則此值預設為潛在客戶的公司名稱。 |
|
|
覆寫潛在客戶來源
|
overwriteLeadSource | boolean |
以來源商機物件中 LeadSource 欄位的內容覆寫目標聯絡人物件上的 LeadSource 欄位。 預設值為 false。 |
|
|
發送通知電子郵件
|
sendNotificationEmail | boolean |
傳送通知電子郵件給擁有者。 預設值為 false。 |
|
|
與帳戶 ID 合併
|
mergeAccountId | string |
商機合併到的帳戶識別碼。 僅在更新現有帳戶時使用。 |
|
|
與聯絡人 ID 合併
|
mergeContactId | string |
潛在客戶將合併到的連絡人識別碼(必須已與mergeAccountId中指定的帳戶相關聯)。 僅在更新現有聯絡人時使用。 |
|
|
與機會 ID 合併
|
mergeOpportunityId | string |
商機合併到的商機識別碼。 僅在更新現有機會時使用。 |
|
|
負責人識別碼
|
ownerId | string |
擁有任何新建立的帳戶、連絡人或機會的人員識別碼。 如果空白,則會使用潛在客戶擁有者值。 |
傳回
- response
- object
物件 - 列出 sObject
物件 - 描述物件
擷取 sObject 的所有中繼資料和欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取物件名稱
|
name | True | string |
sObject 的名稱 |
傳回
物件 - 物件中繼資料
擷取 sObject 的中繼資料
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
物件名稱
|
name | True | string |
sObject 的名稱 |
傳回
物件 - 物件可更新欄位
擷取 sObject 的可更新欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
物件名稱
|
name | True | string |
sObject 的名稱 |
傳回
物件 - 物件欄位
擷取 sObject 的欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
物件名稱
|
name | True | string |
sObject 的名稱 |
傳回
組織 - 列出 API 版本
組織 - 最新 API 版本
職位 - 獲取所有職位
記錄 - 刪除記錄
刪除指定物件類型的記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取物件名稱
|
name | True | string |
將刪除的物件類型 |
|
記錄識別碼
|
recordId | True | string |
要刪除的記錄 ID |
傳回
- response
- object
記錄 - 取得記錄
擷取指定物件類型的記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取物件名稱
|
name | True | string |
將擷取的物件類型 |
|
記錄識別碼
|
recordId | True | string |
要擷取的記錄 ID |
傳回
- response
- object
記錄 - 建立記錄
建立指定物件類型的新記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取物件名稱
|
name | True | string |
將建立的物件類型 |
|
body
|
body | True | dynamic |
記錄建立輸入 |
傳回
- response
- object
記錄 - 更新記錄
更新指定物件類型的記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取物件名稱
|
name | True | string |
將更新的物件類型 |
|
記錄識別碼
|
recordId | True | string |
要更新的記錄 ID |
|
body
|
body | True | dynamic |
記錄更新輸入 |
傳回
- response
- object
記錄 - 連結檔案
擷取連結至記錄之所有檔案的相關資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄識別碼
|
recordId | True | string |
記錄識別碼 |
|
連結類型
|
linkTypes | True | string |
要包含的連結檔案類型 |
傳回
- response
- object
定義
輸出動作清單
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
輸出公用連結
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物件識別碼
|
objectId | string |
內容發佈物件識別碼 |
|
成功
|
success | boolean |
表示作業成功或失敗 |
|
密碼
|
password | string |
自動產生的密碼值 |
|
網址
|
url | string |
公用網址 |
輸出字串結果
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
結果
|
result | string |
文字回應 |
輸出版本清單
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Results
|
results | array of object |
Results |
|
items
|
results | object |
物件
這是類型 'object'。