다음을 통해 공유


Plumsail HelpDesk

API를 사용하면 Plumsail HelpDesk 티켓 시스템과 상호 작용할 수 있습니다. 자세한 내용을 보려면 방문 https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html 하세요.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Plumsail
URL https://plumsail.com/sharepoint-helpdesk
전자 메일 support@plumsail.com
커넥터 메타데이터
게시자 Plumsail Inc.
웹 사이트 https://plumsail.com
개인 정보 보호 정책 https://plumsail.com/privacy-policy/
카테고리 합작; 비즈니스 관리

이 커넥터를 사용하면 Power Automate의 도움을 받아 HelpDesk의 데이터를 조작할 수 있습니다.

자세한 내용을 보려면 방문 https://plumsail.com/helpdesk 하세요.

Plumsail HelpDesk Power Automate 비디오

필수 조건

사용을 시작하려면 다음 필수 조건을 완료해야 합니다.

그런 다음, API 키를 만든 후에는 첫 번째 흐름을 만들 준비가 됩니다.

흐름에서 "Plumsail HelpDesk"를 검색하고 적절한 작업을 추가하기만 하면 됩니다.

HelpDesk 작업 목록

처음으로 작업을 추가하면 다음에 대한 Connection NameAccess Key메시지가 표시됩니다. 연결의 이름을 입력할 수 있습니다. 예: Plumsail HelpDesk.

그런 다음, 첫 번째 단계에서 만든 API 키를 입력에 Access Key 붙여넣습니다.

흐름 연결 만들기

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유 가능

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API의 API 키 진실
데이터 센터 지역 문자열 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

ID로 단일 연락처 가져오기

ID로 연락처를 가져오고 재구성합니다.

단일 메모 가져오기

ID별로 주석을 가져오고 반환합니다.

단일 조직 가져오기

ID로 조직을 가져오고 반환합니다.

단일 티켓 가져오기

ID로 티켓을 가져오고 반환합니다.

메모 만들기

지정된 ID를 사용하여 티켓에 대한 새 주석을 만들고 반환합니다.

연락처 가져오기

연락처 목록 가져오기

연락처 만들기

새 연락처를 만들고 반환합니다.

연락처 삭제

ID로 연락처를 삭제합니다.

연락처 업데이트

ID로 연락처를 찾아 업데이트합니다. 업데이트된 연락처를 반환합니다.

전자 메일로 단일 연락처 가져오기

전자 메일로 연락처를 가져오고 반환합니다.

전자 메일로 연락처 업데이트

전자 메일로 연락처를 찾아 업데이트합니다. 업데이트된 연락처를 반환합니다.

제목으로 조직 삭제

제목별로 조직을 삭제합니다.

제목으로 조직 업데이트

제목별로 조직을 가져오고 업데이트합니다. 업데이트된 조직을 반환합니다.

조직 가져오기

조직 목록 가져오기

조직 만들기

조직 목록에서 새 항목을 만들고 반환합니다.

조직 삭제

ID별로 조직을 삭제합니다.

조직 업데이트

ID로 조직을 가져오고 반환합니다.

첨부 파일 다운로드

특정 티켓의 첨부 파일 이름을 반환하거나 오류 코드를 반환합니다.

타이틀별로 단일 조직 가져오기

제목별로 조직을 가져오고 반환합니다.

티켓 가져오기

TicketRead 개체 목록을 반환합니다. 각 TicketRead 개체에는 Category, Created, TicketID, Status, Requester 등의 필드가 있습니다. 자세한 내용은 TicketRead 개체 정의를 확인하세요.

티켓 만들기

새 티켓을 만들고 만든 티켓을 반환합니다.

티켓 삭제

ID별로 티켓을 삭제합니다.

티켓 업데이트

ID별로 티켓을 가져오고 업데이트합니다. 업데이트된 티켓을 반환합니다.

티켓에 대한 모든 의견 가져오기

지정된 ID를 가진 티켓에 대한 모든 주석을 가져옵니다.

ID로 단일 연락처 가져오기

ID로 연락처를 가져오고 재구성합니다.

매개 변수

Name 필수 형식 Description
연락처 ID
id True integer

연락처 ID

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

단일 메모 가져오기

ID별로 주석을 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
티켓 ID
ticketId True integer

티켓 ID

메모 ID
id True integer

주석 ID

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

단일 조직 가져오기

ID로 조직을 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
조직 ID
id True integer

조직 ID

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

단일 티켓 가져오기

ID로 티켓을 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
티켓 ID
id True integer

티켓 ID

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

메모 만들기

지정된 ID를 사용하여 티켓에 대한 새 주석을 만들고 반환합니다.

매개 변수

Name 필수 형식 Description
AttachmentContent
AttachmentContent True binary

File Content(파일 내용)

첨부 파일 이름
Name True string
주석 본문
body True string
사용자 지정 필드 주석 지정
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

메모 작성자 전자 메일
fromEmail True string
MessageId 주석
messageId string
티켓 ID
ticketId True integer

티켓 ID

반환

연락처 가져오기

연락처 목록 가져오기

매개 변수

Name 필수 형식 Description
$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다. 전화 번호를 포함하려면 $select=PhoneNumber,Title,Email,ID를 사용합니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

$필터
$filter string

ODATA $filter 옵션을 사용하여 필요한 연락처를 찾습니다. 예를 들어 $filter=Title eq 'Bill Gates'를 사용하여 전체 이름으로 사람을 찾습니다. $filter=substringof('@DOMAIN', 전자 메일)를 사용하여 도메인에서 전자 메일이 있는 사람 찾기(DOMAIN)

$orderBy
$orderBy string

항목 순서를 지정하기 위한 ODATA $orderBy 쿼리 옵션입니다.

$top
$top integer

반환 집합의 첫 번째 n 항목을 선택하는 ODATA $top 쿼리 옵션입니다(기본값 = 50, 최대 = 100).

$skiptoken
$skiptoken string

지정된 항목에 도달할 때까지 항목을 건너뛰고 나머지는 반환하는 ODATA $skiptoken 쿼리 옵션입니다.

반환

연락처 만들기

새 연락처를 만들고 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 필드에 문의
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

전자 메일에 문의
email True string
대체 전자 메일에 문의
emailAlternate string
연락처 역할
role string
SPUserId에 문의
spUserId integer
담당자 이름
title True string
연락처 업데이트(있는 경우)
updateIfExists boolean

연락처가 이미 있는 경우 연락처 업데이트

반환

연락처 삭제

ID로 연락처를 삭제합니다.

매개 변수

Name 필수 형식 Description
연락처 ID
id True integer

연락처 ID

연락처 업데이트

ID로 연락처를 찾아 업데이트합니다. 업데이트된 연락처를 반환합니다.

매개 변수

Name 필수 형식 Description
연락처 ID
id True integer

연락처 ID

사용자 지정 필드에 문의
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

전자 메일에 문의
email True string
대체 전자 메일에 문의
emailAlternate string
연락처 역할
role string
SPUserId에 문의
spUserId integer
담당자 이름
title True string

반환

전자 메일로 단일 연락처 가져오기

전자 메일로 연락처를 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
전자 메일에 문의
email True string

전자 메일에 문의

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

전자 메일로 연락처 업데이트

전자 메일로 연락처를 찾아 업데이트합니다. 업데이트된 연락처를 반환합니다.

매개 변수

Name 필수 형식 Description
전자 메일에 문의
email True string

연락처 메일

사용자 지정 필드에 문의
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

전자 메일에 문의
email True string
대체 전자 메일에 문의
emailAlternate string
연락처 역할
role string
SPUserId에 문의
spUserId integer
담당자 이름
title True string

반환

제목으로 조직 삭제

제목별로 조직을 삭제합니다.

매개 변수

Name 필수 형식 Description
조직 제목
title True string

조직 제목

제목으로 조직 업데이트

제목별로 조직을 가져오고 업데이트합니다. 업데이트된 조직을 반환합니다.

매개 변수

Name 필수 형식 Description
조직 제목
title True string

조직 제목

조직 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

조직 제목
title True string

반환

조직 가져오기

조직 목록 가져오기

매개 변수

Name 필수 형식 Description
$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

$필터
$filter string

반환된 항목을 제한하는 ODATA $filter 쿼리 옵션

$orderBy
$orderBy string

항목 순서를 지정하기 위한 ODATA $orderBy 쿼리 옵션입니다.

$top
$top integer

반환 집합의 첫 번째 n 항목을 선택하는 ODATA $top 쿼리 옵션입니다(기본값 = 50, 최대 = 100).

$skiptoken
$skiptoken string

지정된 항목에 도달할 때까지 항목을 건너뛰고 나머지는 반환하는 ODATA $skiptoken 쿼리 옵션입니다.

반환

조직 만들기

조직 목록에서 새 항목을 만들고 반환합니다.

매개 변수

Name 필수 형식 Description
조직 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

조직 제목
title True string

반환

조직 삭제

ID별로 조직을 삭제합니다.

매개 변수

Name 필수 형식 Description
조직 ID
id True integer

조직 ID

조직 업데이트

ID로 조직을 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
조직 ID
id True integer

조직 ID

조직 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

조직 제목
title True string

반환

첨부 파일 다운로드

특정 티켓의 첨부 파일 이름을 반환하거나 오류 코드를 반환합니다.

매개 변수

Name 필수 형식 Description
티켓 ID
id True integer

티켓 ID

첨부 파일 이름
filename True string

첨부 파일 이름

반환

결과 파일
binary

타이틀별로 단일 조직 가져오기

제목별로 조직을 가져오고 반환합니다.

매개 변수

Name 필수 형식 Description
조직 제목
title True string

조직 제목

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

반환

티켓 가져오기

TicketRead 개체 목록을 반환합니다. 각 TicketRead 개체에는 Category, Created, TicketID, Status, Requester 등의 필드가 있습니다. 자세한 내용은 TicketRead 개체 정의를 확인하세요.

매개 변수

Name 필수 형식 Description
$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

$필터
$filter string

ODATA $filter 쿼리 옵션입니다. 예를 들어 $filter=Status/Title eq STATUS 또는 $filter=Status/Title ne STATUS(STATUS는 '보류 중', '새로 만들기', '진행 중', '해결됨' 등일 수 있음)를 사용하여 특정 상태를 사용하여 티켓을 얻거나, $filter=Status/Title ne Solved를 사용하여 활성 티켓을 얻거나, $filter=Created gt gt '2023-08-18'을 사용하여 특정 날짜 이후에 티켓을 만듭니다. 범주 필드를 사용하여 범주별로 필터링하고, AssignedTo/Email을 사용하여 할당자 전자 메일을 필터링하고, AssignedTo/Title을 사용하여 할당자 이름을 필터링합니다. $filter=substringof('@DOMAIN', Requester/Email)를 사용하여 도메인(도메인)에서 전자 메일이 있는 사람을 찾습니다. 기한이 지난 티켓은 DueDate가 현재보다 적은 활성 티켓입니다.

$orderBy
$orderBy string

항목 순서를 지정하기 위한 ODATA $orderBy 쿼리 옵션입니다.

$top
$top integer

반환 집합의 첫 번째 n 항목을 선택하는 ODATA $top 쿼리 옵션입니다(기본값 = 50, 최대 = 100).

$skiptoken
$skiptoken string

지정된 항목에 도달할 때까지 항목을 건너뛰고 나머지는 반환하는 ODATA $skiptoken 쿼리 옵션입니다.

반환

티켓 만들기

새 티켓을 만들고 만든 티켓을 반환합니다.

매개 변수

Name 필수 형식 Description
티켓 담당자 전자 메일 또는 SharePoint 그룹 이름
assignedToEmail string
AttachmentContent
AttachmentContent True binary

File Content(파일 내용)

첨부 파일 이름
Name True string
티켓 본문
body True string
티켓 범주
category string
티켓 참조 전자 메일
ccEmails array of string
티켓 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

Ticket DueDate
dueDate date-time
티켓 우선 순위
priority string
티켓 요청자 전자 메일
requesterEmail True string
티켓 상태
status string
티켓 제목
subject True string
Ticket SupportChannel
supportChannel string
티켓 태그 제목
tagTitles array of string

반환

티켓 삭제

ID별로 티켓을 삭제합니다.

매개 변수

Name 필수 형식 Description
티켓 ID
id True integer

티켓 ID

티켓 업데이트

ID별로 티켓을 가져오고 업데이트합니다. 업데이트된 티켓을 반환합니다.

매개 변수

Name 필수 형식 Description
티켓 ID
id True integer

티켓 ID

티켓 담당자 전자 메일 또는 SharePoint 그룹 이름
assignedToEmail string
AttachmentContent
AttachmentContent True binary

File Content(파일 내용)

첨부 파일 이름
Name True string
티켓 본문
body True string
티켓 범주
category string
티켓 참조 전자 메일
ccEmails array of string
티켓 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

Ticket DueDate
dueDate date-time
티켓 우선 순위
priority string
티켓 요청자 전자 메일
requesterEmail True string
티켓 상태
status string
티켓 제목
subject True string
Ticket SupportChannel
supportChannel string
티켓 태그 제목
tagTitles array of string

반환

티켓에 대한 모든 의견 가져오기

지정된 ID를 가진 티켓에 대한 모든 주석을 가져옵니다.

매개 변수

Name 필수 형식 Description
티켓 ID
ticketId True integer

티켓 ID

$select
$select string

목록 항목에 대해 반환할 필드를 지정하는 ODATA $select 쿼리 옵션입니다. *를 사용하여 사용 가능한 모든 필드를 반환할 수 있습니다.

$expand
$expand string

요청이 조회 값을 반환하도록 지정하는 ODATA $expand 쿼리 옵션입니다.

$필터
$filter string

반환된 항목을 제한하는 ODATA $filter 쿼리 옵션

$orderBy
$orderBy string

항목 순서를 지정하기 위한 ODATA $orderBy 쿼리 옵션입니다.

반환

정의

담당자

Name 경로 형식 Description
담당자 CustomFields
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

담당자 전자 메일
email string
담당자 대체 전자 메일
emailAlternate string
담당자 ID
id integer
담당자 역할
role string
담당자 SPUserId
spUserId integer
담당자 전체 이름
title string

Cc

Name 경로 형식 Description
Cc CustomFields
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

참조 전자 메일
email string
참조 대체 전자 메일
emailAlternate string
참조 ID
id integer
참조 역할
role string
Cc SPUserId
spUserId integer
참조 전체 이름
title string

CommentRead

Name 경로 형식 Description
주석 본문
body string
메모 만들기 날짜
created date-time
사용자 지정 필드 주석 지정
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

메모 작성자 전자 메일
fromEmail string
주석 작성자 이름
fromName string
주석 ID
id integer
MessageId 주석
messageId string

ContactRead

Name 경로 형식 Description
사용자 지정 필드에 문의
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

전자 메일에 문의
email string
대체 전자 메일에 문의
emailAlternate string
접촉 ID
id integer
연락처 역할
role string
SPUserId에 문의
spUserId integer
연락처 전체 이름
title string

OrganizationRead

Name 경로 형식 Description
조직 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

조직 ID
id integer
조직 제목
title string

요청자

Name 경로 형식 Description
요청자 CustomFields
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

요청자 전자 메일
email string
요청자 대체 전자 메일
emailAlternate string
요청자 ID
id integer
요청자 역할
role string
요청자 SPUserId
spUserId integer
요청자 전체 이름
title string

TagRead

Name 경로 형식 Description
태그 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

태그 ID
id integer
태그 제목
title string

TicketRead

Name 경로 형식 Description
티켓 담당자
assignedTo Assignee
티켓 첨부 파일
attachments array of string
티켓 범주
category string
티켓 참조
cc array of Cc
티켓 생성 날짜
created date-time
티켓 사용자 지정 필드
customFields object

사용자 지정 필드 값이 포함된 JSON 문자열

티켓 기한
dueDate date-time
티켓 ID
id integer
티켓 우선 순위
priority string
티켓 요청자
requester Requester
티켓 확인 날짜
resolutionDate date-time
티켓 상태
status string
티켓 제목
subject string
티켓 태그
tags array of TagRead
사용자 지정 티켓 ID
ticketID string

이진법

기본 데이터 형식 'binary'입니다.