WorkSpan
WorkSpan 是一個協作平台，用於與合作夥伴一起規劃、執行和增加收入。 在 WorkSpan 上管理您的合作夥伴計劃和合作夥伴計劃，並與內部和合作夥伴應用程式無縫連接。 您可以將 CRM、合作夥伴中心、共同作業工具和生產力工具整合至 WorkSpan。
此連接器適用於以下產品和區域：
| 服務 | 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） |
| 連絡人 | |
|---|---|
| 名稱 | WorkSpan API 支援 |
| URL | https://support.workspan.com |
| api-team@workspan.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | WorkSpan |
| 網站 | https://www.workspan.com |
| 類別 | 營銷;銷售和客戶關係管理 |
| 隱私策略 | https://www.workspan.com/privacy-policy |
WorkSpan 是一個協作平台，用於與您的合作夥伴聯繫並管理您的合作夥伴計劃。 WorkSpan 為一些世界領先的科技公司提供成功的合作夥伴計劃。 將您熱門和偏好的應用程式與 WorkSpan 生態系統雲端連接起來，利用合作夥伴生態系統的強大功能豐富您的銷售機會的價值。 借助 WorkSpan 連接器，用戶可以通過與 Dynamics 365 CRM 和 Salesforce CRM 等許多業務應用程序無縫連接來增強和加速他們的生態系統和合作行動。 用戶可以將其頂級 CRM 應用程序中的數據與 WorkSpan 同步。 用戶還可以連接協作和生產力應用程序，例如 Microsoft Teams、Slack 和 OneDrive。 使用者可以隨時通知 WorkSpan 中的各種協同作業相關事件，例如指派的作業、物件的註解，以及物件上的成員資格相關出現。 WorkSpan 連接器可提高生產力，維護跨應用程式的資料完整性，並為業務應用程式使用者提供及時的資料和價值。 因此，使用該連接器的組織將體驗到成本節約、收入增加、簡化和加速銷售流程以及增強的報告。
先決條件
該組織必須是在 WorkSpan 上註冊的公司
如何取得認證
使用者應該經過驗證才能使用連接器。 WorkSpan 為 WorkSpan 中已設定的應用程式使用者提供對連接器和 WorkSpan 中資料的存取權。 詳細步驟可在以下網址找到 https://support.workspan.com
已知問題與限制
沒有已知問題
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 環境：沙箱或生產環境 | 字串 | 沙箱環境或生產環境 | 對 |
| 應用程式使用者識別碼 | 字串 | WorkSpan 應用程式使用者的 ID | 對 |
| 應用程式使用者密碼 | securestring | 應用程式使用者密碼 | 對 |
| WorkSpan 應用程式主機名稱。 範例：demo.workspan.com /app.workspan.com | 字串 | 輸入主機名稱（不含 https）範例：demo.workspan.com / app.workspan.com | 對 |
| 註釋 | 字串 | 連接注意事項 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
|
取得 Work |
取得外部應用程式的主要唯一識別碼 |
| 取得報告清單 |
列出報告 |
| 取得大量載入作業的狀態 |
取得大量載入作業的狀態 |
| 大量載入機會 （內文中的資料） |
將輸入資料作為請求內文上傳至您的整合。 允許的格式為 .csv 和 .json |
| 大量載入機會 （附件） |
將輸入檔案上傳至您的整合。 允許的格式為 .xlsx、.json 和 .csv |
| 大量載入資料（內文中的資料） |
將輸入資料作為請求內文上傳至您的整合。 允許的格式為 .csv 和 .json |
|
將外部 ID 連線至 Work |
使用外部應用程式的主要唯一識別碼更新 WorkSpan 物件 |
|
將稽核資訊新增至 Work |
將稽核資訊新增至 WorkSpanObject |
| 批量載入資料（附件） |
將輸入檔案上傳至您的整合。 允許的格式為 .xlsx、.json 和 .csv |
| 讀取報表資料 |
讀取報表資料 |
取得 WorkSpan ID 的外部 ID
取得外部應用程式的主要唯一識別碼
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
WorkSpan 物件的物件 ID （長 ID）
|
object_id | True | string |
WorkSpan 物件的物件 ID （長 ID） |
傳回
取得報告清單
列出報告
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
數字
|
number | integer |
數字 |
|
|
size
|
size | integer |
size |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
識別碼 |
|
名稱
|
name | string |
名稱 |
取得大量載入作業的狀態
取得大量載入作業的狀態
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
整合識別碼
|
integration_id | True | string |
整合識別碼 |
|
執行識別碼 （傳回大量載入步驟）
|
execution_id | True | string |
從大量API傳回的整合執行執行ID |
|
如果有任何錯誤，請在回應中包含錯誤
|
include_errors | boolean |
如果有任何錯誤，請在回應中包含錯誤 |
|
|
在回應中傳回的錯誤數目上限
|
max_errors | number |
在回應中傳回的錯誤數目上限 |
傳回
大量載入機會 （內文中的資料）
將輸入資料作為請求內文上傳至您的整合。 允許的格式為 .csv 和 .json
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string |
WorkSpan 中設定的 CRM 整合的整合 ID |
|
資料的內容類型。 允許的格式為 .csv 和 .json
|
content_type | string |
資料的內容類型。 允許的格式為 .csv 和 .json |
|
|
資料行分隔符號 （如果content_type是 csv，則使用）
|
column_delimiter | string |
資料行分隔符號 （如果content_type是 csv，則使用） |
|
|
資料的內容類型。 text/csv 或 application/json。
|
Content-Type | string |
資料的內容類型。 text/csv 或 application/json。 |
|
|
要上傳的資料
|
bulkload_opportunity_request |
對於內容類型 'CSV'：資料列為 csv。 第一行將是列標題。 對於內容類型 'JSON'，資料格式為陣列： [ { key1 ： value， key2 ： value}， { key1 ： value， key2 ： value } ] |
傳回
大量載入機會 （附件）
將輸入檔案上傳至您的整合。 允許的格式為 .xlsx、.json 和 .csv
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string |
在 WorkSpan 中配置的 CRM 整合的整合 ID |
|
資料的內容類型。 允許的格式為 .csv .xlsx 和 .json
|
content_type | string |
資料的內容類型。 允許的格式為 .csv .xlsx 和 .json |
|
|
excel文件有標題行嗎？
|
has_header_row | boolean |
excel文件有標題行嗎？ |
|
|
要上傳的檔案
|
file | True | file |
要上傳的檔案 |
傳回
大量載入資料（內文中的資料）
將輸入資料作為請求內文上傳至您的整合。 允許的格式為 .csv 和 .json
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string |
WorkSpan 中設定的 CRM 整合的整合 ID |
|
資料的內容類型。 允許的格式為 .csv 和 .json
|
data_format | string |
資料格式。 允許的格式為 csv 和 json |
|
|
資料行分隔符號 （如果content_type是 csv，則使用）
|
column_delimiter | string |
資料行分隔符號 （如果content_type是 csv，則使用） |
|
|
資料的內容類型。 text/csv 或 application/json。
|
Content-Type | string |
資料的內容類型。 text/csv 或 application/json。 |
|
|
要上傳的資料
|
bulkload_request |
對於內容類型 'CSV'：資料列為 csv。 第一行將是列標題。 對於內容類型 'JSON'，資料格式為陣列： [ { key1 ： value， key2 ： value}， { key1 ： value， key2 ： value } ] |
傳回
將外部 ID 連線至 WorkSpan ID
使用外部應用程式的主要唯一識別碼更新 WorkSpan 物件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
WorkSpan 物件的物件 ID （長 ID）
|
object_id | True | string |
WorkSpan 物件的物件 ID （長 ID） |
|
field_name
|
field_name | string |
WorkSpan 中外部 ID 的欄位名稱。 如果為空，則會使用外部 ID 欄位的預設欄位名稱。 預設欄位名稱為：機會物件：'sales_details.crm_opportunity_id';Accound 物件：「account_info.external_account_id」 |
|
|
external_id
|
external_id | True | string |
來自外部系統（例如 CRM）的 ID |
傳回
將稽核資訊新增至 WorkSpan 物件
將稽核資訊新增至 WorkSpanObject
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
WorkSpan 中稽核欄位的欄位名稱。 |
|
integration_id
|
integration_id | string |
相關整合的整合 ID （長 ID） |
|
|
external_id
|
external_id | string |
來自外部系統的 ID （例如。CRM 識別碼） |
|
|
status_code
|
status_code | True | string |
代表稽核要求狀態的程式碼。 |
|
訊息
|
message | True | string |
記錄在稽核記錄中的其他資訊 |
|
WorkSpan 物件 ID （長 ID）
|
object_id | True | string |
WorkSpan 物件的物件 ID （長 ID） 要更新為整合狀態 |
傳回
批量載入資料（附件）
將輸入檔案上傳至您的整合。 允許的格式為 .xlsx、.json 和 .csv
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string |
在 WorkSpan 中配置的 CRM 整合的整合 ID |
|
格式化資料。 允許的格式為 .csv .xlsx 和 .json
|
data_format | string |
格式化資料。 允許的格式為 .csv .xlsx 和 .json |
|
|
要上傳的檔案
|
file | True | file |
要上傳的檔案 |
傳回
讀取報表資料
讀取報表資料
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
報告標識符
|
reportId | True | integer |
報告標識符 |
|
colId
|
colId | string | ||
|
否定
|
negate | boolean | ||
|
OP
|
op | string | ||
|
型別
|
type | string | ||
|
OP
|
op | string | ||
|
數字
|
number | True | integer | |
|
size
|
size | True | integer |
傳回
觸發程序
|
從 Work |
當 WorkSpan 使用者要求將商機提交至 Microsoft 合作夥伴中心時，會引發此觸發程序 |
|
訂閱 Work |
訂閱各種協作活動，例如創建和更新會員資格、任務和評論，以推動和加強與內部和合作夥伴網絡的溝通。 |
|
訂閱 Work |
訂閱各種物件事件，例如機會的建立和更新，以提高合作夥伴影響力的可見度 |
從 WorkSpan 提交轉介至 Microsoft 合作夥伴中心
當 WorkSpan 使用者要求將商機提交至 Microsoft 合作夥伴中心時，會引發此觸發程序
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
事件訂閱者的名稱 |
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string |
傳回
訂閱 WorkSpan 協作活動
訂閱各種協作活動，例如創建和更新會員資格、任務和評論，以推動和加強與內部和合作夥伴網絡的溝通。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
事件名稱
|
event | True | string | |
|
訂閱者名稱
|
name | True | string |
指派給 Webhook 的名稱 |
|
WorkSpan 物件 ID
|
object_ids | array of string |
已註冊 Webhook 的物件識別碼 |
|
|
篩選器範例：（stage in [ “closed”， “won”， “lost” ]） AND （sales_details.partner = “P1”）
|
filters | string |
事件篩選器 |
傳回
訂閱 WorkSpan 物件事件
訂閱各種物件事件，例如機會的建立和更新，以提高合作夥伴影響力的可見度
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂閱物件事件
|
event | True | array of string | |
|
名稱
|
name | True | string |
事件訂閱者的名稱 |
|
選取 WorkSpan 中設定的整合
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
篩選器範例：（stage in [ “closed”， “won”， “lost” ]） AND （sales_details.partner = “P1”）
|
filters | string |
事件篩選器 |
傳回
定義
bulkload_opportunity_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
整合識別碼 |
|
execution_id
|
execution_id | string |
執行識別碼 |
|
建立於
|
created_at | date-time |
建立時間 |
bulkload_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
整合識別碼 |
|
execution_id
|
execution_id | string |
執行識別碼 |
|
data_format
|
data_format | string |
數據格式 |
|
建立於
|
created_at | date-time |
建立時間 |
bulkload_status_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
整合 ID |
|
execution_id
|
execution_id | string |
執行 ID |
|
狀態
|
status | string |
執行狀態 |
|
succcess_count
|
succcess_count | number |
成功處理的記錄數 |
|
error_count
|
error_count | number |
有錯誤的記錄數 |
|
input_count
|
input_count | number |
收到的記錄數 |
|
skip_count
|
skip_count | number |
略過的記錄數 |
|
started_at
|
started_at | date-time |
開始執行的時間戳記 |
|
completed_at
|
completed_at | date-time |
完成執行的時間戳記 |
|
include_errors
|
include_errors | boolean |
旗標，指出回應中是否會傳回錯誤 （如果有的話） |
|
錯誤
|
errors | array of object | |
|
訊息
|
errors.message | string |
錯誤訊息 |
|
識別碼
|
errors.id | string |
失敗記錄的 ID |
|
data_row
|
errors.data_row | string |
失敗的資料列 |
external_id_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
external_id
|
external_id | string |
來自外部系統（例如 CRM）的 ID |
|
object_id
|
object_id | string |
WorkSpan 物件 ID （長 ID） |
|
field_name
|
field_name | string |
WorkSpan 欄位名稱，其中儲存來自外部系統的external_id |
get_external_id_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
WorkSpan 物件的物件 ID （長 ID） |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
WorkSpan 欄位名稱，其中儲存來自外部系統的external_id |
|
external_id
|
external_ids.external_id | string |
來自外部系統（例如 CRM）的 ID |
audit_response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
已更新的 WorkSpan 物件 ID （長 ID） |
|
field_name
|
field_name | string |
已更新的 WorkSpan 欄位名稱 |
|
status_code
|
status_code | string |
更新狀態 |
ReportData回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
清單結束
|
endOfList | boolean | |
|
results
|
results | array of | |
|
版本
|
version | integer |