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 秒

アクション

WorkSpan ID の外部 ID を取得する

外部アプリケーションの主な一意識別子を取得します

WorkSpan オブジェクトへの監査情報の追加

WorkSpanObject に監査情報を追加する

レポート データを読み取る

レポート データを読み取る

レポートの一覧を取得

レポートを一覧表示する

一括読み込みデータ (本文のデータ)

入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です

一括読み込みデータ (添付)

入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です

一括読み込み営業案件 (本文のデータ)

入力データを要求本文として統合にアップロードします。 許可されている形式は、.csv および .json です

一括読み込み営業案件 (添付)

入力ファイルを統合にアップロードします。 許可されている形式は、.xlsx、.json および .csv です

一括読み込み操作の状態を取得する

一括読み込み操作の状態を取得します

外部 ID を WorkSpan ID に接続する

外部アプリケーションの主な一意識別子を使用して 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

戻り値

レポートの一覧を取得

レポートを一覧表示する

パラメーター

名前 キー 必須 説明
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

トリガー

WorkSpan から Microsoft パートナー センターへの紹介を送信する

このトリガーは、WorkSpan ユーザーが Microsoft パートナー センターに営業案件を送信するように要求した場合に発生します

WorkSpan オブジェクト イベントに登録する

営業案件の作成や更新などのさまざまなオブジェクト イベントに登録して、パートナーの影響の可視性を高めます

WorkSpan 共同作業イベントに登録する

メンバーシップ、タスク、コメントの作成と更新などのさまざまな共同作業イベントに登録して、内部ネットワークとパートナー ネットワークとのコミュニケーションを促進および強化します。

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