Zendesk 헬프 센터를 로컬라이제이션 엔진에 연결하세요. 번역할 카테고리, 섹션, 문서를 선택하면 Lingo.dev가 대상 언어로 번역한 뒤, 번역 결과를 Zendesk에 다시 반영합니다.
Zendesk Guide(헬프 센터) 콘텐츠인 카테고리, 섹션, 문서와 함께 작동합니다.
Zendesk 통합은 조직별로 활성화됩니다. Settings -> Integrations에 보이지 않는다면 문의해 주세요. 저희가 바로 켜드리겠습니다.
시작하기 전에#
다음 세 가지가 필요합니다:
Zendesk 관리자 권한. 연결은 OAuth를 사용하며, 승인하는 계정에는 헬프 센터 콘텐츠를 관리할 권한이 있어야 합니다.
Zendesk에서 대상 언어를 활성화하세요. Zendesk는 Help Center에 이미 등록된 언어에 대해서만 번역을 받을 수 있습니다. Zendesk의 Knowledge -> Settings -> Language settings에서 해당 언어를 활성화해 주세요.
Admin Center -> Account -> Appearance -> Localization에 추가한 언어는 별도 목록으로 관리되며, Help Center 언어를 활성화하지는 않습니다.
Help Center에서 정확히 어떤 언어를 지원하는지 확인하려면 관리자 계정으로 로그인한 상태에서
https://<subdomain>.zendesk.com/api/v2/help_center/locales.json을 여세요. 그 엔드포인트에 표시되는 항목이 Lingo.dev에서 선택할 수 있는 항목입니다.로컬라이제이션 엔진. 헬프 센터 번역은 이 엔진의 용어집, 브랜드 보이스, 규칙을 따릅니다.
로캘 코드는 Zendesk와 정확히 일치해야 합니다
Zendesk는 en-us, de-de 같은 코드를 사용합니다. 헬프 센터 원본 언어가 en-us로 표시된다면, Lingo.dev에서는 일반 English가 아니라 **English (United States)**를 선택하세요. 둘은 서로 다른 로캘(en-US vs en)이며, 이 불일치가 연결 실패의 가장 흔한 원인입니다.
헬프 센터 연결하기#
통합 열기
Settings -> Integrations로 이동한 뒤 Zendesk 아래의 Connect를 클릭하세요.
양식 입력
| 필드 | 입력할 내용 |
|---|---|
| 서브도메인 | Zendesk URL에서 라벨 부분만 입력하세요. https://acme.zendesk.com라면 acme만 입력하면 됩니다. https://도, .zendesk.com도 넣지 마세요 |
| 엔진 | 이 콘텐츠를 번역할 로컬라이제이션 엔진 |
| 원본 로캘 | 문서가 작성된 언어로, Zendesk에 표시된 값과 정확히 일치해야 합니다 |
| 대상 로캘 | 번역할 언어입니다. 모든 언어는 먼저 Zendesk에서 활성화되어 있어야 합니다 |
| 초안으로 저장 | 번역을 미게시 초안으로 저장하려면 켜 두고, 바로 게시하려면 끄세요 |
Zendesk에서 승인
Zendesk로 이동합니다. Allow를 클릭하세요. 그러면 Lingo.dev의 Zendesk 페이지로 돌아오고 연결이 활성화됩니다.
번역할 항목 선택하기#
Zendesk 페이지에는 Content와 Runs 두 개의 탭이 있습니다.
Content 탭에는 헬프 센터의 모든 항목이 하나의 표에 정리되어 있습니다. 카테고리, 섹션, 문서를 모두 한곳에서 볼 수 있습니다. 위쪽의 필터 칩(All, Categories, Sections, Articles)으로 목록을 좁히고, 체크박스로 번역할 항목을 선택하세요. 각 행의 이름은 Zendesk의 해당 항목으로 연결되므로, 무엇을 선택하는지 바로 확인할 수 있습니다.
카테고리를 선택해도 그 안의 항목까지 선택되지는 않습니다
카테고리, 섹션, 문서는 각각 따로 선택됩니다. 카테고리 전체를 번역하려면 카테고리 및 그 안의 섹션과 문서도 함께 선택해야 합니다.
동기화 전에 먼저 저장하세요. 새 연결은 빈 범위에서 시작하며, 동기화는 현재 화면에서 체크된 항목이 아니라 저장된 범위를 기준으로 진행됩니다. 아무것도 저장하지 않은 상태에서 먼저 동기화하면 실행 결과가 번역할 내용 없음으로 돌아옵니다. 먼저 저장을 클릭한 다음 번역하세요.
번역되는 항목#
| 항목 | 번역되는 필드 |
|---|---|
| 카테고리 | 제목, 설명 |
| 섹션 | 제목, 설명 |
| 문서 | 제목, 본문 |
문서 본문은 HTML로 번역되므로 서식, 링크, 임베드된 미디어도 그대로 유지됩니다.
동기화와 재번역#
버튼은 두 개이고, 역할도 서로 다릅니다:
| 버튼 | 기능 | 사용 시점 |
|---|---|---|
| Sync | 마지막 실행 이후 변경된 내용만 번역합니다 | 정기적으로 업데이트할 때 사용합니다. 대부분의 경우 이 버튼을 쓰면 됩니다 |
| Retranslate | 범위에 포함된 모든 항목을 처음부터 다시 번역합니다 | 엔진의 용어집, 브랜드 보이스, 규칙을 변경한 뒤 기존 번역을 새로 생성하고 싶을 때 사용합니다 |
두 기능은 모두 두 곳에서 사용할 수 있습니다. 페이지 헤더에서는 저장된 전체 범위에 적용되고, 콘텐츠 표 위에서는 현재 선택한 행에만 적용됩니다.
실행은 수동으로만 시작됩니다. Zendesk에서 문서를 수정해도 자동으로 실행되지 않으며, 언제 번역할지는 직접 결정합니다.
한 번에 실행할 수 있는 작업은 하나뿐입니다. 실행 중인 작업이 있으면 두 버튼 모두 비활성화됩니다.
실행 상태 확인하기#
Runs 탭에는 모든 실행이 상태, 실행을 시작한 방식, 시작 시간, 소요 시간과 함께 표시됩니다. 아직 진행 중인 실행은 목록에서 취소할 수 있습니다.
실행을 열면 상세 정보를 볼 수 있습니다. Zendesk에서 콘텐츠를 가져오는 중인지, 번역 중인지, 다시 써넣는 중인지 등 현재 단계를 비롯해 전체 진행률과 대상 언어별 진행률까지 확인할 수 있어, 독일어는 완료됐고 일본어는 아직 진행 중인지 한눈에 파악할 수 있습니다.
번역할 내용 없음으로 실행이 종료돼도 실패는 아닙니다. 범위에 포함된 모든 항목이 이미 번역본과 일치한다는 뜻이며, 중간에 아무것도 수정하지 않은 채 두 번 동기화했을 때 나오는 정상적인 결과입니다.
번역이 반영되는 위치#
각 번역은 같은 문서, 섹션 또는 카테고리에 로캘별 버전으로 연결됩니다. 이는 Zendesk의 기본 번역 방식입니다. 독자는 Help Center에서 언어만 전환하면 해당 번역을 보게 되며, 별도로 복제되거나 이동되는 항목은 없습니다.
번역 작성자로 표시되는 계정
Zendesk에서는 Sync를 클릭한 사람이 아니라, 연결을 승인한 계정이 모든 번역의 작성자로 표시됩니다. Help Center 전체에 특정 팀원 한 명의 이름이 표시되지 않게 하려면, 공유 서비스 계정으로 연결하세요.
초안 vs 게시#
초안으로 저장이 켜져 있으면 번역은 Zendesk에 미게시 초안으로 들어갑니다. 누군가 Zendesk에서 이를 검토하고 게시하기 전까지는 고객에게 아무것도 보이지 않습니다. 기본값으로 두기 안전한 설정이며, 번역 품질을 평가하는 동안에도 유지하기 좋습니다.
이 옵션을 끄면 번역은 작성되는 즉시 게시됩니다.
이 설정은 나중에 Settings -> Integrations -> Zendesk에서 엔진, 대상 언어와 함께 변경할 수 있습니다.
연결 해제#
연결을 해제하면 연결 정보, 실행 기록, 그리고 각 문서에서 무엇이 이미 번역되었는지에 대한 기록이 함께 삭제됩니다. 다만 이미 Zendesk에 작성된 번역은 그대로 남아 있습니다. 그 번역은 저희가 아니라 여러분의 Help Center에 속합니다.
다시 연결하면 처음부터 시작됩니다
문서별 동기화 상태가 사라지기 때문에, 다시 연결한 뒤 첫 번째 동기화에서는 전체 범위를 새로운 콘텐츠로 보고 전부 다시 번역합니다. 그만큼 비용도 다시 발생합니다. 연결 해제는 문제 해결용이 아니라, 정말 중단할 때만 사용하세요.
제한 사항#
| 제한 | 세부 정보 |
|---|---|
| 콘텐츠 유형 | 카테고리, 섹션, 아티클만 지원됩니다. 티켓, 매크로, 테마, 커뮤니티 게시물은 지원되지 않습니다. |
| 콘텐츠 블록 | Zendesk 콘텐츠 블록으로 구성된 문서는 번역되지 않습니다 |
| 트리거 | 수동만 지원 - 웹훅 없음, 문서가 변경돼도 자동 동기화 없음 |
| 동시 실행 | 연결당 1개 |
| 대상 언어 | 실행 결과를 쓸 수 있으려면 먼저 Zendesk 헬프 센터에서 활성화되어 있어야 합니다 |
문제 해결#
Allow를 클릭하자마자 연결에 실패해요. 대부분은 로캘 불일치 때문입니다. 선택한 소스 로캘이 Help Center에 존재하지 않습니다. https://<subdomain>.zendesk.com/api/v2/help_center/locales.json을 열어 거기에 표시된 정확한 코드를 확인한 뒤, 그 코드로 다시 연결해 주세요.
드롭다운에서 대상 언어가 보이지 않아요. 먼저 Zendesk의 Knowledge -> Settings -> Language settings에서 해당 언어를 활성화한 다음, Lingo.dev에서 설정 화면을 다시 열어 주세요.
동기화 결과 번역할 내용이 없다고 표시됩니다. 저장된 범위가 비어 있거나 - Content 탭에서 콘텐츠를 선택하고 저장을 클릭하세요 - 해당 범위의 모든 항목이 이미 최신 상태라는 뜻입니다.
번역이 헬프 센터에 나타나지 않습니다. 연결이 초안 모드인지 확인하세요. 초안은 Zendesk에는 존재하지만 게시되기 전까지는 고객에게 보이지 않습니다.
