Zendesk 헬프 센터
헬프 센터의 카테고리, 섹션, 문서를 기존 언어 버전에 맞춰 번역하고, 동기화와 게시를 수동으로 관리하세요.
헬프 센터 콘텐츠를 Zendesk 밖으로 옮길 필요 없이 번역하세요. Lingo.dev 연결은 선택한 카테고리, 섹션, 문서를 헬프 센터의 기본 언어로 읽고, 로컬라이제이션 엔진으로 번역한 뒤 같은 항목에 대상 언어 버전을 저장합니다.
Studio 2.5 탐색 메뉴에서 설정 → 연동 대신 Studio 2.5 → 연동을 여세요. 기존 연결 및 설정 링크는 그대로 사용할 수 있습니다.
모든 실행은 수동으로 시작합니다. 문서가 변경되면 업데이트할 콘텐츠의 동기화를 시작하세요. 처음 저장하기 전에 번역을 초안으로 저장할지, 게시된 상태로 저장할지 선택하세요. 이미 게시된 대상 언어 버전을 초안으로 저장하면 다시 게시할 때까지 독자가 해당 언어 버전을 볼 수 없게 될 수 있습니다.
접근 권한과 헬프 센터 언어 준비하기 #
Zendesk 헬프 센터 연동을 사용하려면 Enterprise 요금제가 필요합니다. 현재 이용 가능 여부는 요금에서 확인하세요. 조직에 필요한 요금제 이용 권한이 없으면 설정 → 연동의 Zendesk 옆에 현재 요금제에서 이용 불가가 표시됩니다.
헬프 센터 콘텐츠에 접근할 수 있는 Zendesk 관리자 계정을 사용하세요. 레이더에서 활동을 수집하는 데 쓰이는 문서 게시 웹훅을 등록하려면 관리자 권한이 필요합니다. 저장 작업은 접근을 승인한 계정의 작업으로 기록되므로, 팀의 작업을 공통 계정으로 기록해야 한다면 적절한 서비스 계정을 사용하세요. Lingo.dev에서는 조직에 대한 권한과 연결 이용 권한, 선택한 로컬라이제이션 엔진에 대한 접근 권한이 모두 필요합니다.
헬프 센터의 언어 설정에서 대상 언어를 활성화하세요. Zendesk 계정 전체에 적용되는 로컬라이제이션 목록은 별개이며, 이 목록에 언어를 추가해도 헬프 센터 번역이 활성화되지는 않습니다. 적절한 권한이 있으면 읽기 전용 엔드포인트 https://<subdomain>.zendesk.com/api/v2/help_center/locales.json에서 헬프 센터의 로캘 구성을 확인할 수 있습니다.
Lingo.dev는 실행할 때마다 헬프 센터의 기본 언어를 읽어 원문 언어로 사용합니다. 연결 양식에서 다른 원문 언어를 선택하지는 않습니다.
연결하고 첫 문서 번역하기 #
- 설정 → 연동을 열고 Zendesk의 연결을 선택하세요. 이름과 헬프 센터 하위 도메인을 입력하세요.
acme.zendesk.com의 경우acme를 입력하세요. - Zendesk로 이동해 접근을 승인하세요. 승인이 완료되어야 연결이 생성됩니다.
- Studio의 연결됨에서 헬프 센터를 선택한 다음 설정하기를 선택하세요.
- 로컬라이제이션 엔진과 결과 저장 모드를 선택한 다음 계속을 선택하세요. 첫 실행에서는 헬프 센터에 활성화된 언어 중 대상 언어 하나를 선택하세요. 원문 언어는 제외되므로, 다른 언어가 없다면 먼저 Zendesk에서 활성화하세요.
- 문서를 열고 원문이 안정적으로 확정된 문서 하나의 동기화 스위치를 켜세요. 설정이 저장될 때까지 기다린 다음 해당 문서 행의 체크박스를 선택하고 동기화를 큐에 추가를 선택하세요.
- 워크플로 결과와 Zendesk에 저장된 실제 대상 문서를 확인하세요. 제목, 본문, 링크, 로캘, 초안 또는 게시 상태를 확인하세요. 게시되어야 하는 문서라면 독자가 보는 주소도 열어보세요.
첫 동기화에서는 완성된 기존 번역을 덮어쓰지 않고 그대로 사용해 텍스트와 초안 상태를 모두 보존합니다. 누락된 콘텐츠는 번역합니다. 기존 번역을 교체하려는 경우에는 재번역을 사용하세요.
번역할 영역 전체 선택하기 #
카테고리, 섹션, 문서에는 각각 별도의 표와 설정이 계속 유지되는 동기화 스위치가 있습니다. 카테고리의 스위치를 켜면 해당 카테고리의 이름과 설명만 번역하며, 그 안의 섹션이나 문서까지 활성화되지는 않습니다. 헬프 센터의 한 영역 전체를 준비하려면 섹션과 문서도 따로 선택하세요.
| 항목 | 번역되는 필드 |
|---|---|
| 카테고리 | 이름/제목 및 설명 |
| 섹션 | 이름/제목 및 설명 |
| 문서 | 제목 및 본문 |
행 체크박스를 사용하면 일회성 동기화를 큐에 추가 또는 재번역을 큐에 추가 작업을 동기화 스위치가 이미 켜진 항목 중 선택한 항목으로 한정할 수 있습니다. 행을 선택해도 계속 유지되는 스위치 설정이 켜지지는 않습니다. 헤더의 작업은 연결에서 활성화된 범위 전체에 적용됩니다. 시작하기 전에 작업이 어떤 선택 범위를 처리하는지 확인하세요.
문서 본문은 HTML 처리를 거쳐 서식, 링크, 삽입된 미디어가 재구성됩니다. 결과를 저장할 때 인식된 헬프 센터 링크를 대상 로캘에 맞게 조정할 수 있습니다. 결과에 포함된 링크를 확인하고, 번역된 대상 페이지가 실제로 존재하는지도 살펴보세요. 외부 링크와 사이트별 탐색 요소는 별도로 확인해야 합니다.
이 연결은 티켓, 매크로, 테마, 커뮤니티 게시물, Zendesk 콘텐츠 블록 기반 문서를 번역하지 않습니다. 헬프 센터 콘텐츠를 현지화하는 연결이며, 지원 티켓을 트리아지하는 연결은 아닙니다.
변경된 콘텐츠 업데이트 또는 교체하기 #
동기화는 현재 원문을 기록된 상태 및 기존 번역과 비교합니다. 일반적인 원문 업데이트, 누락된 콘텐츠, 이전 실행에서 끝내지 못한 작업을 처리할 때 사용하세요.
재번역은 원문이 바뀌지 않았더라도 선택한 항목과 언어의 번역을 다시 생성합니다. 사람이 수정하고 승인한 내용을 덮어쓸 수 있습니다. 넓은 범위에 적용되는 헤더 작업은 실행 전에 확인을 요청합니다. 선택한 행에 대한 작업도 원하는 교체 범위를 직접 선택해야 합니다.
연결당 한 번에 하나의 실행만 진행됩니다. 추가 요청은 큐에 쌓이며, 큐가 가득 차면 여유가 생길 때까지 기다려야 합니다. 워크플로 실행에서 결과를 확인할 수 있으며, 중지를 선택하면 아직 중단할 수 있는 작업이 취소됩니다. 최신 상태라는 결과는 선택된 변경 사항 중 처리할 것이 없었다는 뜻이지, 번역 품질을 새로 평가했다는 뜻은 아닙니다.
독자에게 보이는 내용 확인하기 #
게시 모드는 번역을 게시된 상태로 저장합니다. 초안 모드는 Zendesk에서 검토할 수 있도록 로캘 버전을 미게시 상태로 저장합니다. 이미 게시된 언어 버전을 초안 모드로 업데이트하면 누군가 다시 게시할 때까지 기존 게시 버전이 독자에게 보이지 않을 수 있습니다. 업데이트를 시작하기 전에 이러한 공개 중단이 릴리스에 문제가 없는지 판단하세요.
저장 후 대상 주소를 원하는 언어로 열어 확인하세요. 실제 제목과 본문을 원문의 해당 수정본과 비교하고, 링크를 열어보며, 원문 언어가 남아 있는지 살펴보세요. 번역 실행 완료는 릴리스 과정의 한 단계일 뿐이며, 승인과 게시는 여전히 편집상의 판단이 필요합니다.
원문 변경과 부분 완료 결과에 대응하기 #
결과를 저장할 때는 원문 항목을 다시 읽습니다. 작업 계획을 세운 뒤 원문이 변경되거나 삭제되었다면 Lingo.dev는 해당 대상을 건너뜁니다. 원문이 준비되면 수동 동기화를 다시 실행해 새로운 상태를 반영하세요.
한 로캘에서 실패해도 다른 곳에 성공적으로 저장된 결과는 취소되지 않습니다. 저장된 항목, 건너뛴 항목, 실패한 항목을 확인한 다음 영향을 받은 범위만 다시 시도하세요. 헬프 센터 전체를 강제로 처리하면 원래 원인은 해결하지 못한 채 이미 승인된 텍스트를 덮어쓸 수 있습니다.
결과가 없다면 항목 선택, 활성화된 헬프 센터 언어, 로컬라이제이션 엔진 접근 권한, 결과 저장 모드, 콘텐츠 블록 제외 여부, 원문 변경 여부를 확인하세요. 완성된 기존 번역을 그대로 사용하는 경우에는 의도적으로 새 텍스트를 생성하지 않습니다. Zendesk에서 대상 언어가 비활성화되었다면 실행 시 해당 언어를 건너뜁니다. 연결의 대상 언어 선택을 갱신하세요.
Zendesk에 일시적인 장애가 발생했다면 서비스가 복구된 후 다시 시도하세요. 접근 승인을 복원해야 한다면 기존 연결에서 다시 연결을 사용하세요. 연결을 해제하고 새로 만들면 동기화 상태가 사라집니다.
연결 해제 또는 다시 연결하기 #
Studio에서 헬프 센터의 설정 탭을 열어 대상 언어, 로컬라이제이션 엔진, 모드를 변경하세요. 설정 → 연동에서는 계정 이름을 바꾸거나 계정을 다시 연결할 수 있습니다. 기존 연결의 접근 승인을 복원하려면 다시 연결을 사용하세요.
연결을 해제하면 읽기와 저장이 중단되고 로컬 연결, 실행 기록, 항목별 동기화 기록이 삭제됩니다. 기존 Zendesk 번역은 그대로 유지됩니다. 이후 새 연결을 만들면 새로운 기준 상태가 설정됩니다. 첫 동기화에서는 이미 있는 완성된 번역을 유지하고 누락된 콘텐츠를 채웁니다. 접근을 종료해야 한다면 제공업체의 접근 승인도 별도로 취소하세요. 이전에 게시된 문구를 복원해야 할 때는 Zendesk에서 직접 복원하세요.
레이더에서 활동 수집하기 #
이 연결은 레이더에 헬프 센터 활동도 제공합니다. 측정용 번역 수집에서는 이벤트 설정과 과거 데이터 측정을 실행하기 전에 제공업체 기록을 가져오는 방법을 설명합니다.
수동 번역은 작동하지만 새 문서 활동이 보이지 않는다면 연결의 웹훅 등록 및 전달 상태를 확인하세요. 관리자 계정이 아니어서 웹훅을 등록할 수 없더라도 접근 승인은 성공할 수 있습니다. 설정 → 연동에서 기존 Zendesk 연결의 다시 연결을 선택하고 관리자 계정으로 접근을 승인하세요. 자동 수집에 의존하기 전에 테스트 문서를 게시하고 레이더에서 해당 이벤트를 확인하세요.