WorkSpan
WorkSpan は、パートナーとの計画、実行、売上を推進するための共同プラットフォームです。 WorkSpan でパートナー プログラムやパートナー イニシアチブを管理すると、内部アプリケーションとパートナー アプリケーションにシームレスに接続できます。 CRM、パートナー センター、コラボレーション ツール、生産性向上ツールを WorkSpan と統合することができます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | WorkSpan API サポート |
| [URL] | https://support.workspan.com |
| メール | api-team@workspan.com |
| Connector Metadata | |
|---|---|
| 発行者 | WorkSpan |
| Web サイト | https://www.workspan.com |
| カテゴリー | マーケティング;営業と CRM |
| プライバシー ポリシー | https://www.workspan.com/privacy-policy |
WorkSpan は、パートナーとつながり、パートナー プログラムを管理するための共同プラットフォームです。 WorkSpan は、世界有数のテクノロジ企業のパートナー プログラムを支援しています。 人気のある優先アプリケーションを WorkSpan エコシステム クラウドに接続し、パートナー エコシステムで営業案件の価値をエンリッチすることができます。 WorkSpan Connector を使用すると、ユーザーは Dynamics 365 CRM や Salesforce CRM などの多数のビジネス アプリケーションとシームレスに接続することで、エコシステムとパートナーの動きを強化および促進することができます。 ユーザーは、プレミア CRM アプリケーションのデータを WorkSpan と同期できます。 ユーザーは、Microsoft Teams、Slack や OneDrive などの共同作業および生産性アプリケーションにも接続できます。 ユーザーは、割り当てられたタスク、オブジェクトへのコメント、オブジェクトのメンバーシップ関連の発生など、WorkSpan のさまざまな共同作業関連イベントの通知を受け取ることができます。 WorkSpan コネクタは、生産性を高め、アプリケーション間のデータの整合性を維持し、ビジネス アプリケーションのユーザーにタイムリーなデータと価値を提供します。 その結果、コネクタを使用する企業は、コスト削減、収益の増加、営業プロセスの合理化と加速、およびレポートの強化を実現することができます。
前提条件
組織は WorkSpan に登録されている会社である必要があります
資格情報の入手方法
コネクタを使用するには、ユーザーを認証する必要があります。 WorkSpan を使用すると、WorkSpan で構成されているアプリケーション ユーザーのコネクタと WorkSpan のデータにアクセスできます。 詳細な手順については、https://support.workspan.com を参照してください
既知の問題と制限事項
既知の問題はありません
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| 環境: サンドボックスまたは実稼働 | 文字列 | サンドボックス環境または実稼働環境 | 真 |
| アプリケーション ユーザー ID | 文字列 | WorkSpan アプリケーション ユーザーの ID | 真 |
| アプリケーション ユーザー シークレット | securestring | アプリケーション ユーザー シークレット | 真 |
| WorkSpan アプリのホスト名。 例: demo.workspan.com /app.workspan.com | 文字列 | ホスト名を入力 (https なし) 例: demo.workspan.com / app.workspan.com | 真 |
| メモ | 文字列 | 接続に関する注意事項 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
|
Work |
外部アプリケーションの主な一意識別子を取得します |
|
Work |
WorkSpanObject に監査情報を追加する |
| レポート データを読み取る |
レポート データを読み取る |
| レポートの一覧を取得 |
レポートを一覧表示する |
| 一括読み込みデータ (本文のデータ) |
入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です |
| 一括読み込みデータ (添付) |
入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です |
| 一括読み込み営業案件 (本文のデータ) |
入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です |
| 一括読み込み営業案件 (添付) |
入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です |
| 一括読み込み操作の状態を取得する |
一括読み込み操作の状態を取得します |
|
外部 ID を Work |
外部アプリケーションの主な一意識別子を使用して WorkSpan オブジェクトを更新します |
WorkSpan ID の外部 ID を取得する
外部アプリケーションの主な一意識別子を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan オブジェクトのオブジェクト ID (長い ID)
|
object_id | True | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
戻り値
WorkSpan オブジェクトへの監査情報の追加
WorkSpanObject に監査情報を追加する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
WorkSpan の監査フィールドのフィールド名。 |
|
integration_id
|
integration_id | string |
関連する統合の統合 ID (長い ID) |
|
|
external_id
|
external_id | string |
外部システムからの ID (例: CRM ID) |
|
|
status_code
|
status_code | True | string |
監査要求の状態を表すコード。 |
|
メッセージ
|
message | True | string |
監査ログに記録するための追加情報 |
|
WorkSpan オブジェクト ID (長い ID)
|
object_id | True | string |
統合状態で更新される WorkSpan オブジェクトのオブジェクト ID (長い ID) |
戻り値
- 本文
- audit_response
レポート データを読み取る
レポート データを読み取る
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Report Id
|
reportId | True | integer |
レポート ID |
|
colId
|
colId | string | ||
|
negate
|
negate | boolean | ||
|
op
|
op | string | ||
|
type
|
type | string | ||
|
op
|
op | string | ||
|
number
|
number | True | integer | |
|
size
|
size | True | integer |
戻り値
- Body
- ReportDataResponse
レポートの一覧を取得
レポートを一覧表示する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
number
|
number | integer |
数値 |
|
|
size
|
size | integer |
サイズ |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
id |
|
name
|
name | string |
名称 |
一括読み込みデータ (本文のデータ)
入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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: 値、key2: 値}、{key1: 値、key2: 値} ] |
戻り値
- 本文
- bulkload_response
一括読み込みデータ (添付)
入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan で構成された統合を選択する
|
integration_id | True | string |
WorkSpan で構成されている CRM 統合の統合 ID |
|
データの形式。 許可されている形式は、.csv .xlsx および .json です
|
data_format | string |
データの形式。 許可されている形式は、.csv .xlsx および .json です |
|
|
アップロードするファイル
|
file | True | file |
アップロードするファイル |
戻り値
- 本文
- bulkload_response
一括読み込み営業案件 (本文のデータ)
入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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: 値、key2: 値}、{key1: 値、key2: 値} ] |
戻り値
一括読み込み営業案件 (添付)
入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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 |
アップロードするファイル |
戻り値
一括読み込み操作の状態を取得する
一括読み込み操作の状態を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
統合 ID
|
integration_id | True | string |
統合 ID |
|
実行 ID (一括読み込みステップが返されました)
|
execution_id | True | string |
一括 API から返される統合実行の実行 ID |
|
エラーがある場合は応答にエラーを含めます
|
include_errors | boolean |
エラーがある場合は応答にエラーを含めます |
|
|
応答で返されるエラーの最大数
|
max_errors | number |
応答で返すエラーの最大数 |
戻り値
外部 ID を WorkSpan ID に接続する
外部アプリケーションの主な一意識別子を使用して WorkSpan オブジェクトを更新します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan オブジェクトのオブジェクト ID (長い ID)
|
object_id | True | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
WorkSpan の外部 ID のフィールド名。 空の場合、外部 ID フィールドの既定のフィールド名が使用されます。 既定のフィールド名は、営業案件オブジェクトでは「sales_details.crm_opportunity_id」、取引先企業オブジェクトでは「account_info.external_account_id」です |
|
|
external_id
|
external_id | True | string |
外部システムからの ID (例: CRM) |
戻り値
- 本文
- external_id_response
トリガー
|
Work |
このトリガーは、WorkSpan ユーザーが Microsoft パートナー センターに営業案件を送信するように要求した場合に発生します |
|
Work |
営業案件の作成や更新などのさまざまなオブジェクト イベントに登録して、パートナーの影響の可視性を高めます |
|
Work |
メンバーシップ、タスク、コメントの作成と更新などのさまざまな共同作業イベントに登録して、内部ネットワークとパートナー ネットワークとのコミュニケーションを促進および強化します。 |
WorkSpan から Microsoft パートナー センターへの紹介を送信する
このトリガーは、WorkSpan ユーザーが Microsoft パートナー センターに営業案件を送信するように要求した場合に発生します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
イベント サブスクライバーの名前 |
|
WorkSpan で構成された統合を選択する
|
integration_id | True | string |
戻り値
WorkSpan オブジェクト イベントに登録する
営業案件の作成や更新などのさまざまなオブジェクト イベントに登録して、パートナーの影響の可視性を高めます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト イベントに登録する
|
event | True | array of string | |
|
名前
|
name | True | string |
イベント サブスクライバーの名前 |
|
WorkSpan で構成された統合を選択する
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
フィルターの例: ([「クローズ」、「受注」、「失注」]のステージ) および (sales_details.partner = 「P1」)
|
filters | string |
イベントのフィルター |
戻り値
WorkSpan 共同作業イベントに登録する
メンバーシップ、タスク、コメントの作成と更新などのさまざまな共同作業イベントに登録して、内部ネットワークとパートナー ネットワークとのコミュニケーションを促進および強化します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント名
|
event | True | string | |
|
サブスクライバー名
|
name | True | string |
Webhook に割り当てられた名前 |
|
WorkSpan オブジェクト ID
|
object_ids | array of string |
Webhook が登録されているオブジェクト ID |
|
|
フィルターの例: ([「クローズ」、「受注」、「失注」]のステージ) および (sales_details.partner = 「P1」)
|
filters | string |
イベントのフィルター |
戻り値
定義
bulkload_opportunity_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
integration_id
|
integration_id | string |
統合 ID |
|
execution_id
|
execution_id | string |
実行 ID |
|
created_at
|
created_at | date-time |
作成時間 |
bulkload_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
integration_id
|
integration_id | string |
統合 ID |
|
execution_id
|
execution_id | string |
実行 ID |
|
data_format
|
data_format | string |
データ形式 |
|
created_at
|
created_at | date-time |
作成時間 |
bulkload_status_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
エラー メッセージ |
|
ID
|
errors.id | string |
失敗したレコードの ID |
|
data_row
|
errors.data_row | string |
失敗したデータ行 |
external_id_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
external_id
|
external_id | string |
外部システムからの ID (例: CRM) |
|
object_id
|
object_id | string |
WorkSpan オブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
外部システムからの external_id が格納されている WorkSpan フィールド名 |
get_external_id_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
object_id
|
object_id | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
外部システムからの external_id が格納されている WorkSpan フィールド名 |
|
external_id
|
external_ids.external_id | string |
外部システムからの ID (例: CRM) |
audit_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
object_id
|
object_id | string |
更新された WorkSpan オブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
更新された WorkSpan フィールドの名前 |
|
status_code
|
status_code | string |
状態の更新 |
ReportDataResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
version
|
version | integer |