WorkSpan
WorkSpan은 파트너와 함께 수익을 계획, 실행 및 추진하기 위한 공동 작업 플랫폼입니다. WorkSpan에서 파트너 프로그램 및 파트너 이니셔티브를 관리하고 내부 및 파트너 애플리케이션과 원활하게 연결합니다. CRM, 파트너 센터, 협업 도구 및 생산성 도구를 WorkSpan에 통합할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | WorkSpan API 지원 |
| URL | https://support.workspan.com |
| 전자 메일 | api-team@workspan.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | WorkSpan |
| 웹 사이트 | https://www.workspan.com |
| 카테고리 | 마케팅; 판매 및 CRM |
| 개인 정보 보호 정책 | 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
알려진 문제 및 제한 사항
알려진 문제 없음
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 환경: 샌드박스 또는 프로덕션 | 문자열 | 샌드박스 환경 또는 프로덕션 환경 | 진실 |
| 애플리케이션 사용자 ID | 문자열 | WorkSpan 애플리케이션 사용자의 ID | 진실 |
| 애플리케이션 사용자 암호 | 시큐어스트링 (보안 문자열) | 애플리케이션 사용자 암호 | 진실 |
| WorkSpan 앱 호스트 이름입니다. 예: demo.workspan.com /app.workspan.com | 문자열 | 호스트 이름 입력(https 제외) 예제: demo.workspan.com/app.workspan.com | 진실 |
| 비고 | 문자열 | 연결에 대한 참고 사항 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
|
Work |
외부 애플리케이션의 기본 고유 식별자 가져오기 |
|
Work |
외부 애플리케이션의 기본 고유 식별자를 사용하여 WorkSpan 개체 업데이트 |
|
Work |
WorkSpanObject에 감사 정보 추가 |
| 대량 로드 기회(본문의 데이터) |
입력 데이터를 요청 본문으로 통합에 업로드합니다. 허용되는 형식은 .csv .json |
| 대량 로드 기회(첨부 파일) |
통합에 입력 파일을 업로드합니다. 허용되는 형식은 .xlsx, .json 및 .csv |
| 대량 로드 작업의 상태 가져오기 |
대량 로드 작업의 상태 가져오기 |
| 데이터 대량 로드(본문의 데이터) |
입력 데이터를 요청 본문으로 통합에 업로드합니다. 허용되는 형식은 .csv .json |
| 데이터 대량 로드(첨부 파일) |
통합에 입력 파일을 업로드합니다. 허용되는 형식은 .xlsx, .json 및 .csv |
| 보고서 데이터 읽기 |
보고서 데이터 읽기 |
| 보고서 목록 가져오기 |
보고서 나열 |
WorkSpan ID에 대한 외부 ID 가져오기
외부 애플리케이션의 기본 고유 식별자 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
WorkSpan 개체의 개체 ID(긴 ID)
|
object_id | True | string |
WorkSpan 개체의 개체 ID(긴 ID) |
반환
WorkSpan ID에 외부 ID 연결
외부 애플리케이션의 기본 고유 식별자를 사용하여 WorkSpan 개체 업데이트
매개 변수
| Name | 키 | 필수 | 형식 | 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 |
외부 시스템의 ID(예: CRM) |
반환
WorkSpan 개체에 감사 정보 추가
WorkSpanObject에 감사 정보 추가
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
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
|
message | True | string |
감사 로그에 기록하기 위한 추가 정보 |
|
WorkSpan 개체 ID(긴 ID)
|
object_id | True | string |
통합 상태로 업데이트할 WorkSpan 개체의 개체 ID(긴 ID) |
반환
대량 로드 기회(본문의 데이터)
입력 데이터를 요청 본문으로 통합에 업로드합니다. 허용되는 형식은 .csv .json
매개 변수
| Name | 키 | 필수 | 형식 | 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
매개 변수
| Name | 키 | 필수 | 형식 | 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 |
업로드할 파일 |
반환
대량 로드 작업의 상태 가져오기
대량 로드 작업의 상태 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
통합 ID
|
integration_id | True | string |
통합 ID |
|
실행 ID(반환된 bu bulkload 단계)
|
execution_id | True | string |
대량 API에서 반환되는 통합 실행의 실행 ID |
|
오류가 있는 경우 응답에 오류 포함
|
include_errors | boolean |
오류가 있는 경우 응답에 오류 포함 |
|
|
응답에서 다시 반환할 최대 오류 수
|
max_errors | number |
응답에서 다시 반환할 최대 오류 수 |
반환
데이터 대량 로드(본문의 데이터)
입력 데이터를 요청 본문으로 통합에 업로드합니다. 허용되는 형식은 .csv .json
매개 변수
| Name | 키 | 필수 | 형식 | 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 } ] |
반환
데이터 대량 로드(첨부 파일)
통합에 입력 파일을 업로드합니다. 허용되는 형식은 .xlsx, .json 및 .csv
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
WorkSpan에서 구성된 통합 선택
|
integration_id | True | string |
WorkSpan에서 구성된 CRM 상호 연결의 통합 ID |
|
데이터 서식을 지정합니다. 허용되는 형식은 .csv .xlsx .json
|
data_format | string |
데이터 서식을 지정합니다. 허용되는 형식은 .csv .xlsx .json |
|
|
업로드할 파일
|
file | True | file |
업로드할 파일 |
반환
보고서 데이터 읽기
보고서 데이터 읽기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보고서 ID
|
reportId | True | integer |
보고서 ID |
|
colId
|
colId | string | ||
|
부정하다
|
negate | boolean | ||
|
op
|
op | string | ||
|
type
|
type | string | ||
|
op
|
op | string | ||
|
숫자
|
number | True | integer | |
|
size
|
size | True | integer |
반환
보고서 목록 가져오기
보고서 나열
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
숫자
|
number | integer |
숫자 |
|
|
size
|
size | integer |
size |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
아이디 |
|
이름
|
name | string |
이름 |
트리거
|
Work |
기회의 생성 및 업데이트와 같은 다양한 개체 이벤트를 구독하여 파트너 영향의 가시성을 높입니다. |
|
Work |
멤버 자격, 작업 및 메모에 대한 생성 및 업데이트와 같은 다양한 공동 작업 이벤트를 구독하여 내부 및 파트너 네트워크와의 통신을 촉진하고 향상시킵니다. |
|
Work |
이 트리거는 WorkSpan 사용자가 Microsoft 파트너 센터에 기회를 제출하도록 요청하면 발생합니다. |
WorkSpan 개체 이벤트 구독
기회의 생성 및 업데이트와 같은 다양한 개체 이벤트를 구독하여 파트너 영향의 가시성을 높입니다.
매개 변수
| Name | 키 | 필수 | 형식 | 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 |
이벤트에 대한 필터 |
반환
WorkSpan 협업 이벤트 구독
멤버 자격, 작업 및 메모에 대한 생성 및 업데이트와 같은 다양한 공동 작업 이벤트를 구독하여 내부 및 파트너 네트워크와의 통신을 촉진하고 향상시킵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이벤트 이름
|
event | True | string | |
|
구독자 이름
|
name | True | string |
웹후크에 할당된 이름 |
|
WorkSpan 개체 ID
|
object_ids | array of string |
웹후크가 등록된 개체 ID |
|
|
필터 예제: (stage in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
이벤트에 대한 필터 |
반환
WorkSpan에서 Microsoft 파트너 센터에 조회 제출
이 트리거는 WorkSpan 사용자가 Microsoft 파트너 센터에 기회를 제출하도록 요청하면 발생합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이름
|
name | True | string |
이벤트 구독자의 이름 |
|
WorkSpan에서 구성된 통합 선택
|
integration_id | True | string |
반환
정의
bulkload_opportunity_response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
통합 ID |
|
execution_id
|
execution_id | string |
실행 ID |
|
생성_시간
|
created_at | date-time |
생성 시간 |
bulkload_response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
통합 ID |
|
execution_id
|
execution_id | string |
실행 ID |
|
data_format
|
data_format | string |
데이터 형식 |
|
생성_시간
|
created_at | date-time |
생성 시간 |
bulkload_status_response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
통합 ID |
|
execution_id
|
execution_id | string |
실행 ID |
|
status
|
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 | |
|
message
|
errors.message | string |
오류 메시지 |
|
아이디
|
errors.id | string |
실패한 레코드의 ID |
|
data_row
|
errors.data_row | string |
실패한 데이터 행 |
external_id_response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
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
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
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
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
업데이트된 WorkSpan 개체 ID(긴 ID) |
|
field_name
|
field_name | string |
업데이트된 WorkSpan 필드의 이름 |
|
status_code
|
status_code | string |
업데이트 상태 |
ReportDataResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
version
|
version | integer |