Zendesk 헬프 센터

Zendesk Help Center를 로컬라이제이션 엔진에 연결하세요. 번역할 카테고리, 섹션, 아티클에 Sync를 켜면 Lingo.dev가 Help Center의 언어로 번역한 뒤, 그 결과를 Zendesk에 다시 써 넣습니다.

Zendesk Guide(헬프 센터) 콘텐츠인 카테고리, 섹션, 문서와 함께 작동합니다.

Zendesk는 Enterprise에서 이용할 수 있습니다. Connect 페이지에 Zendesk is not on your plan이라고 표시되면 문의해 주세요. 저희가 해결해 드릴게요.

시작하기 전에#

다음 세 가지가 필요합니다:

• Zendesk 관리자 액세스 권한. 연결에는 OAuth가 사용되며, 인증하는 계정에는 Help Center 콘텐츠를 관리할 권한이 있어야 합니다. Lingo.dev가 Zendesk에 쓰는 모든 번역은 Zendesk에서 해당 계정의 작업으로 표시되므로, Help Center 전체에 특정 팀원의 이름이 표시되지 않게 하려면 공유 서비스 계정으로 연결하세요.

• Zendesk에서 대상 언어 활성화. Lingo.dev는 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가 제공하는 항목입니다.

• 로컬라이제이션 엔진. 헬프 센터 번역은 이 엔진의 용어집, 브랜드 보이스, 규칙을 따릅니다.

원본 언어는 직접 고르는 것이 아닙니다. Lingo.dev는 실행할 때마다 Zendesk에서 Help Center의 기본 언어를 읽어 옵니다.

헬프 센터 연결하기#

번역할 항목 선택하기#

연결 페이지에는 Categories, Sections, Articles, Workflow runs, Settings의 다섯 개 탭이 있습니다.

처음 세 탭에는 해당 유형의 콘텐츠가 한 행에 하나씩 표시되며, 이름과 ID를 검색할 수 있는 검색창도 있습니다. 각 행의 이름은 Zendesk의 해당 항목으로 연결되므로 무엇을 선택하는지 바로 확인할 수 있습니다. 각 행에는 Sync 스위치가 있어, 켜는 순간부터 해당 항목이 연결 대상에 포함됩니다. 변경 사항은 스위치를 바꾸는 즉시 저장되며 Save 버튼은 없습니다. 표 헤더의 스위치를 사용하면 목록 전체의 Sync를 한 번에 켜거나 끌 수 있습니다.

체크박스는 일회성 실행용입니다. 행을 선택하면 **Queue sync (N)**와 Queue retranslation (N) 두 버튼이 나타나며, Sync가 켜진 항목은 그대로 둔 채 선택한 행만 실행합니다.

번역되는 항목#

문서 본문은 HTML로 번역되므로 서식, 링크, 임베드된 미디어도 그대로 유지됩니다.

동기화와 재번역#

버튼은 두 개이고, 역할도 서로 다릅니다:

두 기능은 모두 페이지 헤더에 있으며, 여기서는 Sync가 켜진 모든 항목에 적용됩니다. 행을 선택하면 표 위에도 나타나며, 이 경우에는 선택한 행에만 적용됩니다. 헤더에서 Retranslate를 실행하면 먼저 확인을 요청하는데, 선택된 모든 항목과 모든 언어에 대해 비용이 청구되기 때문입니다.

실행은 수동으로만 시작됩니다. Zendesk에서 문서를 수정해도 자동으로 실행되지 않으며, 언제 번역할지는 직접 결정합니다.

연결당 한 번에 하나의 실행만 가능합니다. 실행 중일 때 다른 실행을 요청하면 그 뒤에 대기열로 추가되며, 대기열이 가득 찼다면 실행 하나가 끝난 뒤 다시 시도하세요.

실행 상태 확인하기#

Workflow runs 탭에서는 모든 실행을 확인할 수 있습니다. 시작 시각, 무엇이 실행을 트리거했는지, 어떤 언어를 대상으로 했는지, 얼마나 걸렸는지, 그리고 상태가 표시됩니다. 아직 진행 중인 실행에는 Stop 버튼이 있습니다. 행을 열면 언어별 결과도 볼 수 있습니다.

실행이 Up to date로 끝나더라도 실패는 아닙니다. 마지막 실행 이후 변경된 내용이 없었다는 뜻이며, 중간에 아무것도 수정하지 않고 두 번 동기화했을 때 나오는 정상적인 결과입니다.

번역이 반영되는 위치#

각 번역은 같은 문서, 섹션 또는 카테고리에 로캘별 버전으로 연결됩니다. 이는 Zendesk의 기본 번역 방식입니다. 독자는 Help Center에서 언어만 전환하면 해당 번역을 보게 되며, 별도로 복제되거나 이동되는 항목은 없습니다.

초안 vs 게시#

Draft 모드에서는 번역이 Zendesk에 게시되지 않은 초안으로 들어갑니다. 누군가 Zendesk에서 검토하고 게시하기 전까지는 독자에게 아무것도 보이지 않습니다. Help Center에 아직 번역이 없고 품질을 평가하는 중이라면 이 모드로 시작하는 것이 좋습니다.

Publish 모드에서는 번역이 작성되는 즉시 게시됩니다.

나중에 Settings 탭에서 엔진, 대상 언어와 함께 모드도 변경할 수 있습니다.

설정#

설정 탭에서는 이 연결이 어떤 헬프 센터의 내용을 가져오는지와 Sync된 콘텐츠 양을 확인할 수 있으며, 이름, 대상 언어, 엔진, 모드도 변경할 수 있습니다. 변경 사항은 수정하는 즉시 저장됩니다.

선택한 언어가 더 이상 Zendesk에서 활성화되어 있지 않으면 탭에 그 사실이 표시됩니다. 동기화에서는 해당 언어를 건너뛰고, 목록을 다음에 변경할 때 그 언어는 제거됩니다.

연결 해제#

Settings 탭 하단의 Disconnect는 Lingo.dev가 Help Center를 읽고 쓰는 작업을 중지합니다. 연결, 실행 기록, 그리고 어떤 아티클이 이미 번역되었는지에 대한 기록도 함께 삭제됩니다. 이미 작성된 번역은 Zendesk에 그대로 남습니다. 그 번역은 저희가 아니라 여러분의 Help Center에 속합니다.

제한 사항#

문제 해결#

Connect 페이지에 Zendesk is not on your plan이라고 표시됩니다. Zendesk는 Enterprise에서 이용할 수 있습니다. 문의해 주시면 저희가 해결해 드릴게요. 그동안 이미 연결된 항목은 계속 작동합니다.

Connect 페이지에 you cannot connect this라고 표시됩니다. 연결하려면 현재 역할에 없는 권한이 필요합니다. 조직 관리자가 직접 연결하거나, 해당 권한을 부여할 수 있습니다.

대상 언어가 목록에 없습니다. 먼저 Zendesk의 Knowledge -> Settings -> Language settings에서 해당 언어를 활성화한 다음, Lingo.dev에서 Settings 탭을 다시 여세요. 목록은 매번 Zendesk에서 새로 읽어 옵니다.

Allow를 누른 뒤 Lingo.dev가 Zendesk에서 언어를 추가하라고 안내합니다. Help Center가 한 가지 언어로만 작성되어 있고 다른 언어는 제공하지 않기 때문에, 아직 번역할 대상 언어가 없습니다.

동기화가 Up to date로 끝납니다. 마지막 실행 이후 변경된 내용이 없었거나, 아직 Sync가 켜진 항목이 없는 것입니다. 번역하려는 콘텐츠의 Sync를 Categories, Sections, Articles 탭에서 켜세요.

번역이 Help Center에 나타나지 않습니다. 연결이 Draft 모드인지 확인하세요. 초안은 Zendesk에는 존재하지만 게시되기 전까지는 독자에게 보이지 않습니다.

다음 단계#