젠데스크 앱은 젠데스크 헬프센터의 문서를 채널톡 도큐먼트로 자동으로 가져오는 앱이에요. 한 번 연동하면 새 문서와 변경된 내용을 주기적으로 확인해 그대로 반영합니다. 도움말 문서를 두 곳에서 따로 관리하지 않아도 돼요.
젠데스크 헬프센터와 채널톡 도큐먼트를 함께 쓰면, 문서를 고칠 때마다 양쪽을 모두 수정해야 해서 내용이 어긋나기 쉬워요. 젠데스크 앱은 젠데스크에 게시된 문서를 채널톡 도큐먼트로 한 번에 가져오고, 이후 변경 사항을 자동으로 반영해 두 곳의 문서를 같은 상태로 유지합니다. 젠데스크에서 문서를 내리면 채널톡 도큐먼트에서도 비공개로 바뀌어, 고객에게 오래된 정보가 노출되지 않아요.
젠데스크에서 채널톡으로 옮겨오면서 기존 도움말 문서를 다시 만들기 막막한 분
젠데스크와 채널톡 도큐먼트 양쪽에 같은 문서를 두 번 올리느라 번거로운 분
젠데스크 앱 기능을 사용하려면 아래 조건을 충족해야 해요.
젠데스크 계정 및 젠데스크 API Token이 필요합니다.
채널톡 도큐먼트 내 문서를 동기화할 스페이스가 필요합니다.
새 스페이스 생성 방법
[팀] - [도큐먼트]에서 새 스페이스를 만들어 주세요.
스페이스가 없는 경우: 도큐먼트 화면 중앙의 스페이스 만들기 버튼을 클릭해요.
스페이스가 있는 경우: 도큐먼트 왼쪽 사이드바 상단의 스페이스 리스트를 클릭한 뒤 새 스페이스 만들기 버튼을 클릭해요.
스페이스명과 기본 URL을 입력하고 [만들기]를 클릭합니다.
앱을 연동하면 젠데스크 헬프센터에 게시된 문서를 한 번에 가져와요.
연동 이후 24시간마다 전체 문서를 확인해 변경된 내용만 채널톡 도큐먼트에 반영합니다. 젠데스크의 변경 유형에 따라 아래와 같이 처리됩니다.
젠데스크에서 일어난 일 | 채널톡 도큐먼트 반영 |
|---|---|
❶ 새 문서 게시 | → 새 아티클 생성 및 퍼블리시 |
❷ 문서 내용 변경 | → 기존 아티클에 새 리비전 생성 및 퍼블리시 |
❸ 공개 상태만 변경 | → 기존 아티클 공개 상태만 변경 |
❹ 문서 보관·삭제 | → 기존 아티클 비공개로 전환 |
❺ 삭제한 문서 복원 | → 기존 아티클을 다시 사용해 퍼블리시 |
채널톡 관리자 화면에서 [채널 설정] - [앱스토어] - [Zendesk]에서 앱을 설치해 주세요.
젠데스크 앱의 [설정] 탭에서 Zendesk API 인증 항목을 입력해 주세요.
subdomain: 관리자가 젠데스크에 접속할 때 쓰는 주소예요.
접속 주소가 'https://test.zendesk.com' 이라면 'test' 또는 'https://test.zendesk.com' 그대로 입력해요.
Custom Help Center 도메인은 사용할 수 없어요.
email: 아래의 API Token을 발급한 젠데스크 사용자의 계정 이메일이에요.
API Token: 젠데스크 관리 센터의 [앱 및 연동 서비스] - [API] - [API 토큰]에서 발급할 수 있어요. 토큰을 발급하려면 젠데스크 관리자 권한이 필요해요.
Document space 항목에서 젠데스크 문서를 동기화할 스페이스를 선택한 뒤, [설정 저장] 버튼을 눌러주세요. 저장하면 연동이 완료돼요. 문서는 저장 직후가 아니라 다음 동기화 주기에 들어오며, 첫 동기화까지 최대 2시간이 걸릴 수 있어요.
첫 동기화가 끝나면(최대 24시간) 스페이스에 젠데스크 문서가 들어왔는지 확인해주세요. 젠데스크에 게시된 문서가 문서 목록에 생성되고, 이후에는 별도 작업 없이 24시간 마다 변경 사항이 자동으로 반영됩니다. 즉시 동기화를 진행하고 싶다면, [동기화] 탭 클릭 후 [지금 전체 동기화]를 클릭해 주세요.
참고 사항
젠데스크의 카테고리, 섹션 구조를 채널톡 도큐먼트 폴더 구조로 옮기는 기능은 지원하지 않아요
문서 본문의 이미지는 젠데스크 이미지 주소를 그대로 사용해요.
일반 파일 첨부는 동기화하지 않아요.
젠데스크 전용 CSS와 일부 임베드 요소는 지원되지 않아 원문과 세부 표현이 다를 수 있어요.
젠데스크 앱의 [동기화] 탭에서 동기화가 잘 되고 있는지 한눈에 확인할 수 있어요.
마지막 동기화 시간
마지막 성공: 가장 최근에 동기화가 완료된 시각이에요.
다음 자동 동기화 예정: 다음 동기화가 실행될 예정 시각이에요.
화면은 60초마다 자동으로 갱신되므로 새로고침하지 않아도 최신 상태를 볼 수 있어요.
동기화 상태
상태 | 설명 |
|---|---|
동기화 실행 전 | 아직 동기화가 한 번도 실행되지 않았어요 |
전체 동기화 진행 중 | 지금 동기화가 진행되고 있어요 |
수동 동기화 대기 중 | 수동 동기화 요청이 접수되어 실행을 기다리고 있어요 |
전체 동기화 완료 | 가장 최근 동기화가 정상적으로 끝났어요 |
일부 문서 동기화 실패 | 일부 문서에서 오류가 발생했어요 |
전체 동기화 실패 | 동기화 전체가 실패했어요 |
오류 재시도 대기 중 | 실패한 동기화를 다시 시도할 예정이에요 |
확인이 필요한 문서가 있음 | 확인이 필요한 문서가 있어요 |
지금 전체 동기화 (수동 동기화)
자동 동기화 주기를 기다리지 않고 바로 반영하고 싶다면 [동기화] 탭 오른쪽 위의 [지금 전체 동기화] 버튼을 눌러주세요.