Zendesk
Zendesk는 더 나은 고객 관계를 위한 소프트웨어를 빌드합니다. 포트폴리오에 여러 제품이 있는 Zendesk는 고객 서비스 및 지원 발권 플랫폼을 제공하여 기업에게 통합 인터페이스에서 고객 통화, 이메일 및 기타 기술 문의를 처리할 수 있는 기능을 제공합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.zendesk.com/ |
| 개인 정보 보호 정책 | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
알려진 문제 및 제한 사항
- 커넥터는 Zendesk 엔터티의 원자성 속성만 반환합니다(예: 목록, 레코드 및 기타 복합 형식은 지원되지 않음). 예를 들어
Ticket엔터티에는tagsZendesk 쪽에서 배열로 나타내는 속성이 있습니다. Zendesk 커넥터는 이러한 필드에 대한 문자열을 반환[List]합니다. - 커넥터를 사용하려면 트리거와
updated_at함께 사용되는 테이블에 열이 있어야 합니다. - Zendesk Search API에는 쿼리당 1000개의 결과를 반환하는 데 제한이 있습니다. 이는 대상 테이블에 1000개 이상의 레코드가 포함된 경우 오류("Http 요청 실패: 콘텐츠가 유효한 JSON이 아님")로 실패하는 일부 커넥터 작업에 영향을 줍니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 회사 이름 | 문자열 | Zendesk 회사 이름은 사이트 URL의 하위 도메인 부분입니다. 예: https://{company}.zendesk.com | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 검색 문서 |
페이지당 25개 아티클의 기본 개수를 반환하며 최대 1,000개의 결과를 반환합니다. |
| 아이템 만들기 |
Zendesk 항목을 만듭니다. |
| 테이블 가져오기 |
사이트에서 Zendesk 테이블을 검색합니다. |
| 항목 가져오기 |
Zendesk 항목을 검색합니다. |
| 항목 가져오기 |
특정 Zendesk 유형의 Zendesk 항목을 검색합니다(예: 'Ticket'). |
| 항목 삭제 |
Zendesk 항목을 삭제합니다. |
| 항목 업데이트 |
기존 Zendesk 항목을 업데이트합니다. |
검색 문서
페이지당 25개 아티클의 기본 개수를 반환하며 최대 1,000개의 결과를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
검색할 문서입니다. |
|
로케일
|
locale | string |
항목이 표시되는 로캘 |
|
|
브랜드 ID
|
brand_id | integer |
지정된 브랜드의 문서를 검색합니다. |
|
|
카테고리
|
category | integer |
검색을 이 범주 ID로 제한합니다. |
|
|
섹션
|
section | integer |
검색을 이 섹션 ID로 제한 |
|
|
레이블 이름
|
label_names | string |
레이블 이름의 쉼표로 구분된 목록입니다. |
|
|
멀티 브랜드
|
multibrand | boolean |
true인 경우 모든 브랜드에서 검색을 사용하도록 설정합니다. |
반환
아이템 만들기
Zendesk 항목을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 항목 유형(예: 'Ticket') |
|
Item
|
item | True | dynamic |
만들 Zendesk 항목 |
반환
테이블 가져오기
항목 가져오기
Zendesk 항목을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 항목 유형(예: 'Ticket') |
|
항목 키
|
id | True | string |
검색할 항목의 고유 식별자 |
반환
항목 가져오기
특정 Zendesk 유형의 Zendesk 항목을 검색합니다(예: 'Ticket').
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 항목 유형(예: 'Ticket') |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123). |
|
|
주문 기준
|
$orderby | string |
항목 순서를 지정하기 위한 ODATA orderBy 쿼리 |
|
|
개수 건너뛰기
|
$skip | integer |
건너뛸 항목 수(기본값 = 0) |
|
|
최대 가져오기 수
|
$top | integer |
검색할 최대 항목 수(기본값 = 512) |
|
|
쿼리 선택
|
$select | string |
항목에서 검색할 특정 필드(기본값 = 모두). |
반환
항목 삭제
Zendesk 항목을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 항목 유형(예: 'Ticket') |
|
항목 키
|
id | True | string |
삭제할 항목의 고유 식별자 |
항목 업데이트
기존 Zendesk 항목을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 항목 유형(예: 'Ticket') |
|
항목 키
|
id | True | string |
업데이트할 항목의 고유 식별자 |
|
Item
|
item | True | dynamic |
업데이트된 값이 있는 Zendesk 항목 |
반환
트리거
| 항목이 만들어지는 경우 |
Zendesk에서 항목을 만들 때 흐름을 트리거합니다. |
| 항목이 수정되는 경우 |
Zendesk에서 항목이 수정될 때 흐름을 트리거합니다. |
| 항목이 수정되는 경우 |
Zendesk에서 항목이 수정될 때 흐름을 트리거합니다. |
항목이 만들어지는 경우
Zendesk에서 항목을 만들 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 테이블의 이름 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123). |
|
|
주문 기준
|
$orderby | string |
항목 순서를 지정하기 위한 ODATA orderBy 쿼리 |
|
|
개수 건너뛰기
|
$skip | integer |
건너뛸 항목 수(기본값 = 0) |
|
|
최대 가져오기 수
|
$top | integer |
검색할 최대 항목 수(기본값 = 512) |
반환
항목이 수정되는 경우
Zendesk에서 항목이 수정될 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 테이블의 이름 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123). |
|
|
주문 기준
|
$orderby | string |
항목 순서를 지정하기 위한 ODATA orderBy 쿼리 |
|
|
개수 건너뛰기
|
$skip | integer |
건너뛸 항목 수(기본값 = 0) |
|
|
최대 가져오기 수
|
$top | integer |
검색할 최대 항목 수(기본값 = 512) |
반환
항목이 수정되는 경우
Zendesk에서 항목이 수정될 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테이블 이름
|
table | True | string |
Zendesk 테이블의 이름 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123). |
|
|
주문 기준
|
$orderby | string |
항목 순서를 지정하기 위한 ODATA orderBy 쿼리 |
|
|
개수 건너뛰기
|
$skip | integer |
건너뛸 항목 수(기본값 = 0) |
|
|
최대 가져오기 수
|
$top | integer |
검색할 최대 항목 수(기본값 = 512) |
반환
정의
Table
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string | |
|
디스플레이 이름
|
DisplayName | string |
SearchResult
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
아이디
|
results.id | integer |
자동으로 할당된 문서 ID |
|
url
|
results.url | string |
문서의 API URL |
|
html_url
|
results.html_url | string |
도움말 센터에 있는 문서의 URL |
|
author_id
|
results.author_id | integer |
작성자 ID |
|
comments_disabled
|
results.comments_disabled | boolean |
주석을 사용하지 않도록 설정하면 True이고, false이면 false입니다. |
|
draft
|
results.draft | boolean |
현재 로캘의 번역이 초안인 경우 True입니다. |
|
승진
|
results.promoted | boolean |
이 문서가 승격되면 True입니다. false이면 false입니다. 기본적으로 false입니다. |
|
위치
|
results.position | integer |
아티클 목록에서 이 문서의 위치입니다. 기본적으로 0 |
|
vote_sum
|
results.vote_sum | integer |
양수 또는 음수일 수 있는 upvotes(+1) 및 downvotes(-1)의 합계입니다. |
|
vote_count
|
results.vote_count | integer |
최대 호출 및 다운바이트의 총 수 |
|
section_id
|
results.section_id | integer |
이 문서가 속한 섹션의 ID입니다. |
|
생성_시간
|
results.created_at | date-time |
아티클을 만든 시간 |
|
updated_at
|
results.updated_at | date-time |
문서가 마지막으로 업데이트된 시간 |
|
이름
|
results.name | string |
아티클의 이름 |
|
title
|
results.title | string |
문서의 제목 |
|
source_locale
|
results.source_locale | string |
아티클의 원본(기본값) 로캘 |
|
지역 설정
|
results.locale | string |
아티클이 표시되는 로캘 |
|
구식의
|
results.outdated | boolean |
Deprecated |
|
outdated_locales
|
results.outdated_locales | array of string |
아티클이 오래된 것으로 표시된 로캘 |
|
edited_at
|
results.edited_at | date-time |
표시된 로캘에서 아티클을 마지막으로 편집한 시간입니다. |
|
user_segment_id
|
results.user_segment_id | integer |
이 문서를 볼 수 있는 사용자를 정의하는 사용자 세그먼트의 ID입니다. |
|
permission_group_id
|
results.permission_group_id | integer |
이 문서를 편집하고 게시할 수 있는 사용자를 정의하는 권한 그룹의 ID입니다. |
|
content_tag_ids
|
results.content_tag_ids | array of string |
문서에 첨부된 콘텐츠 태그 목록 |
|
label_names
|
results.label_names | array of string |
이 문서와 연결된 레이블 이름의 배열 |
|
body
|
results.body | string |
문서의 HTML 본문 |
|
단편
|
results.snippet | string |
문서의 HTML 코드 조각 |
|
result_type
|
results.result_type | string |
결과 형식 |
TablesList
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of Table |