Freshdesk
Freshdesk는 고객 서비스를 간소화하고 고객이 마땅히 받아야 할 지원을 받을 수 있도록 도와주는 클라우드 기반 고객 지원 솔루션입니다. Freshdesk 커넥터는 Freshdesk 에이전트가 티켓 및 연락처를 관리하기 위한 것입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://freshdesk.com/ |
| 개인 정보 보호 정책 | https://www.freshworks.com/privacy/ |
알려진 문제 및 제한 사항
- 트리거 "티켓을 만들 때", "에이전트에 할당된 티켓이 업데이트되는 경우", "티켓이 업데이트되는 경우" 응답에서 기본적으로 티켓에 대한 설명이 반환되지 않습니다. "설명 포함" 매개 변수를 "예"로 설정하여 트리거 응답에 포함을 지정할 수 있습니다. 그러나 이 경우 포함이 사용되므로 Freshdesk 쪽 계정에 대한 추가 비용과 관련이 있습니다. 티켓에 대한 설명이 필요한 경우 이 작업의 응답에 기본적으로 설명이 포함되어 있으므로 트리거를 "티켓 가져오기" 작업과 함께 사용하는 것이 좋습니다.
- 티켓 유형 "서비스 태스크"의 생성은 현재 지원되지 않습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 계정 URL | 문자열 | 예: https://company.freshdesk.com | 진실 |
| 전자 메일 또는 API 키(https://aka.ms/ii9u75) | 문자열 | 메일 주소 | 진실 |
| 암호 | 시큐어스트링 (보안 문자열) | 암호(API 키를 사용하는 경우 모든 값을 지정할 수 있습니다.) | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 15초 |
동작
| 티켓 가져오기 |
ID로 티켓을 가져옵니다. |
| 티켓 만들기 |
티켓을 만듭니다. |
| 티켓 업데이트 |
티켓을 업데이트합니다(지정된 값만 업데이트됨). |
| 티켓에 메모 추가 |
티켓에 비공개 또는 공개 메모를 추가합니다. |
티켓 가져오기
ID로 티켓을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | string |
티켓 ID입니다. |
반환
티켓 만들기
티켓을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제
|
subject | True | string |
티켓의 제목입니다. |
|
Description
|
description | True | string |
티켓에 대한 설명입니다. |
|
전자 메일
|
True | string |
요청자의 전자 메일입니다. |
|
|
Priority
|
priority | True | string |
티켓의 우선 순위입니다. |
|
상태
|
status | True | string |
티켓의 상태입니다. |
|
유형
|
type | string |
지원 팀에서 처리하는 다양한 종류의 문제에 따라 티켓을 분류하는 데 도움이 됩니다. |
|
|
기한
|
due_by | date-time |
티켓이 확인될 예정일 때를 나타내는 타임스탬프입니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
|
기한이 지난 첫 번째 응답
|
fr_due_by | date-time |
첫 번째 응답이 기한이 지난 시기를 나타내는 타임스탬프입니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
|
에이전트
|
responder_id | integer |
티켓의 에이전트입니다. |
|
|
제품
|
product_id | integer |
티켓이 포함되어야 하는 제품입니다(관리자 전용). |
반환
티켓 업데이트
티켓을 업데이트합니다(지정된 값만 업데이트됨).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | integer |
업데이트할 티켓 ID입니다. |
|
Description
|
description | string |
티켓 설명입니다. |
|
|
주제
|
subject | string |
티켓의 제목입니다. |
|
|
Priority
|
priority | string |
티켓의 우선 순위입니다. |
|
|
상태
|
status | string |
티켓의 상태입니다. |
|
|
유형
|
type | string |
지원 팀에서 처리하는 다양한 종류의 문제에 따라 티켓을 분류하는 데 도움이 됩니다. |
|
|
기한
|
due_by | date-time |
티켓이 확인될 예정일 때를 나타내는 타임스탬프입니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
|
에이전트
|
responder_id | integer |
티켓의 에이전트입니다. |
반환
티켓에 메모 추가
티켓에 비공개 또는 공개 메모를 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | integer |
메모를 추가할 티켓 ID입니다. |
|
Content
|
body | True | string |
메모의 내용입니다. |
|
비공개
|
private | boolean |
개인 메모인지를 나타냅니다(기본값은 true). |
반환
트리거
| 에이전트가 추가된 경우 |
에이전트가 추가되는 경우(관리자 전용) 이 트리거는 Freshdesk 계정에 에이전트가 100개 미만인 경우에만 작동합니다. |
| 에이전트에 할당된 티켓이 업데이트되는 경우 |
선택한 에이전트에 할당된 모든 티켓이 업데이트되는 경우 |
| 연락처가 추가된 경우 |
연락처가 추가되면 이 트리거는 Freshdesk 계정에 연락처가 100개 미만인 경우에만 작동합니다. |
| 티켓 상태가 변경되는 경우 |
티켓 상태가 변경되는 경우 |
| 티켓이 만들어지는 경우 |
티켓이 만들어지는 경우 |
| 티켓이 업데이트되는 경우 |
티켓이 업데이트되는 경우 |
에이전트가 추가된 경우
에이전트가 추가되는 경우(관리자 전용) 이 트리거는 Freshdesk 계정에 에이전트가 100개 미만인 경우에만 작동합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
아이디 |
|
티켓 범위
|
ticket_scope | integer |
에이전트의 티켓 권한입니다. |
|
만든 위치에서
|
created_at | date-time |
에이전트 생성 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
업데이트 날짜
|
updated_at | date-time |
에이전트가 타임스탬프를 업데이트했습니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
Active
|
contact.active | boolean |
에이전트가 확인되면 true로 설정합니다. |
|
전자 메일
|
contact.email | string |
에이전트의 이메일 주소입니다. |
|
직위
|
contact.job_title | string |
에이전트의 직호입니다. |
|
Language
|
contact.language | string |
에이전트의 언어입니다. |
|
마지막 로그인 시간
|
contact.last_login_at | date-time |
에이전트의 마지막으로 성공한 로그인의 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
휴대폰
|
contact.mobile | string |
에이전트의 휴대폰 번호입니다. |
|
이름
|
contact.name | string |
에이전트의 이름입니다. |
|
Phone
|
contact.phone | string |
에이전트의 전화 번호입니다. |
|
시간대
|
contact.time_zone | string |
에이전트의 표준 시간대입니다. |
|
만든 위치에서
|
contact.created_at | date-time |
에이전트 생성 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
업데이트 날짜
|
contact.updated_at | date-time |
에이전트에 대한 마지막 업데이트의 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
에이전트에 할당된 티켓이 업데이트되는 경우
선택한 에이전트에 할당된 모든 티켓이 업데이트되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
에이전트 ID
|
agentId | True | integer |
에이전트 ID입니다. |
|
설명 포함
|
includeDescription | boolean |
트리거의 응답에 설명이 포함되어야 합니다. |
반환
연락처가 추가된 경우
연락처가 추가되면 이 트리거는 Freshdesk 계정에 연락처가 100개 미만인 경우에만 작동합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Active
|
active | boolean |
연락처가 확인된 경우 true로 설정합니다. |
|
Address
|
address | string |
연락처의 주소입니다. |
|
회사 ID
|
company_id | integer |
이 연락처가 속한 회사의 ID입니다. |
|
Description
|
description | string |
연락처에 대한 간단한 설명입니다. |
|
전자 메일
|
string |
연락처의 기본 전자 메일 주소입니다. |
|
|
아이디
|
id | integer |
연락처의 ID입니다. |
|
직위
|
job_title | string |
연락처의 직호입니다. |
|
Language
|
language | string |
연락처의 언어입니다. |
|
휴대폰
|
mobile | string |
연락처의 휴대폰 번호입니다. |
|
이름
|
name | string |
연락처의 이름입니다. |
|
Phone
|
phone | string |
연락처의 전화 번호입니다. |
|
시간대
|
time_zone | string |
연락처가 있는 표준 시간대입니다. |
|
Twitter Id
|
twitter_id | string |
연락처의 Twitter 핸들입니다. |
|
만든 위치에서
|
created_at | date-time |
연락처 만들기 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
업데이트 날짜
|
updated_at | date-time |
업데이트된 타임스탬프에 문의합니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
티켓 상태가 변경되는 경우
티켓 상태가 변경되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | integer |
티켓 ID입니다. |
|
새 상태
|
status | string |
티켓의 새 상태입니다. |
반환
티켓이 만들어지는 경우
티켓이 만들어지는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
설명 포함
|
includeDescription | boolean |
트리거의 응답에 설명이 포함되어야 합니다. |
반환
티켓이 업데이트되는 경우
티켓이 업데이트되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | integer |
티켓 ID입니다. |
|
|
설명 포함
|
includeDescription | boolean |
트리거의 응답에 설명이 포함되어야 합니다. |
반환
정의
CreateTicket200Response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
스팸
|
spam | boolean |
티켓이 스팸으로 표시된 경우 true로 설정합니다. |
|
Priority
|
priority | string |
티켓의 우선 순위입니다. |
|
요청자 ID
|
requester_id | integer |
요청자의 사용자 ID입니다. |
|
에이전트 ID
|
responder_id | integer |
티켓이 할당된 에이전트의 ID입니다. |
|
출처
|
source | string |
티켓을 만든 채널입니다. |
|
상태
|
status | string |
티켓의 상태입니다. |
|
주제
|
subject | string |
티켓의 제목입니다. |
|
티켓 ID
|
id | integer |
티켓의 고유 ID입니다. |
|
유형
|
type | string |
지원 팀에서 처리하는 다양한 종류의 문제에 따라 티켓을 분류하는 데 도움이 됩니다. |
|
기한
|
due_by | date-time |
티켓이 확인될 예정일 때를 나타내는 타임스탬프입니다(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
에스컬레이션됨
|
is_escalated | boolean |
어떤 이유로든 티켓이 에스컬레이션된 경우 true로 설정합니다. |
|
Description
|
description | string |
티켓의 HTML 콘텐츠입니다. |
|
설명 텍스트
|
description_text | string |
일반 텍스트로 된 티켓의 내용입니다. |
|
만든 위치에서
|
created_at | date-time |
티켓 생성 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식) |
|
업데이트 날짜
|
updated_at | date-time |
티켓 업데이트 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식). |
|
삭제됨
|
deleted | boolean |
티켓이 삭제된 경우 true로 설정합니다. |
AddNote200Response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
비공개
|
private | boolean |
메모가 비공개인 경우 true로 설정합니다. |
|
Content
|
body | string |
HTML로 된 메모의 내용입니다. |
|
콘텐츠 텍스트
|
body_text | string |
메모의 내용(일반 텍스트)입니다. |
|
티켓 ID
|
ticket_id | integer |
이 메모가 추가되는 티켓의 ID입니다. |
|
만든 위치에서
|
created_at | date-time |
만들기 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식)를 기록해 둡니다. |
|
업데이트 시
|
updated_at | date-time |
업데이트된 타임스탬프(yyyy-MM-ddTHH:mm:ssZ 형식)를 기록해 둡니다. |