앱 빌더를 사용하면 고유한 고객 및 직원 서비스 워크플로우에 맞게 Zendesk를 확장하는 Zendesk 앱을 만들 수 있습니다. 비용이 많이 드는 개발자 지원이나 새로운 제품 기능을 오래 기다리는 대신, 필요할 때 바로 특화된 프로세스를 지원하는 데 필요한 솔루션을 신속하게 구축할 수 있습니다.
앱 빌더를 사용하면 NLP(자연어 처리) 및 생성형 AI를 활용하여 이러한 앱을 만들 수 있습니다. NLP를 사용하면 동료나 친구에게 아이디어를 설명하는 것처럼 일반 언어로 지침을 제공할 수 있습니다. 생성형 AI는 이러한 프롬프트를 해석하여 필요한 코드, UI 및 기능을 생성합니다. 생성형 AI 사용하면 설명하는 것만큼 쉽게 앱을 구축할 수 있으므로 기존 코딩과 관련된 학습 시간이 필요 없습니다.
다음은 앱 빌더의 몇 가지 주요 이점입니다.
- 가속된 프로토타이핑: 일반 언어 프롬프트에서 기능 코드를 생성하면 개념에서 작업하는 프로토타입으로 신속하게 이동할 수 있습니다.
- 실시간 시각적 미리 보기: 앱을 구축하면서 앱의 모양과 작동 방식을 바로 확인할 수 있어 디자인과 기능을 쉽게 검증할 수 있습니다.
- 기본 제공 버전 제어: 모든 변경 내용은 자동으로 버전이 관리됩니다. 쉽게 변경 내용을 추적하고, 이전 버전을 복원하며, 차이점을 비교할 수 있습니다.
- 엔드 투 엔드 테스트 환경: 배포하기 전에 안전한 환경에서 실제 Zendesk 데이터 및 API 응답으로 앱을 테스트할 수 있습니다. 테스트 중 변경하는 모든 내용은 실제 계정에 반영됩니다.
- Zendesk 고유의 AI 전문성: Zendesk 프레임워크, API 및 디자인 성공 사례를 사용하여 앱을 생성하고 일반적인 Zendesk 관련 문제를 자동으로 해결할 수 있습니다.
- 데이터 연동: Zendesk, 회사 내부 시스템 및 Google, Jira 등의 인기 타사 플랫폼의 데이터를 연결하여 작업하는 앱을 구축할 수 있습니다.
- 모든 곳에서 작업 저장 및 동기화: 모든 세션, 브라우저 및 기기에서 작업 내용이 안전하게 저장되고 최신 상태로 유지됩니다.
- 다크 모드 지원: 앱 빌더는 다크 모드와 라이트 모드를 모두 지원합니다. 원하는 테마에서 앱을 구축하고 테스트할 수 있으며, 상담사는 자신의 인터페이스 설정에 맞게 앱이 자동으로 조정되는 것을 확인할 수 있습니다. 추가적인 코딩은 필요하지 않습니다. 2025년 12월 이전에 구축된 앱이 다크 모드에서 제대로 표시되려면 다시 게시하거나 업데이트해야 할 수도 있습니다.
- 전역 및 현지화된 인터페이스: 앱 빌더와 모든 메뉴, 프롬프트 및 안내는 완전히 번역 가능합니다. 인터페이스는 번역이 제공되는 경우 선택한 언어로 표시되며, RTL(오른쪽에서 왼쪽) 레이아웃 및 지역별 형식을 자동으로 지원합니다.
앱 빌더로 만든 앱은 ZAF API 및 REST API는 물론 Zendesk Garden 구성 요소로 디자인됩니다.
이 문서는 다음 섹션으로 구성되어 있습니다.
앱 빌더 개요(동영상)
이 문서에서 다루는 자세한 정보 외에도 이 동영상은 시작하는 데 도움이 되는 앱 빌더의 시각적 개요를 제공합니다.
시작하기
대화는 요구 사항을 요약하고, 추천 솔루션을 검토하고, 앱을 세분화하며, 필요에 따라 오류를 해결하는 대화 창에서 안내되는 지속적인 교환입니다. 대화는 앱 빌더와 함께 대화형 워크스페이스 역할을 하며, 앱 아이디어를 구체화하는 과정에서 모든 프롬프트, 응답 및 반복 작업을 기록합니다.
동시에 여러 대화를 통해 서로 다른 아이디어나 프로토타입을 탐색할 수 있습니다. 모든 대화가 앱을 게시하는 것은 아닙니다. 때로는 대화를 실험, 학습 또는 기능 테스트 용도로만 사용하기도 합니다.
프롬프트는 앱을 진행시키기 위해 대화 내에서 보내는 개별 안내 또는 질문입니다. 예를 들어 '이 보기에 상태 필터 추가' 또는 '우선 순위가 높은 티켓을 먼저 표시하도록 앱 업데이트'와 같은 프롬프트를 입력할 수 있습니다. 일련의 프롬프트와 응답을 통해 사용자와 앱 빌더가 협업하여 앱을 구축하고 개선합니다.
앱은 성공적인 대화를 통해 만들고 설치하는 실질적인 결과입니다. 앱은 Zendesk에서 구축하고, 테스트하고, 게시하며 관리하는 작업 솔루션입니다. 게시된 후에는 상담사와 관리자가 워크플로우에서 앱을 사용할 수 있습니다. 앱은 단일 대화에서 생성되거나 여러 라운드를 거쳐 생성되거나 여러 개선 주기를 거친 후에 생성될 수 있습니다.
앱 빌더에서 대화와 앱이 별도로 추적됩니다. 초안 앱(아직 구축 중이거나 개선 중)이나 Zendesk에서 이미 사용 중인 게시된 앱에 대화를 연결할 수 있습니다. 즉, 언제든지 대화로 돌아가서 계속 초안을 작성하거나 업데이트하고 라이브 앱을 다시 게시할 수 있습니다.
앱 빌더는 NLP와 생성형 AI를 사용하여 사용자 프롬프트를 해석하고 이를 기능적인 앱으로 변환합니다. 앱 빌더에서 최상의 결과를 얻으려면 프롬프트를 작성할 때 특정 가이드라인을 따라야 합니다. 성공 사례는 앱 빌더에 대한 프롬프트 가이드라인을 참조하세요.
- 간단한 기능을 구축한 후 더 많은 전후 상황과 구체적인 요구사항을 제공하는 프롬프트를 추가로 입력하여 앱을 지속적으로 개선합니다. 개발 프로세스를 여러 세그먼트로 나누면 더 복잡해지기 전에 앱의 특정 부분에서 문제를 보다 쉽게 해결하고 처리할 수 있습니다.
- 구축된 앱이 작동하지 않으면 AI에게 로깅을 추가하도록 요청합니다.
- AI의 응답을 읽고 구축하도록 요청하는 것이 무엇인지 이해하도록 합니다.
- 앱을 게시하기 전에 철저한 테스트를 수행합니다.
- 앱을 테스트하는 동안 오류가 발생하면 오류 메시지를 복사하여 프롬프트에 붙여넣습니다. 이로써 앱 빌더가 문제를 분석하고 문제 디버깅을 지원할 수 있습니다.
- 예상대로 작동하지 않는 경우에는 어떤 부분이 올바르게 작동하는지, 어떤 부분이 제대로 작동하지 않는지에 대한 자세한 설명을 제공합니다. 단순히 작동하지 않는다고만 말하지 마세요.
- AI가 작동하는 방식과 원하는 결과를 얻지 못할 경우 취해야 할 조치를 더 잘 이해하기 위해 인내심을 갖고 프로세스에 접근합니다.
첫 번째 앱 만들기
앱을 만들려면 다음과 같이 하세요.
-
관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 앱 > 앱 빌더를 선택합니다. 앱 빌더를 사용하려면 Zendesk 관리자여야 합니다.
아직 앱을 만들지 않은 경우 앱 빌더를 열면 환영 페이지로 이동합니다. 대화 시작을 클릭하여 앱 만들기 프로세스를 시작합니다.
재방문 사용자는 기존 대화 목록 페이지로 이동하여 이전 대화에 빠르게 액세스할 수 있습니다. 대화는 최근 업데이트된 순서로 정렬됩니다.
- 티켓 사이드바: Zendesk Support에서 각 티켓의 세부 정보와 함께 나타납니다(기본값). 티켓별 정보, 작업 또는 연동 서비스를 표시하려면 이 위치를 선택합니다. 티켓 사이드바는 기존 티켓과 선택적으로 새 티켓에 적용됩니다.
- 새 티켓 사이드바: 상담사가 새 티켓을 만들 때 표시됩니다. 이 위치는 티켓 만들기, 기본서식, 데이터 강화 또는 유효성 검사를 지원하는 솔루션에 적합합니다.
- 최상위 탐색: Zendesk 인터페이스의 상단 막대는 티켓이나 화면에 관계없이 항상 액세스할 수 있습니다. 알림 허브 또는 빠른 작업과 같은 전역 도구에 이 옵션을 선택합니다.
- 사이드 탐색: Zendesk Support의 왼쪽 탐색 창 아래쪽에 있는 이 영역은 대시보드나 보고서와 같이 추가 공간이 필요한 복잡하거나 독립 실행형 앱에 적합합니다.
앱 위치를 선택한 후에는 대화 창으로 들어갑니다. 제공된 예제 프롬프트 중 하나를 사용하거나 자체 앱 요구 사항을 입력하고 보내기를 클릭합니다.
AI 제안 플랜 승인하기
초기 프롬프트를 입력하면 앱 빌더의 AI가 앱에 대한 추천 플랜을 생성하여 제시합니다. 플랜을 검토하거나, 그대로 승인하거나, 불필요한 요소를 제거하거나, 추가 제안 기능을 통합할 수 있습니다. 이 접근 방식은 정확한 요구 사항에 맞게 앱을 맞춤 설정할 수 있는 빠르고 유연한 방법을 제공합니다.
'플랜 승인' 화면에 핵심 및 선택 사항 기능과 함께 앱의 제안된 기능에 대한 요약이 표시됩니다. 기본 설정에 따라 각 기능 옆의 확인란을 선택하거나 선택 취소합니다. 나중에 계속 변경할 수 있으므로 지금 확실하지 않더라도 걱정하지 마세요. 다음 예를 참조하세요.
계획 화면 아래쪽에 다음 두 가지 선택 항목이 있습니다.
- 계속 계획하기: 새로운 요구 사항을 추가하거나 추가 조정을 수행하여 제안된 플랜을 더욱 세분화합니다.
- 플랜 승인 및 구축하기: 선택한 기능을 확인하고 앱 빌더가 승인된 플랜을 기반으로 앱을 생성하도록 허용합니다.
앱 개선 및 테스트하기
AI가 승인된 플랜을 생성한 후, 앱 빌더를 통해 Zendesk 계정 내에서 직접 앱을 개선하고, 미리 보고, 테스트하며, 게시할 수 있습니다.
- 미리 보기: 미리 보기를 클릭하여 새로 생성된 앱을 미리 보기 탭에서 확인할 수 있습니다. 이 탭에서는 모의 데이터를 사용하여 레이아웃, 데이터 플로우 및 대화형 요소를 안전하게 먼저 살펴볼 수 있습니다. 이는 앱이 게시된 후 예상대로 작동할 것을 보장하지 않습니다. 게시하기 전에 실제 계정 데이터로 앱을 테스트해야 합니다(아래 참조).
코드 탭을 사용하여 앱의 파일, 폴더 및 구성 요소를 검토하고 설정 탭을 사용하여 앱의 이름과 로고를 검토하고 업데이트합니다.
- 개선 및 반복: 대화 창에 새 프롬프트를 입력하여 언제든지 앱을 개선하고 업데이트할 수 있습니다. 모든 변경 내용이 저장되므로 자유롭게 실험하고 필요할 때마다 이전 버전으로 되돌릴 수 있습니다. 모든 변경 내용은 자동으로 버전이 관리됩니다.
- 복원: 모든 변경 사항은 새로운 버전으로 자동 저장되므로 실험 중이든, 오류를 수정하든, 접근 방식을 재고하든 관계없이 언제든지 이전 버전으로 되돌릴 수 있습니다.
- 테스트: 테스트를 클릭하여 실제 계정 데이터로 Zendesk Support 에서 앱을 실행합니다. 여기에서 앱이 의도한 대로 데이터를 표시하고, 읽고, 쓰는지 그리고 실제 시나리오에서 작동하는지 확인할 수 있습니다. 참고: 앱을 테스트하는 동안 수행된 모든 업데이트나 변경 내용은 실제 계정 데이터에 적용됩니다.
- 문제 해결: 문제가 발생하면 앱의 읽기 쉬운 오류 메시지와 로그를 사용하여 문제를 파악할 수 있습니다. 오류 세부 정보를 프롬프트에 붙여넣어 맞춤형 도움을 받거나, 앱 빌더에 디버깅 출력을 추가하도록 요청합니다.
- 앱 설정: 사용자 지정 이름을 입력하고 설정 탭의 Garden 아이콘 라이브러리에서 배경 색과 함께 아이콘을 선택하여 앱을 사용자 지정합니다.
- 앱 게시 및 관리: 만족스러우면 게시를 클릭하여 Zendesk 관리자 또는 상담사가 앱을 사용할 수 있도록 합니다.
예: 담당자 변경 내용 추적기 앱 만들기
다음은 티켓 담당자의 변경 내용을 추적하기 위한 앱을 구축하는 예입니다.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 앱 > 앱 빌더를 선택합니다.
- 대화 시작을 클릭합니다.
- 티켓 사이드바를 선택하고 위치 선택을 클릭합니다.
- 프롬프트에서 다음을 입력합니다.
목적: 이 앱을 사용하면 티켓 이벤트 기록을 자세히 살펴보고 모든 담당자 변경 이벤트를 검색하여 추적하는 대신, 담당자 변경 사항을 매우 빠르게 확인할 수 있습니다. 티켓 처리 과정에서 담당자 전환 시점에 대한 질문을 자주 받습니다. 작업: 지정된 티켓에서 담당자의 변경 기록을 추적하는 담당자 변경 내용 추적기라는 앱을 만듭니다. 구성 요소: 티켓 담당자가 변경된 각 시점을 최신순으로 나열한 표가 제공되어야 합니다. 각 행에는 담당자 이름, 할당된 날짜, 티켓에 할당된 기간이 포함되어야 합니다. 표 위에 티켓 과제의 변경 총 횟수를 표시합니다. 최신 변경 사항을 반영하도록 표시된 데이터를 새로 고침하는 버튼을 추가합니다. Excel 스프레드시트로 데이터를 내보내는 버튼을 추가합니다. 두 버튼을 작게 만들고 서로 나란히 배치합니다. 범위: 이 앱은 현재 티켓에만 적용됩니다.
- 기본 플랜 선택 사항을 사용하고 플랜 승인 및 구축하기를 클릭합니다.
-
보내기를 클릭합니다.
앱 빌더가 다음과 유사하게 응답합니다.
- 미리 보기를 검토하여 앱의 모양과 작동 방식을 확인하고, AI의 응답 프롬프트를 확인하여 기본 안내를 이해합니다.
- 코드 탭을 클릭하여 생성된 코드와 미리 보기를 채우는 데 사용된 모의 데이터가 포함된 파일을 확인합니다.
- 프롬프트에서 다음을 입력합니다.
이전 담당자를 표의 첫 번째 열로 추가하여 이전에 티켓이 배정된 사람의 전체 이름을 캡처합니다. 또한 마우스를 올렸을 때 각 버튼의 기능에 대한 간단한 설명을 표시하는 툴팁을 두 버튼 모두에 추가합니다.
-
보내기를 클릭합니다.
앱 빌더가 다음과 유사하게 응답합니다.
-
테스트를 클릭하여 자체 Zendesk 데이터로 앱을 테스트합니다.
테스트하는 동안 변경한 내용은 실제 계정에 영향을 미치므로 작업의 영향을 신중히 검토하세요. 또한 설정 탭에서 앱의 모양을 사용자 지정하는 것을 고려해 보세요. 예를 들어 기본 아이콘을 사용하는 대신 앱의 색과 아이콘을 앱의 테마와 관련된 것으로 업데이트합니다. 이렇게 하면 앱을 명확하게 식별할 수 있습니다.
이제 앱이 완성되어 게시할 준비가 되었습니다.
코드 탭 및 앱 설정 살펴보기
앱 빌더로 앱을 구축하고 개선한 후에는 코드 탭에 액세스하여 앱에 대해 생성된 모든 코드 파일과 폴더를 볼 수 있습니다.
| 파일 또는 폴더 | 설명 |
|---|---|
| blueprint.md | 앱의 목적, 아키텍처, 기능, 연동 서비스 세부 정보 및 사용된 주요 기술(예: React, Zendesk Garden 구성 요소 등)에 대한 개괄적인 요약입니다. |
| changelog.md | 앱 개발 과정에서 수행된 모든 변경 사항과 업데이트에 대한 시간순 로그입니다. 이 기능을 사용하여 진행 상황을 추적하고 필요한 경우 생성된 앱 풀다운 메뉴 또는 대화 기록의 버전을 사용하여 롤백합니다. |
| index.jsx | 앱의 기본 소스 파일입니다. 앱이 로드되는 방식을 관리하고, 오류를 처리하고, 테마를 적용하며, 앱 기능의 진입점 역할을 합니다. |
| mock.js | 이 파일에는 앱 빌더 환경 내에서 앱의 모양을 미리 보고 UI 플로우를 테스트하는 데 사용되는 모의 데이터가 포함되어 있습니다. |
| 구성 요소 | 이 폴더에는 앱의 대화형 사용자 인터페이스와 구조를 정의하는 React 구성 요소가 포함되어 있습니다. |
| styles | 이 폴더에는 일관된 모양과 느낌을 보장하는 스타일시트가 포함되어 있습니다. |
| utils | 이 폴더에는 앱 전체에서 사용되는 도우미 함수와 유틸리티 코드가 포함되어 있습니다. 이러한 함수는 날짜 서식 지정, 데이터 필터링 등의 작업을 수행합니다. |
- 청사진 및 변경 로그 파일을 사용하여 시간 경과에 따른 변경 내용을 추적할 수 있습니다.
- 문제가 발생하면 어디에서 찾아야 할지 알 수 있으므로 쉽게 문제를 찾아 해결할 수 있습니다.
- 스타일, 모의 데이터 또는 새로운 기능으로 안전하게 실험할 수 있습니다.
매일 코드를 작성하지 않더라도 구조를 파악하면 자신 있게 앱을 구축하고, 개선하며 유지 관리할 수 있습니다.
코드에 대한 자세한 내용은 Zendesk 개발자 문서에서 앱을 참조하세요.
맨 위에 다음이 표시됩니다.
- 옵션 메뉴: 세 개의 세로 점을 클릭하여 피드백을 제공하거나 대화를 JSON 파일로 다운로드합니다. 대화를 다운로드하면 사용자가 해결할 수 없는 오류가 발생하는 경우 팀이 전체 대화 세부 정보를 검토할 수 있으므로 문제를 해결하는 데 특히 유용합니다. 프롬프트 가이드라인 헬프 센터 문서에 액세스하여 앱 빌더에 요구 사항을 명확하게 전달하기 위한 전략과 예를 볼 수도 있습니다.
- 생성된 앱: 메뉴에서 앱의 다양한 버전을 선택하고 미리 봅니다. 이를 통해 특정 버전을 검토하고, 변경 내용을 비교하며, 필요에 따라 이전 기능을 복원할 수 있습니다.
- 테스트: Zendesk Support에서 앱을 보고 상호작용하려면 클릭하세요. 여기에서 앱을 테스트하면 Zendesk 계정의 실제 데이터를 사용하여 기능을 살펴보고 평가할 수 있습니다. 앱을 테스트하는 동안 수행한 모든 업데이트나 변경 내용은 실제 계정 데이터에 적용됩니다. 팀에 배포하기 전에 앱이 의도한 대로 작동하는지 확인하세요. 테스트하는 동안 오류가 발생하면 게시 시 자동으로 해결되지 않습니다. 게시하면 Zendesk 계정에서만 앱을 사용할 수 있으며, 오류를 수정하지는 않습니다. 게시 후 앱이 예상대로 작동하는지 확인하기 위해 테스트 중 모든 문제를 해결해야 합니다.
- 게시: 앱을 출시할 준비가 되면 게시를 클릭합니다. 이렇게 하면 앱이 설치되고 상담사가 사용할 수 있게 됩니다.
사용자 지정 앱 아이콘 선택하기
사용자 지정 아이콘을 사용하면 앱을 더 쉽게 식별하고 브랜드나 워크플로우에 맞게 앱 모양을 조정할 수 있습니다. Zendesk의 Garden 아이콘 라이브러리에서 선택하여 앱 아이콘을 개인화하는 옵션이 있습니다. 각 앱 위치에 대해 앱 빌더는 필요에 따라 SVG 아이콘의 PNG 버전을 생성하여 아이콘이 올바르게 표시되도록 합니다.
사용자 지정 앱 아이콘을 선택하려면 다음과 같이 하세요.
- 설정 탭을 클릭합니다.
- 앱의 이름을 입력하세요.
이름을 입력하지 않으면 앱 빌더가 대화의 세부 정보 및 제공된 프롬프트를 기반으로 이름을 자동 생성합니다.
- 선별된 Garden 아이콘 및 배경색 모음을 둘러봅니다. 아이콘이나 색 조합을 클릭하여 앱에서 어떻게 보일지 미리 봅니다.
- 만족하면 저장을 클릭합니다.
선택한 이름, 아이콘 및 색이 게시되면 Zendesk Support에 나타납니다. 사용자 지정 아이콘을 선택하지 않으면 기본 자리 표시자 아이콘이 사용됩니다.
이러한 설정은 앱 빌더에 저장되므로 다음에 동일한 앱을 다시 방문하면 변경 사항을 적용한 버전부터 최신 이름과 아이콘 선택 항목이 표시됩니다.
버전 제어
앱 빌더는 앱을 빌드하고 반복 작업을 수행할 때 자동으로 버전을 관리하므로 쉽게 실험하고, 변경 사항을 검토하며, 이전 작업을 복구할 수 있습니다.
업데이트를 생성하거나 이전 버전을 복원할 때마다 앱 빌더가 새 버전을 만들고 타임스탬프를 기록합니다.
새 버전이 만들어지면 대화 기록에 버전 세부 정보가 표시됩니다. 앱 미리 보기 및 코드를 이전 상태로 되돌리려면 복원을 클릭합니다. 복원하면 항상 새 버전이 생성되므로 아무것도 손실되지 않습니다.
미리 보기 또는 코드 탭에서 생성된 앱 풀다운 메뉴를 사용하여 이전 버전을 선택할 수도 있습니다.
앱 설치 및 관리하기
- 앱에 만족하면 오른쪽 위에 있는 게시를 클릭합니다.
특정 Zendesk 역할(예: 관리자, 상담사 등) 및 사용자 그룹을 선택하여 이 앱에 액세스할 수 있는 사람을 설정하라는 메시지가 표시됩니다. 이를 통해 역할이나 그룹에 따라 액세스를 제한할 수 있습니다. 예를 들어, 앱을 관리자 또는 특정 사용자 그룹으로만 제한할 수 있습니다.
- 앱 빌더를 통해 생성된 앱 사용에 관한 서비스 고지 사항을 확인합니다.
동의 및 게시를 클릭하면 설치 프로세스가 시작되고, 앱이 성공적으로 설치되면 앱 빌더에서 알려줍니다.
-
앱 관리를 클릭하여 권한을 수정하거나 앱을 추가로 관리하거나, 앱 > Zendesk 지원 앱을 선택합니다.
자세한 내용은 설치된 앱 관리하기를 참조하세요.
비공개 시스템 및 타사 플랫폼과 연동하기
앱 빌더를 사용하면 연결 설정과 인증을 단계별로 안내하여 회사의 비공개 데이터 소스는 물론 외부 타사 플랫폼과 앱을 쉽게 연결할 수 있습니다.
비공개 또는 외부 서비스와 연동하려면 일반적으로 API 엔드포인트 및 인증 세부 정보가 필요합니다. 앱 빌더는 다음과 같은 두 가지 기본 인증 접근 방식을 지원합니다.
- API 키 인증: 앱이 외부 API에 액세스할 수 있는 권한을 부여하는 자격 증명으로 직접 API 키를 제공합니다. 이 키는 API 사용 권한이 있음을 증명하는 역할을 합니다. API 키를 사용하는 방법은 빠르고 간단하여 내부 시스템이나 API를 제어하는 경우에 적합합니다.
- OAuth 2.0 인증: API 키를 입력하는 대신 OAuth 2.0이 앱과 외부 서비스 간의 안전한 핸드셰이크를 처리합니다. 이 방법은 API 키를 직접 처리하지 않고 세분화된 권한을 사용 설정하므로 더욱 안전합니다. 사용자가 앱에 데이터에 대한 액세스 권한을 명시적으로 부여해야 하는 타사 서비스에 가장 적합합니다.
앱 빌더는 AI 기반 웹 검색을 통해 타사 시스템의 요구 사항을 조사한 후 필요할 때 적절한 인증 설정 창을 자동으로 표시합니다. 인증 설정 창은 테스트 또는 게시를 클릭할 때에만 나타납니다.
자세한 내용은 앱 빌더에서 API 연결 보호하기를 참조하세요.
API 키 사용하기
API 키 연결을 만들 때 HTTP 헤더 이름을 지정해야 합니다. 연결을 사용하여 API 호출을 하면 Zendesk가 이 헤더에 대한 값으로 API 키를 전달합니다.
API 키 인증을 설정하는 정확한 단계는 연동 서비스에 따라 다릅니다. 다음은 일반적인 예시와 시각적 안내입니다.
- 도메인에 계정의 기본 URL을 입력합니다. 예: "testdomain"
- 프로젝트 키를 입력합니다. 이 앱을 연결하려는 프로젝트를 식별하는 고유 키입니다. 예: "HR"
- 계속을 클릭합니다.
- 테스트를 클릭합니다.
- 다음을 클릭합니다.
- 허용되는 도메인에 이 연결에 허용하려는 전체 도메인을 입력합니다. 예: testdomain.atlassian.net
- API 토큰을 입력합니다. 서비스에 대한 연결을 인증하는 데 사용되는 안전한 자격 증명입니다.
- 연동 서비스 만들기 및 앱 테스트를 클릭합니다.
OAuth 2.0 사용하기
앱 빌더는 타사 및 내부 API에 연결하기 위한 안전한 업계 표준 OAuth 2.0 프로토콜을 지원합니다. 즉, 정적 자격 증명을 공유하는 대신 토큰 기반 인증 플로우를 사용하여 외부 시스템이나 자체 API의 데이터에 액세스하는 앱을 안전하게 구축할 수 있습니다.
OAuth 2.0 인증 유형으로 연결을 만들기 전에 OAuth 클라이언트를 구성해야 합니다. OAuth 클라이언트를 구성할 때 외부 시스템의 OAuth 구성 인터페이스나 관리자 포털에서 클라이언트 ID, 클라이언트 비밀키, 인증 URL, 토큰 URL 및 범위가 필요합니다. 이러한 자격 증명은 외부 시스템과의 클라이언트 애플리케이션(예: Zendesk)을 등록하는 동안 생성됩니다. 정확한 단계는 외부 서비스에 따라 다릅니다. 앱 빌더는 외부 시스템에서 OAuth 클라이언트를 만들기 위한 설정 안내를 제공하려고 시도합니다. 하지만 앱 빌더에 필요한 세부 정보가 없는 경우에는 안내가 제공되지 않을 수 있습니다.
OAuth가 필요한 연동 서비스를 생성하는 데에는 두 가지 접근 방식이 있습니다.
-
명시적으로 OAuth 요청: 연동 서비스에 OAuth가 필요하다는 것을 알고 있다면 앱 빌더에 대한 프롬프트에서 직접 OAuth를 지정할 수 있습니다. 예를 들어 “Google 스프레드시트에서 Zendesk 티켓으로 링크를 추가할 수 있는 앱을 만들어주세요. 사용 가능한 Google 스프레드시트 목록이 표시됩니다. OAuth를 사용하여 Google에 연결하세요.' 'OAuth 사용'과 같은 요구 사항을 포함하면 앱 빌더가 올바른 OAuth 플로우를 사용하여 외부 플랫폼에 앱을 연결하는 과정을 단계별로 안내합니다.
-
OAuth 요구 사항 자동 감지: 인증 방법에 대한 전문가가 아니어도 시작할 수 있습니다. 프롬프트에 명시하지 않아도 'Google에 연결'과 같이 원하는 기능을 설명하면 앱 빌더가 OAuth가 필요한 시점을 인식합니다. 시스템에서 필요한 모든 권한 부여 단계를 안내합니다.
OAuth를 사용하는 생성된 앱에서 테스트를 클릭하는 경우
- OAuth 클라이언트 콜백 URL을 복사하여 안전한 위치에 저장합니다. 타사 OAuth 제공업체 시스템에서 OAuth 클라이언트를 만들 때 리디렉션 URI로 사용해야 합니다.
- 인증 유형으로 OAuth가 자동 선택됩니다. 이 옵션은 사용 중지되어 있어 수정할 수 없습니다.
- 연결에 허용되는 도메인을 입력합니다. 연결을 만든 후에는 허용되는 도메인을 변경할 수 없습니다.
- 클라이언트 ID를 입력합니다. 클라이언트의 사용자 이름과 유사하게 OAuth 클라이언트에 배정된 고유 식별자입니다.
- 클라이언트 비밀키를 입력합니다. OAuth 클라이언트를 등록할 때 발급되는 기밀 키입니다.
- 액세스 토큰 URL을 입력합니다. 액세스 토큰을 받는 데 사용되는 URL입니다.
- 권한 부여 URL을 입력합니다. 계정에 대한 애플리케이션 액세스 권한을 부여하는 URL입니다.
위 필드 대부분의 경우 앱 빌더가 값을 제안하고 자동으로 입력합니다. 하지만 항상 세부 정보가 올바른지 검토하고 확인하세요.
- 띄어쓰기로 구분된 기본 범위 목록을 입력합니다. 범위는 클라이언트 애플리케이션이 사용자 대신 액세스할 수 있는 항목을 나타내는 권한입니다.
- 다음을 클릭합니다.
- 권한 부여 유형 필드에 인증 코드를 입력합니다. OAuth 권한 부여 유형에 따라 앱 인증 방법이 결정됩니다.
- (선택 사항) '오프라인 액세스 허용'을 선택하여 새로 고침 토큰을 요청하고 사용자가 오프라인 상태인 동안 액세스를 유지합니다.
- (선택 사항) OAuth URL 하위 도메인을 입력합니다. 필요한 경우 OAuth 제공업체의 사용자 지정 하위 도메인을 입력합니다. 해당 사항이 없으면 비워 두세요.
-
연결을 클릭하고 계정을 선택합니다.
앱 빌더가 타사 OAuth 제공업체로 리디렉션하여 계정을 선택하고 액세스 권한을 부여합니다.
- 연결 ID를 복사합니다. 앱에서 인증된 요청을 구성하거나 만들 때 이 OAuth 연결을 참조하는 데 필요합니다.
- 계속을 클릭합니다.
다음 동영상은 앱 테스트를 포함한 OAuth 플로우의 예를 보여줍니다.
다음 동영상은 앱 게시를 포함한 OAuth 플로우의 예를 보여줍니다.
안내형 연동 서비스
인증이 필요한 비공개 또는 타사 서비스(예: API 키 또는 OAuth)에 연결할 때 앱 빌더의 AI는 대화의 프롬프트를 분석하여 필요한 연결 세부 정보를 결정합니다.
앱 빌더는 관련 인증 설정을 표시하고 안내에서 감지할 수 있는 모든 필수 정보를 자동으로 캡처합니다.
추가 세부 정보가 필요한 경우 앱 빌더가 필요한 자격 증명이나 구성을 입력하라는 메시지를 표시하여 연결 설정을 단계별로 안내합니다.
비공개 회사 시스템과 연동하기
비공개 또는 내부 시스템에 연결하려면 다음과 같이 하세요.
- 내부 문서나 개발팀으로부터 API 엔드포인트 및 인증 방법에 대한 정보(예: API 키 또는 OAuth 자격 증명이 필요한지 여부)를 얻습니다.
- 더 복잡한 연동 서비스의 경우에는 모든 필수 자격 증명(API 키, OAuth 토큰)을 수집하고 앱에서 사용할 입력 및 출력 데이터 형식을 정의합니다.
- 연결을 설정할 준비가 되었을 때 수집한 정보를 앱 빌더에 입력하면 나머지 단계를 안내받을 수 있습니다. 앱 빌더는 내부 시스템에 익숙하지 않으며 이러한 시스템에 대한 관련 문서나 세부 정보를 제공하는 경우에만 지원할 수 있습니다.
연동이 구성된 후에는 라이브 Zendesk 환경에 배포하기 전에 앱 빌더에서 테스트를 클릭하여 연동 기능을 확인합니다.
앱을 타사 플랫폼과 연동하기
앱 빌더를 사용하면 Jira, Slack, Google, Calendly, Workday 등과 같은 타사 애플리케이션에서 데이터를 표시하거나 조작할 수 있는 애플리케이션을 만들 수 있습니다. 단, 그러한 서비스에 공개 API가 있어야 합니다. 예를 들어 상담사가 Zendesk에서 나가지 않고도 고객 레코드, 티켓 로그, 인벤토리 목록 또는 워크플로우 추적기를 신속하게 보거나 업데이트할 수 있는 Google 스프레드시트 연동 서비스를 구축할 수 있습니다. 이 앱은 특정 스프레드시트나 범위의 실시간 데이터를 제시할 수 있으며, 상담사가 Zendesk 인터페이스에서 바로 새 항목을 추가하거나, 셀 값을 업데이트하거나, 이전 레코드를 보관할 수도 있습니다. 각 작업 후 앱이 상담사에게 작업이 성공적으로 완료되었는지 또는 연동에 문제가 있었는지를 알려줍니다.
문제 해결하기
앱 빌더에서 해결을 위해 추가적인 컨텍스트나 정보가 필요한 오류가 발생할 수 있습니다. 이러한 오류의 몇 가지 예는 다음과 같습니다.
- 미리 보기를 로드할 수 없습니다.
- 앱을 생성하거나 설치할 수 없습니다.
- 비공개 회사 시스템이나 타사 플랫폼과 연동할 수 없습니다.
앱 빌더에 문제가 발생하면 자동으로 해결을 시도합니다. 불가능한 경우 오류 메시지가 표시됩니다. 오류 세부 정보 표시를 클릭하여 문제에 대한 자세한 정보를 봅니다.
앱 빌더가 문제를 진단하고 해결할 수 있도록 대화에 명확하고 구체적인 세부 정보를 제공하세요. 여기에는 오류와 관련된 설명, 자격 증명 또는 누락된 컨텍스트가 포함될 수 있습니다. AI는 이 정보를 사용하여 문제를 더 잘 이해하고 문제를 해결하거나 추가 세부 정보를 요청합니다.
예를 들어, 예상 출력이 특정 데이터 형식이나 앱의 특정 응답이었지만 실제 출력이 다른 경우 이러한 불일치 사항을 자세히 설명하면 앱 빌더가 효과적으로 문제를 해결하고 적절한 솔루션을 제안할 수 있습니다. 피드백이 정확하고 상세할수록 AI 상호작용을 통해 더 잘 배우고 향후 시나리오에서 응답을 개선할 수 있습니다.
레코드를 가져오거나 업데이트하거나, 타사 앱과 연동하는 등 Zendesk 인스턴스에서 라이브 데이터로 앱을 테스트할 때 미리 보기 모드에서 모의 데이터를 사용하면 표시되지 않는 오류가 나타날 수 있습니다. 미리 보기가 로드되지 않는 코드 컴파일 문제가 없는 한 대부분의 앱이 미리 보기 탭에서 올바르게 작동하는 것 같습니다. 가드레일 알림은 실제 데이터로 테스트하는 동안 그러한 오류에 대해 알려줍니다. 오류가 발생하는 경우 세부 정보를 복사하여 대화에 붙여넣어 앱 빌더가 문제를 분석하고 해결할 수 있도록 도와주세요.
- 401: 권한이 부여되지 않은 오류 - 사용자에게 요청된 리소스에 액세스하는 데 필요한 권한이 없음을 나타냅니다.
- 403: 금지된 오류 - 사용자가 세션이 만료된 후 관리 센터에서 로그아웃한 상태에서 앱 빌더가 브라우저에 열려 있을 때 발생합니다. 연동 서비스 실패로 인해 발생할 수도 있습니다.
- 404: 찾을 수 없음 오류 - 이 오류는 URL이 깨졌거나 올바르지 않거나, 요청된 API 경로가 올바르지 않거나 사용할 수 없음을 나타낼 수 있습니다.
- 431: 요청 헤더 필드가 너무 큼 - 이 오류는 일반적으로 일련의 프롬프트가 이어진 후에 발생합니다. 이 문제를 해결하려면 브라우저에서 Zendesk 앱의 캐시와 쿠키를 지워 보세요.
- 503: 서비스를 이용할 수 없음 오류 - 이 오류는 서버가 너무 많은 요청을 받아 리소스 제한을 초과할 때 발생합니다. 유지 관리나 업데이트로 인해 서버가 다운된 경우에도 발생할 수 있습니다.
고지 사항 및 유지 관리
앱 빌더를 사용하여 만든 앱은 비 Zendesk 서비스로 간주됩니다. 사용자는 앱이 의도한 대로 작동하는지 확인하고 시간이 지남에 따라 이를 유지 관리할 책임이 있습니다. Zendesk는 앱 빌더로 구축된 앱의 기능, 지원 또는 지속적인 유지 관리를 보장하지 않습니다.
제한 사항
현재 제한 사항은 다음과 같습니다.
- 계정당 플랜별 대화 허용량:
- Suite Professional 및 Support Professional: 최대 5개의 앱 대화
- Suite Enterprise 및 Support Enterprise: 최대 10개의 앱 대화
- Suite Enterprise Plus: 최대 20개의 앱 대화
참고: 대화는 AI와 공동 작업하여 앱 아이디어를 계획하고, 수정하며, 해결하는 채팅 또는 프롬프트 집합입니다. 만들려는 각 새 앱에 대해 새 대화를 시작하세요. 모든 대화가 앱을 게시하는 것은 아닙니다.앱은 대화에서 게시하는 완성된 제품입니다. 게시된 후에는 상담사와 관리자가 사용할 수 있도록 Zendesk 계정에 앱이 설치됩니다.
대화 허용량은 한 번에 진행 중인 빌드 수만 제한합니다. 필요한 만큼 앱을 게시하고 배포할 수 있습니다. 게시된 앱 수에는 제한이 없으며, 동시에 진행할 수 있는 앱 대화 수에만 제한이 있습니다.
- 앱 대화를 삭제해도 게시된 앱 자체는 삭제되지 않습니다. 상담사와 관리자는 Zendesk에서 앱을 계속 사용할 수 있습니다. 하지만 대화를 삭제한 후에는 해당 앱을 편집하거나 업데이트할 수 없습니다. 추가로 변경하려면 새 대화를 만들고 앱의 새 버전을 구축해야 합니다.
- 앱 빌더에 액세스할 수 있는 모든 적격 고객은 약 3,600개의 프롬프트를 무료로 받을 수 있습니다. 제한은 근사값입니다. 자세한 내용은 다음 불릿을 참조하세요. 이 한도에 도달하면 앱 빌더에서 자격에 따라 최대 약 7,200개의 프롬프트로 일회성 증가를 요청할 수 있는 링크가 포함된 배너 알림을 표시합니다. 요청이 승인되지 않거나 더 높은 한도에 도달하는 경우에는 2월 1일에 연간 프롬프트 한도가 재설정될 때까지 기다려야 앱 빌더로 앱을 계속 구축할 수 있습니다.
- 허용되는 최대 프롬프트 수는 각 프롬프트의 예상 길이와 복잡성에 따라 다릅니다. 더 큰 프롬프트를 제출하면 전송할 수 있는 총 프롬프트 수가 그에 따라 감소합니다.
- 앱 빌더는 사용자 인터페이스에서 프롬프트 사용량을 추적하거나 표시하지 않습니다.
- 앱 빌더는 현재 입력 프롬프트를 50,000자로 제한하며 대화당 최대 200개의 메시지를 허용합니다. 또한 작업은 사용자마다 분당 6~12개의 요청으로 호출 빈도가 제한됩니다. 이러한 제한은 대화 수준에서 적용됩니다.
- 앱당 하나의 OAuth 제공업체만 사용 가능합니다. 동일한 앱에서 여러 OAuth 서비스(예: Google)에 연결할 수 없습니다.
- 단일 환경 내에서만 앱을 구축하고 사용할 수 있습니다. 샌드박스에서 프로덕션으로 또는 환경 간에 앱을 이동할 수 없으므로 다른 곳에서 앱을 사용하려면 수동으로 다시 생성해야 합니다.
- 기존 앱을 앱 빌더로 가져와서 편집하거나 개선할 수 없습니다. 새 앱을 만들거나 앱 빌더에서 처음에 시작한 앱에서만 작업을 계속할 수 있습니다.
- 새 앱을 시작할 때 앱의 위치를 선택해야 하며, 대화가 시작된 후에는 이 위치를 변경할 수 없습니다.
- 각 앱은 단일 위치에 대한 코드만 포함할 수 있습니다. 여러 위치에서 동일한 기능을 사용하려면 각 위치에 대해 별도의 앱 버전을 구축하고 관리해야 합니다.
- 앱 빌더의 앱은 자연어 프롬프트를 통해 완전히 생성 및 업데이트됩니다. 현재 이미지, 디자인 또는 문서를 입력으로 업로드하는 기능은 지원되지 않습니다.
- 테스트 중 앱에 오류가 발생하면 앱 빌더가 자동으로 해결하지 않습니다. 대신, 오류 세부 정보를 복사하여 AI에게 수정에 대한 도움을 요청해야 합니다.
- 대화가 길어질수록 전체 페이지 매김이 아직 지원되지 않으므로 성능이 저하될 수 있습니다.
- 변경 로그는 최근 10개 버전의 세부 정보만 추적합니다. 매우 긴 파일은 완전히 추적되지 않을 수 있으므로 앱의 모든 변경 내용에 대한 전체 기록을 항상 볼 수 있는 것은 아닙니다.
- 앱을 다운로드하면 개별 소스 파일이나 전체 구성 세부 정보가 아닌 컴파일된 코드를 받게 되므로 현재로서는 앱 빌더 외부에서 편집할 수 없습니다.
- 현재 타사 pdfjs-dist, tesseract.js 및 차트 라이브러리가 지원됩니다.