Pipedrive
Pipedrive는 중요한 작업에 집중하는 데 도움이 되는 CRM 및 파이프라인 관리 도구입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.pipedrive.com/ |
| 개인 정보 보호 정책 | https://www.pipedrive.com/privacy |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 120초 |
동작
| ID로 거래 가져오기 |
이 작업은 ID가 지정된 기존 거래의 모든 세부 정보를 검색합니다. |
| ID별 스테이지 가져오기 |
이 작업은 특정 단계에 대한 데이터를 반환합니다. |
| 거래 상태 업데이트 |
이 작업은 ID가 지정된 경우 거래와 연결된 상태를 업데이트하는 데 사용됩니다. |
| 거래 추가(V2)(미리 보기) |
이 작업은 권한 있는 계정에 대한 새 거래를 만듭니다. |
| 거래 추가 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 거래 추가(V2) 를 사용하세요.
|
| 업데이트 거래 단계(V2)(미리 보기) |
이 작업은 ID가 지정된 거래와 연결된 단계를 업데이트하는 데 사용됩니다. |
| 업데이트 거래 단계 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 거래 단계(V2) 를 사용하세요.
|
| 활동 추가 |
이 작업은 권한 있는 계정에 대한 새 활동을 만드는 데 사용됩니다. |
ID로 거래 가져오기
이 작업은 ID가 지정된 기존 거래의 모든 세부 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
거래 ID
|
dealId | True | integer |
거래 |
반환
데이터
ID별 스테이지 가져오기
이 작업은 특정 단계에 대한 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
스테이지 ID
|
stageId | True | integer |
스테이지 ID |
반환
거래 상태 업데이트
이 작업은 ID가 지정된 경우 거래와 연결된 상태를 업데이트하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
거래 ID
|
dealId | True | integer |
거래 |
|
상태
|
status | True | string |
거래의 상태입니다. |
|
잃어버린 이유
|
lost_reason | string |
거래가 손실된 이유에 대한 메시지입니다. |
반환
데이터
거래 추가(V2)(미리 보기)
이 작업은 권한 있는 계정에 대한 새 거래를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
제목
|
title | True | string |
거래의 제목입니다. |
|
파이프라인 ID
|
pipeline_id | string |
단계를 가져올 파이프라인의 ID입니다. |
|
|
스테이지 ID
|
stage_id | string |
거래의 단계. |
|
|
상태
|
status | string |
거래의 상태입니다. |
|
|
가치
|
value | integer |
거래의 현금 가치. |
|
|
통화
|
currency | string |
거래의 통화입니다. |
|
|
연락처 ID
|
person_id | string |
거래가 연결된 사용자의 사용자 ID입니다. |
|
|
조직 ID
|
org_id | string |
거래와 연결된 조직의 ID입니다. |
|
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
|
|
눈에 띄게
|
visible_to | string |
소유자, 팔로워 또는 회사 전체. |
반환
데이터
거래 추가 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 거래 추가(V2) 를 사용하세요.
이 작업은 권한 있는 계정에 대한 새 거래를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
제목
|
title | True | string |
거래의 제목입니다. |
|
스테이지 ID
|
stage_id | string |
거래의 단계. |
|
|
상태
|
status | string |
거래의 상태입니다. |
|
|
가치
|
value | integer |
거래의 현금 가치. |
|
|
통화
|
currency | string |
거래의 통화입니다. |
|
|
연락처 ID
|
person_id | string |
거래가 연결된 사용자의 사용자 ID입니다. |
|
|
조직 ID
|
org_id | string |
거래와 연결된 조직의 ID입니다. |
|
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
|
|
눈에 띄게
|
visible_to | string |
소유자, 팔로워 또는 회사 전체. |
반환
데이터
업데이트 거래 단계(V2)(미리 보기)
이 작업은 ID가 지정된 거래와 연결된 단계를 업데이트하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
거래 ID
|
dealId | True | integer |
거래 |
|
파이프라인 ID
|
pipeline_id | True | string |
단계를 가져올 파이프라인의 ID입니다. |
|
스테이지 ID
|
stage_id | True | string |
거래의 단계. |
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
반환
데이터
업데이트 거래 단계 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 거래 단계(V2) 를 사용하세요.
이 작업은 ID가 지정된 거래와 연결된 단계를 업데이트하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
거래 ID
|
dealId | True | integer |
거래 |
|
스테이지 ID
|
stage_id | True | string |
거래의 단계. |
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
반환
데이터
활동 추가
이 작업은 권한 있는 계정에 대한 새 활동을 만드는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
유형
|
type | True | string |
활동 유형입니다. |
|
주제
|
subject | True | string |
활동의 주체입니다. |
|
기한
|
due_date | string |
YYYY-MM-DD |
|
|
기한
|
due_time | string |
HH:MM |
|
|
기간
|
duration | string |
HH:MM |
|
|
비고
|
note | string | ||
|
할당 대상
|
user_id | integer |
활동이 할당될 사용자의 ID입니다. |
|
|
거래 ID
|
deal_id | integer |
활동이 연결된 거래의 ID입니다. |
|
|
연락처 ID
|
person_id | integer |
활동이 연결될 사람의 ID입니다. |
|
|
조직 ID
|
org_id | integer |
활동이 연결될 조직의 ID입니다. |
반환
데이터
트리거
| 새 거래가 추가되는 경우(V2)(미리 보기) |
새 거래가 권한 있는 계정(V2)에 추가될 때 트리거됩니다. |
| 새 거래가 추가되면 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 새 거래가 추가된 경우(V2)를 사용하세요.
|
| 새 활동이 추가되는 경우 |
새 활동이 권한 있는 계정에 추가될 때 트리거됩니다. |
새 거래가 추가되는 경우(V2)(미리 보기)
새 거래가 추가되면 [사용되지 않음]
새 활동이 추가되는 경우
정의
StageResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
스테이지 ID
|
id | integer |
스테이지 ID |
|
스테이지 이름
|
name | string |
스테이지 이름 |
ActivityResponse
데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
활동 ID
|
id | integer |
활동의 고유 ID입니다. |
|
사용자 ID
|
user_id | integer |
활동이 할당된 사용자의 ID입니다. |
|
완료
|
done | boolean |
0 = 완료되지 않음, 1 = 완료 |
|
유형
|
type | string |
활동의 형식입니다. |
|
기한
|
due_date | string |
YYYY-MM-DD |
|
기한
|
due_time | string |
HH:MM |
|
기간
|
duration | string |
HH:MM |
|
주제
|
subject | string |
활동의 주체입니다. |
|
거래 ID
|
deal_id | integer |
활동이 연결된 거래의 ID입니다. |
|
거래 제목
|
deal_title | string |
활동이 연결된 거래 제목입니다. |
|
조직 ID
|
org_id | integer |
활동이 연결된 조직의 ID입니다. |
|
조직 이름
|
org_name | string |
활동이 연결된 조직의 이름입니다. |
|
연락처 ID
|
person_id | integer |
활동이 연결된 사람의 ID입니다. |
|
담당자 이름
|
person_name | string |
활동이 연결된 사람의 이름입니다. |
|
만든 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
업데이트 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
완료된 Date-Time
|
marked_as_done_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Google Calendar 이벤트 ID
|
gcal_event_id | string |
Google 일정 이벤트의 ID입니다. |
|
Google 일정 ID
|
google_calendar_id | string |
Google 일정의 ID입니다. |
|
비고
|
note | string |
작업(HTML 형식)을 기록해 둡니다. |
|
할당 대상
|
assigned_to_user_id | integer |
활동이 할당된 사용자의 사용자 ID입니다. |
|
만든 사람:
|
created_by_user_id | integer |
활동을 만든 사용자의 사용자 ID입니다. |
|
소유자 이름
|
owner_name | string |
활동 소유자의 이름입니다. |
DealResponse
데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
거래 ID
|
id | integer |
거래의 ID입니다. |
|
아이디
|
creator_user_id.id | integer |
거래 작성자의 ID입니다. |
|
이름
|
creator_user_id.name | string |
거래 작성자의 이름입니다. |
|
전자 메일
|
creator_user_id.email | string |
거래 작성자의 이메일입니다. |
|
아이디
|
user_id.id | integer |
거래 소유자의 ID입니다. |
|
이름
|
user_id.name | string |
거래 소유자의 이름입니다. |
|
전자 메일
|
user_id.email | string |
거래 소유자의 전자 메일입니다. |
|
이름
|
person_id.name | string |
거래와 연결된 사람의 이름입니다. |
|
아이디
|
person_id.value | integer |
거래와 연결된 사용자의 ID입니다. |
|
이름
|
org_id.name | string |
거래와 연결된 조직의 이름입니다. |
|
아이디
|
org_id.value | integer |
거래와 연결된 조직의 ID입니다. |
|
상태
|
status | string |
열기, 승리, 분실 또는 삭제되었습니다. |
|
거래 제목
|
title | string |
거래의 제목입니다. |
|
거래 가치
|
value | number |
거래의 현금 가치. |
|
통화
|
currency | string |
거래 값과 관련된 통화입니다. |
|
만든 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
업데이트된 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
스테이지 ID
|
stage_id | integer |
거래가 파이프라인에 배치되는 단계의 ID입니다. |
|
스테이지 이름
|
stage_name | string |
파이프라인에 거래가 배치되는 단계의 이름 |
|
Uodated Date-Time 단계
|
stage_change_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
활성 상태
|
active | boolean |
거래가 활성 상태이면 True입니다. |
|
삭제됨
|
deleted | boolean |
거래가 삭제된 경우 True입니다. |
|
다음 활동 날짜
|
next_activity_date | string |
yyyy-MM-dd |
|
다음 활동 시간
|
next_activity_time | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
다음 활동 ID
|
next_activity_id | integer |
다음 활동의 ID입니다. |
|
마지막 활동 ID
|
last_activity_id | integer |
마지막 활동의 ID입니다. |
|
마지막 활동 날짜
|
last_activity_date | string |
yyyy-MM-dd |
|
잃어버린 이유
|
lost_reason | string |
거래가 손실된 이유에 대한 메시지입니다(status=lost일 때 사용됨). |
|
눈에 띄게
|
visible_to | string |
소유자, 팔로워 또는 회사 전체. |
|
닫힌 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
파이프라인 ID
|
pipeline_id | integer |
거래가 연결된 파이프라인의 ID입니다. |
|
제품 수
|
products_count | integer |
거래와 관련된 제품 수입니다. |
|
파일 수
|
files_count | integer |
거래와 연결된 파일 수입니다. |
|
노트 수
|
notes_count | integer |
거래와 관련된 메모 수입니다. |
|
팔로워 수
|
followers_count | integer |
거래와 관련된 팔로워 수입니다. |
|
전자 메일 메시지 수
|
email_messages_count | integer |
거래와 연결된 전자 메일 메시지 수입니다. |
|
활동 수
|
activities_count | integer |
거래와 관련된 활동 수입니다. |
|
완료된 활동 수
|
done_activities_count | integer |
거래와 관련된 완료된 활동 수입니다. |
|
작업 실행 취소 수
|
undone_activities_count | integer |
거래와 관련된 실행 취소 비활성화 횟수입니다. |
|
참조된 활동 수
|
reference_activities_count | integer |
거래와 관련된 참조된 활동 수입니다. |
|
참가자 수
|
participants_count | integer |
거래와 관련된 참가자 수입니다. |
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
|
다음 활동 제목
|
next_activity_subject | string |
거래와 관련된 다음 활동의 대상입니다. |
|
다음 활동 유형
|
next_activity_type | string |
거래와 관련된 다음 활동의 유형입니다. |
|
다음 활동 기간
|
next_activity_duration | string |
거래와 관련된 다음 활동 기간입니다. |
|
다음 작업 참고 사항
|
next_activity_note | string |
거래와 관련된 다음 활동에 대한 참고 사항 |
DealResponseV2
데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
거래 ID
|
id | integer |
거래의 ID입니다. |
|
아이디
|
creator_user_id.id | integer |
거래 작성자의 ID입니다. |
|
이름
|
creator_user_id.name | string |
거래 작성자의 이름입니다. |
|
전자 메일
|
creator_user_id.email | string |
거래 작성자의 이메일입니다. |
|
아이디
|
user_id.id | integer |
거래 소유자의 ID입니다. |
|
이름
|
user_id.name | string |
거래 소유자의 이름입니다. |
|
전자 메일
|
user_id.email | string |
거래 소유자의 전자 메일입니다. |
|
이름
|
person_id.name | string |
거래와 연결된 사람의 이름입니다. |
|
아이디
|
person_id.value | integer |
거래와 연결된 사용자의 ID입니다. |
|
이름
|
org_id.name | string |
거래와 연결된 조직의 이름입니다. |
|
아이디
|
org_id.value | integer |
거래와 연결된 조직의 ID입니다. |
|
상태
|
status | string |
열기, 승리, 분실 또는 삭제되었습니다. |
|
거래 제목
|
title | string |
거래의 제목입니다. |
|
거래 가치
|
value | number |
거래의 현금 가치. |
|
통화
|
currency | string |
거래 값과 관련된 통화입니다. |
|
만든 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
업데이트된 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
스테이지 ID
|
stage_id | integer |
거래가 파이프라인에 배치되는 단계의 ID입니다. |
|
Uodated Date-Time 단계
|
stage_change_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
활성 상태
|
active | boolean |
거래가 활성 상태이면 True입니다. |
|
삭제됨
|
deleted | boolean |
거래가 삭제된 경우 True입니다. |
|
다음 활동 날짜
|
next_activity_date | string |
yyyy-MM-dd |
|
다음 활동 시간
|
next_activity_time | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
다음 활동 ID
|
next_activity_id | integer |
다음 활동의 ID입니다. |
|
마지막 활동 ID
|
last_activity_id | integer |
마지막 활동의 ID입니다. |
|
마지막 활동 날짜
|
last_activity_date | string |
yyyy-MM-dd |
|
잃어버린 이유
|
lost_reason | string |
거래가 손실된 이유에 대한 메시지입니다(status=lost일 때 사용됨). |
|
눈에 띄게
|
visible_to | string |
소유자, 팔로워 또는 회사 전체. |
|
닫힌 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
파이프라인 ID
|
pipeline_id | integer |
거래가 연결된 파이프라인의 ID입니다. |
|
제품 수
|
products_count | integer |
거래와 관련된 제품 수입니다. |
|
파일 수
|
files_count | integer |
거래와 연결된 파일 수입니다. |
|
노트 수
|
notes_count | integer |
거래와 관련된 메모 수입니다. |
|
팔로워 수
|
followers_count | integer |
거래와 관련된 팔로워 수입니다. |
|
전자 메일 메시지 수
|
email_messages_count | integer |
거래와 연결된 전자 메일 메시지 수입니다. |
|
활동 수
|
activities_count | integer |
거래와 관련된 활동 수입니다. |
|
완료된 활동 수
|
done_activities_count | integer |
거래와 관련된 완료된 활동 수입니다. |
|
작업 실행 취소 수
|
undone_activities_count | integer |
거래와 관련된 실행 취소 비활성화 횟수입니다. |
|
참조된 활동 수
|
reference_activities_count | integer |
거래와 관련된 참조된 활동 수입니다. |
|
참가자 수
|
participants_count | integer |
거래와 관련된 참가자 수입니다. |
|
예상 마감 날짜
|
expected_close_date | string |
yyyy-MM-dd |
|
다음 활동 제목
|
next_activity_subject | string |
거래와 관련된 다음 활동의 대상입니다. |
|
다음 활동 유형
|
next_activity_type | string |
거래와 관련된 다음 활동의 유형입니다. |
|
다음 활동 기간
|
next_activity_duration | string |
거래와 관련된 다음 활동 기간입니다. |
|
다음 작업 참고 사항
|
next_activity_note | string |
거래와 관련된 다음 활동에 대한 참고 사항 |