다음을 통해 공유

Freshservice(미리 보기)

Freshservice는 조직 전체에서 직원 환경을 변환하기 위해 설정하고 사용하기 쉬운 클라우드 기반 IT 서비스 데스크 및 서비스 관리 솔루션입니다.

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

서비스 클래스 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)
연락처
이름 Freshworks 앱 지원
URL https://www.freshworks.com
전자 메일 appsupport-ex@freshworks.com
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://www.freshworks.com/freshservice/lp/home/
개인 정보 보호 정책 https://www.freshworks.com/privacy
카테고리 IT 운영

Authentication

중요합니다

사용자 이름 및 암호 기반 인증은 FreshService에서 더 이상 지원되지 않습니다. 이제 커넥터는 하나의 인증 유형인 API 키만 지원합니다. FreshService API 마이그레이션 문서

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
API 키 API 키 인증 유형 모든 지역 공유할 수 없음
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유할 수 없음

API 키

인증 ID: 기본

적용 가능: 모든 지역

API 키 인증 유형

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 문자열 이 API의 API 키 진실
사이트 URL 문자열 루트 사이트 URL(예: https://sample.freshservice.com ) 진실

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
사용자 이름 문자열 이 API의 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실
사이트 URL 문자열 루트 사이트 URL(예: https://sample.freshservice.com ) 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초
트리거 폴링 빈도 1 120초

동작

티켓 만들기(V2)

티켓을 만듭니다.
티켓 만들기 [사용되지 않음]

티켓을 만듭니다.
티켓 업데이트(V2)

티켓을 업데이트합니다(지정된 값만 업데이트됨).
티켓 업데이트 [사용되지 않음]

티켓을 업데이트합니다(지정된 값만 업데이트됨).
티켓에 메모 추가(V2)

티켓에 비공개 또는 공개 메모를 추가합니다.
티켓에 메모 추가 [사용되지 않음]

티켓에 비공개 또는 공개 메모를 추가합니다.

티켓 만들기(V2)

작업 ID:
CreateTicketV2

티켓을 만듭니다.

매개 변수

Name 키 필수 형식 Description
요청자 ID
 requester_id integer

요청자의 사용자 ID입니다. 요청자 ID, 요청자 전자 메일 및 요청자 전화 중 하나가 필요합니다.
요청자 전자 메일
 email string

요청자의 전자 메일입니다. 요청자 ID, 요청자 전자 메일 및 요청자 전화 중 하나가 필요합니다.
요청자 전화
 phone string

요청자의 전화 번호입니다. 요청자 ID, 요청자 전자 메일 및 요청자 전화 중 하나가 필요합니다.
요청자 이름
 name string

요청자의 이름입니다. 요청자 전화 값이 제공된 경우에만 필수 필드입니다.
주제
 subject True string

티켓의 제목입니다.
상태
 status True string

티켓의 상태입니다.
Priority
 priority True string

티켓의 우선 순위(예: 낮음, 보통 또는 높음)입니다.
Description
 description True string

티켓에 대한 설명입니다.
긴급도
 urgency string

문제의 긴급성(예: 낮음, 보통 또는 높음).
Impact
 impact string

문제의 영향(예: 낮음, 보통 또는 높음).
출처
 source string

티켓을 만든 채널입니다.

반환

몸
CreateUpdateTicket_ResponseV2

티켓 만들기 [사용되지 않음]

작업 ID:
CreateTicket

티켓을 만듭니다.

매개 변수

Name 키 필수 형식 Description
요청자 ID
 requester_id True integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
주제
 subject True string

티켓의 제목입니다.
상태
 status True string

티켓의 상태입니다.
Priority
 priority True string

티켓의 우선 순위(예: 낮음, 보통 또는 높음)입니다.
Description
 description True string

티켓에 대한 설명입니다.
긴급도
 urgency string

문제의 긴급성(예: 낮음, 보통 또는 높음).
Impact
 impact string

문제의 영향(예: 낮음, 보통 또는 높음).
출처
 source string

티켓을 만든 채널입니다.

반환

Name 경로 형식 Description
helpdesk_ticket
 item.helpdesk_ticket Ticket_Response

티켓 업데이트(V2)

작업 ID:
UpdateTicketV2

티켓을 업데이트합니다(지정된 값만 업데이트됨).

매개 변수

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

업데이트할 티켓 ID입니다.
요청자 ID
 requester_id integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
주제
 subject string

티켓의 제목입니다.
상태
 status string

티켓의 상태입니다.
Priority
 priority string

티켓의 우선 순위(예: 낮음, 보통 또는 높음)입니다.
긴급도
 urgency string

문제의 긴급성(예: 낮음, 보통 또는 높음).
Impact
 impact string

문제의 영향(예: 낮음, 보통 또는 높음).
출처
 source string

티켓을 만든 채널입니다.

반환

몸
CreateUpdateTicket_ResponseV2

티켓 업데이트 [사용되지 않음]

작업 ID:
UpdateTicket

티켓을 업데이트합니다(지정된 값만 업데이트됨).

매개 변수

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

업데이트할 티켓 ID입니다.
요청자 ID
 requester_id integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
주제
 subject string

티켓의 제목입니다.
상태
 status string

티켓의 상태입니다.
Priority
 priority string

티켓의 우선 순위(예: 낮음, 보통 또는 높음)입니다.
긴급도
 urgency string

문제의 긴급성(예: 낮음, 보통 또는 높음).
Impact
 impact string

문제의 영향(예: 낮음, 보통 또는 높음).
출처
 source string

티켓을 만든 채널입니다.

반환

몸
UpdateTicket_Response

티켓에 메모 추가(V2)

작업 ID:
AddNoteV2

티켓에 비공개 또는 공개 메모를 추가합니다.

매개 변수

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

업데이트할 티켓 ID입니다.
비고
 body True string

티켓에 추가할 메모입니다.
비공개임
 private boolean

메시지가 비공개인 경우 true로 설정합니다.

반환

몸
AddNote_ResponseV2

티켓에 메모 추가 [사용되지 않음]

작업 ID:
AddNote

티켓에 비공개 또는 공개 메모를 추가합니다.

매개 변수

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

업데이트할 티켓 ID입니다.
비고
 body True string

티켓에 추가할 메모입니다.
비공개임
 private boolean

메시지가 비공개인 경우 true로 설정합니다.

반환

몸
AddNote_Response

트리거

티켓이 만들어지는 경우(V2)

새 티켓을 만들 때 트리거됩니다.
티켓이 만들어지는 경우 [사용되지 않음]

새 티켓을 만들 때 트리거됩니다.

티켓이 만들어지는 경우(V2)

작업 ID:
OnTicketCreatedV2

새 티켓을 만들 때 트리거됩니다.

반환

몸
ListTicket_ResponseV2

티켓이 만들어지는 경우 [사용되지 않음]

작업 ID:
OnTicketCreated

새 티켓을 만들 때 트리거됩니다.

반환

몸
Ticket_Response

정의

Ticket_Response

Name 경로 형식 Description
만든 Date-Time
 created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
삭제됨
 deleted boolean

티켓이 삭제/휴지통되면 true로 설정합니다. 삭제된 티켓은 '삭제된' 필터를 제외한 모든 보기에서 고려되지 않습니다.
부서 ID
 department_id_value integer
티켓 ID
 display_id integer

계정과 관련된 티켓 ID입니다.
기한: Date-Time
 due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ
그룹 ID
 group_id integer

티켓이 할당된 그룹의 ID입니다.
아이디
 id integer

티켓의 고유 ID입니다.
Impact
 impact integer

문제의 영향을 나타내는 숫자입니다.
에스컬레이션됨
 isescalated boolean

에스컬레이션이 전송된 경우 true로 설정합니다.
소유자 ID
 owner_id string

문제가 할당된 에이전트의 ID입니다.
Priority
 priority integer

티켓의 우선 순위를 나타내는 숫자입니다.
요청자 ID
 requester_id integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
응답자 ID
 responder_id integer

티켓이 할당된 에이전트의 ID입니다.
출처
 source integer

티켓을 만든 채널을 나타내는 숫자입니다.
스팸
 spam boolean

티켓이 스팸으로 표시된 경우 true로 설정합니다.
상태
 status integer

티켓의 상태를 나타내는 숫자입니다.
주제
 subject string

티켓 제목입니다.
티켓 종류
 ticket_type string

티켓 필드에 정의된 대로 속성 필드를 입력합니다.
전자 메일로
 to_email string

들어오는 티켓 전자 메일이 전송된 전자 메일 주소입니다.
Date-Time 업데이트됨
 updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
긴급도
 urgency integer

문제의 긴급성을 나타내는 숫자입니다.
Description
 description string

문제에 대한 설명입니다.
설명 HTML
 description_html string

티켓의 HTML 콘텐츠입니다. 설명 및 description_html 함께 전달하면 안 됩니다.
상태 이름
 status_name string

티켓의 상태입니다.
우선 순위 이름
 priority_name string

티켓의 우선 순위입니다.
원본 이름
 source_name string

티켓을 만든 채널입니다.
응답자 이름
 responder_name string

티켓이 할당된 에이전트의 이름입니다.
전자 메일로
 to_emails array of string

들어오는 티켓 전자 메일이 전송된 전자 메일 주소입니다.
부서 이름
 department_name string

부서의 이름입니다.
연결된 문제 ID
 assoc_problem_id integer

티켓과 관련된 문제의 ID입니다.
연결된 변경 ID
 assoc_change_id integer

문제와 관련된 변경 내용의 ID입니다.
연결된 변경 원인 ID
 assoc_change_cause_id integer

티켓을 발생시키는 변경의 ID입니다.
연결된 자산 ID
 assoc_asset_id integer

티켓에 연결된 자산의 ID입니다.
긴급 이름
 urgency_name string

문제의 긴급성.
영향 이름
 impact_name string

문제의 영향입니다.

CreateUpdateTicket_ResponseV2

Name 경로 형식 Description
만든 Date-Time
 ticket.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
부서 ID
 ticket.department_id integer
기한: Date-Time
 ticket.due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ
그룹 ID
 ticket.group_id integer

티켓이 할당된 그룹의 ID입니다.
아이디
 ticket.id integer

티켓의 고유 ID입니다.
에스컬레이션됨
 ticket.is_escalated boolean

에스컬레이션이 전송된 경우 true로 설정합니다.
Priority
 ticket.priority integer

티켓의 우선 순위를 나타내는 숫자입니다.
요청자 ID
 ticket.requester_id integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
응답자 ID
 ticket.responder_id integer

티켓이 할당된 에이전트의 ID입니다.
출처
 ticket.source integer

티켓을 만든 채널을 나타내는 숫자입니다.
스팸
 ticket.spam boolean

티켓이 스팸으로 표시된 경우 true로 설정합니다.
상태
 ticket.status integer

티켓의 상태를 나타내는 숫자입니다.
주제
 ticket.subject string

티켓 제목입니다.
티켓 종류
 ticket.type string

티켓 필드에 정의된 대로 속성 필드를 입력합니다.
Date-Time 업데이트됨
 ticket.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Description
 ticket.description_text string

문제에 대한 설명입니다.
설명 HTML
 ticket.description string

티켓의 HTML 콘텐츠입니다. 설명 및 description_html 함께 전달하면 안 됩니다.
전자 메일로
 ticket.to_emails array of string

들어오는 티켓 전자 메일이 전송된 전자 메일 주소입니다.

ListTicket_ResponseV2

Name 경로 형식 Description
만든 Date-Time
 created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
부서 ID
 department_id integer
기한: Date-Time
 due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ
그룹 ID
 group_id integer

티켓이 할당된 그룹의 ID입니다.
아이디
 id integer

티켓의 고유 ID입니다.
에스컬레이션됨
 is_escalated boolean

에스컬레이션이 전송된 경우 true로 설정합니다.
Priority
 priority integer

티켓의 우선 순위를 나타내는 숫자입니다.
요청자 ID
 requester_id integer

요청자의 사용자 ID입니다. 기존 연락처의 경우 전자 메일 대신 requester_id 전달할 수 있습니다.
응답자 ID
 responder_id integer

티켓이 할당된 에이전트의 ID입니다.
출처
 source integer

티켓을 만든 채널을 나타내는 숫자입니다.
스팸
 spam boolean

티켓이 스팸으로 표시된 경우 true로 설정합니다.
상태
 status integer

티켓의 상태를 나타내는 숫자입니다.
주제
 subject string

티켓 제목입니다.
티켓 종류
 type string

티켓 필드에 정의된 대로 속성 필드를 입력합니다.
Date-Time 업데이트됨
 updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Description
 description_text string

문제에 대한 설명입니다.
설명 HTML
 description string

티켓의 HTML 콘텐츠입니다. 설명 및 description_html 함께 전달하면 안 됩니다.
전자 메일로
 to_emails array of string

들어오는 티켓 전자 메일이 전송된 전자 메일 주소입니다.

UpdateTicket_Response

Name 경로 형식 Description
삭제됨
 ticket.deleted boolean

티켓이 삭제/휴지통되면 true로 설정합니다. 삭제된 티켓은 '삭제된' 필터를 제외한 모든 보기에서 고려되지 않습니다.
티켓 ID
 ticket.display_id integer

계정과 관련된 티켓 ID입니다.
주제
 ticket.subject string

티켓 제목입니다.
Description
 ticket.description string

티켓에 대한 설명입니다.
설명 HTML
 ticket.description_html string

티켓의 HTML 콘텐츠입니다. 설명 및 description_html 함께 전달하면 안 됩니다.
상태 이름
 ticket.status_name string

티켓의 상태입니다.
우선 순위 이름
 ticket.priority_name string

티켓의 우선 순위입니다.
원본 이름
 ticket.source_name string

티켓을 만든 채널입니다.
응답자 이름
 ticket.responder_name string

티켓이 할당된 에이전트의 이름입니다.
전자 메일로
 ticket.to_emails array of string

들어오는 티켓 전자 메일이 전송된 전자 메일 주소입니다.
부서 이름
 ticket.department_name string

부서의 이름입니다.
연결된 문제 ID
 ticket.assoc_problem_id integer

티켓과 관련된 문제의 ID입니다.
연결된 변경 ID
 ticket.assoc_change_id integer

문제와 관련된 변경 내용의 ID입니다.
연결된 변경 원인 ID
 ticket.assoc_change_cause_id integer

티켓을 발생시키는 변경의 ID입니다.
연결된 자산 ID
 ticket.assoc_asset_id integer

티켓에 연결된 자산의 ID입니다.
긴급 이름
 ticket.urgency_name string

문제의 긴급성.
영향 이름
 ticket.impact_name string

문제의 영향입니다.

AddNote_Response

Name 경로 형식 Description
만든 Date-Time
 note.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
삭제됨
 note.deleted boolean

티켓이 삭제/휴지통되면 true로 설정합니다. 삭제된 티켓은 '삭제된' 필터를 제외한 모든 보기에서 고려되지 않습니다.
아이디
 note.id integer

메모의 고유 ID입니다.
비공개
 note.private boolean

메모가 비공개인 경우 true로 설정합니다.
출처
 note.source integer

티켓을 만든 채널을 나타내는 숫자입니다.
Date-Time 업데이트됨
 note.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
사용자 ID
 note.user_id integer

메모를 추가하는 에이전트의 User_id.
몸
 note.body string

메모의 내용(일반 텍스트)입니다.
본문 HTML
 note.body_html string

HTML 형식의 메모 내용입니다. 본문 또는 body_html 전달해야 합니다.
attachments
 note.attachments array of string

AddNote_ResponseV2

Name 경로 형식 Description
만든 Date-Time
 conversation.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
아이디
 conversation.id integer

메모의 고유 ID입니다.
비공개
 conversation.private boolean

메모가 비공개인 경우 true로 설정합니다.
Date-Time 업데이트됨
 conversation.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ
사용자 ID
 conversation.user_id integer

메모를 추가하는 에이전트의 User_id.
몸
 conversation.body_text string

메모의 내용(일반 텍스트)입니다.
본문 HTML
 conversation.body string

HTML 형식의 메모 내용입니다. 본문 또는 body_html 전달해야 합니다.
attachments
 conversation.attachments array of string
티켓 ID
 conversation.ticket_id integer

티켓의 고유 ID입니다.