Zendesk 帮助中心
将您的 Zendesk 帮助中心连接到本地化引擎。为想要覆盖的类别、版块和文章开启同步后，Lingo.dev 会将它们翻译成您的帮助中心已启用的语言，并把译文写回 Zendesk。
支持 Zendesk Guide（帮助中心）内容：分类、分区和文章。
Zendesk 需使用 Enterprise 方案。如果“连接”页面显示 Zendesk 不在您的方案内，请联系我们，我们会帮您处理。
开始前#
您需要准备三样东西：
需要 Zendesk 管理员权限。 连接通过 OAuth 完成授权，授权账户需要具备管理帮助中心内容的权限。Lingo.dev 写入的每条翻译在 Zendesk 中都会归属于该账户，所以如果您不希望整个帮助中心都显示某位队友的姓名，建议使用共享服务账户进行连接。
先在 Zendesk 中启用目标语言。 Lingo.dev 只会提供您的帮助中心已启用的语言，不会多也不会少。请前往 Zendesk 的 Knowledge -> Settings -> Language settings 启用它们。
在 Admin Center -> Account -> Appearance -> Localization 中添加的语言属于另一份独立列表，不会启用帮助中心语言。
如需准确查看您的帮助中心支持哪些语言，请以管理员身份登录后打开
https://<subdomain>.zendesk.com/api/v2/help_center/locales.json。该端点列出的内容，就是 Lingo.dev 会提供的语言。一个本地化引擎。 您的帮助中心翻译会遵循它的术语表、品牌语气和规则。
源语言无需手动选择：Lingo.dev 每次运行时都会从 Zendesk 读取您帮助中心的默认语言。
帮助中心已经翻译过了？
首次同步会保留 Zendesk 中已有的译文。对于每个条目和语言，如果 Zendesk 里已经有完整译文，Lingo.dev 会原样保留，只翻译缺失的部分。若要替换现有译文，请使用 重新翻译。
连接帮助中心#
打开集成
前往 Studio -> All integrations，然后在 Zendesk 卡片上点击 Connect。
填写表单
| 字段 | 填写内容 |
|---|---|
| 名称 | 为这个连接命名，方便你区分各个帮助中心 |
| 帮助中心 | 只需填写 Zendesk URL 中的子域名。对于 https://acme.zendesk.com，请输入 acme——表单后方会显示 .zendesk.com |
| 引擎 | 这些翻译所使用的本地化引擎，其术语表、规则和品牌语调会应用到译文中 |
| 模式 | 草稿 会将翻译写为未发布的草稿，发布 会在写入后立即上线。请参阅下方“草稿与已发布” |
点击 Continue to Zendesk。
在 Zendesk 中授权
Zendesk 会要求您授予 Lingo.dev 访问权限。点击 Allow。在您这样做之前，不会创建任何内容：如果点击 Deny，您会返回表单页面，且不会建立连接。
选择语言
回到 Lingo.dev 后，您会看到帮助中心已启用的语言列表，但默认语言不会显示在内。所有语言都会默认选中。取消勾选不需要的语言，然后点击 Save and open。
如果帮助中心只有一种语言，Lingo.dev 会先提示您到 Zendesk 中添加一种语言。
选择要翻译的内容#
连接页面共有五个标签页：Categories、Sections、Articles、Workflow runs 和 Settings。
前三个标签页会分别列出对应类型的内容，每行一项，并提供可按名称和 ID 搜索的搜索框。每一行的名称都链接到 Zendesk 中对应的项目，方便您确认自己选择的内容。每一行都有一个 Sync 开关：打开后，该项目此后就会纳入此连接。您切换开关后，更改会立即保存，无需点击保存按钮。表头中的开关可为列表中的所有内容统一开启或关闭同步。
复选框用于一次性运行。勾选行后，会出现两个按钮：Queue sync (N) 和 Queue retranslation (N)，它们只会运行这些行，不会更改哪些项目已开启 Sync。
不会自动级联
开启某个类别只会翻译它自己的名称和描述，不会翻译其下的版块和文章。若要覆盖整个类别，还需要在“文章”标签页中为相关文章开启同步。表头开关会开启列表中的所有项目，您也可以取消勾选不需要的项目。
会翻译哪些内容#
| 项目 | 翻译字段 |
|---|---|
| 分类 | 标题、描述 |
| 分区 | 标题、描述 |
| 文章 | 标题、正文 |
文章正文会按 HTML 进行翻译，因此格式、链接和嵌入媒体在整个往返过程中都能保留下来。
同步与重新翻译#
两个按钮，各司其职：
| 按钮 | 作用 | 适用场景 |
|---|---|---|
| Sync | 只翻译自上次运行以来发生变化的内容 | 适合日常更新。大多数时候，您用这个就够了 |
| Retranslate | 无论是否有变更，都会再次翻译所有内容 | 当您修改了引擎的术语表、品牌语气或规则，并希望重新生成现有译文时使用 |
这两个操作都显示在页面顶部：在这里，它们会作用于所有已开启同步的内容；当您勾选行时，它们也会出现在表格上方，此时只作用于这些行。从页头发起重新翻译前，系统会先请您确认，因为每个选中的项目和每种语言都会计费。
运行需要手动发起。在 Zendesk 中编辑文章不会自动开始运行，何时翻译由你决定。
每个连接同一时间只能运行一个任务。如果某个任务正在运行时您又发起了另一个，它会排在后面；如果队列已满，请在某个任务完成后再试。
查看运行任务#
Workflow runs 标签页会列出每次运行：开始时间、触发方式、覆盖了哪些语言、耗时多久以及当前状态。仍在进行中的运行会显示 Stop 按钮。打开某一行可查看各语言的结果。
如果运行结果显示为 Up to date，并不代表失败。它表示自上次运行以来没有任何变更；如果中间没有做任何编辑就连续同步两次，这是正常结果。
译文会保存在哪里#
每条译文都会以对应语言版本的形式，附加在同一篇文章、分区或分类下——这正是 Zendesk 自身的翻译机制。读者只需在帮助中心切换语言即可查看；内容不会被重复创建，也不会被移到别处。
草稿与发布#
在 草稿 模式下，翻译会以未发布草稿的形式进入 Zendesk。在有人于 Zendesk 中审核并发布之前，读者都看不到这些内容。如果您的帮助中心还没有任何翻译，且您正在评估质量，建议从这种模式开始。
在 发布 模式下，翻译写入后会立即上线。
已有已发布的翻译？请选择发布
在草稿模式下，如果 Lingo.dev 为某种已发布的语言写入翻译，该翻译会成为该语言的草稿，读者也就看不到当前线上版本，直到有人重新发布为止。如果您的帮助中心已经在提供翻译，请选择 发布。
稍后您可以在 Settings 标签页中更改模式，也可以同时调整引擎和目标语言。
设置#
设置 标签页会显示该连接正在读取哪个帮助中心，以及有多少内容已启用同步；你也可以在这里修改名称、目标语言、引擎和模式。所有更改都会在操作时自动保存。
如果您选择的某种语言在 Zendesk 中已不再启用，该标签页会提示您。同步会跳过该语言，而下次更改语言列表时，它会被移除。
断开连接#
Settings 标签页底部的 Disconnect 会停止 Lingo.dev 对帮助中心的读取和写入。它会移除此连接、其运行历史记录，以及按文章记录的已翻译状态。已经写入的译文会保留在 Zendesk 中——它们属于您的帮助中心，不属于我们。
重新建立连接
重新建立连接后，会开始记录新的翻译记录。重新连接后的首次同步会保留 Zendesk 中已有的译文，包括此前由 Lingo.dev 写入的译文，并且只翻译缺失的部分。
限制#
| 限制项 | 说明 |
|---|---|
| 内容类型 | 分类、分区和文章。工单、宏、主题和社区帖子不包含在内。 |
| 内容块 | 使用 Zendesk 内容块构建的文章不会被翻译 |
| 触发方式 | 仅支持手动——没有 webhook，文章变更时也不会自动同步 |
| 并发运行任务 | 每个连接一次只能运行一个；后续请求会排队等待 |
| 目标语言 | 必须先在您的 Zendesk 帮助中心中启用，Lingo.dev 才能提供这些语言 |
| 连接 | 一个组织可连接多个帮助中心，且每个帮助中心只能连接一次 |
故障排查#
“连接”页面显示 Zendesk 不在您的方案内。 Zendesk 需使用 Enterprise。请联系我们，我们会帮您处理；与此同时，所有已连接的内容都会继续正常运行。
“连接”页面显示您无法连接此项。 建立连接需要一项您当前角色不具备的权限。组织管理员可以进行连接，或将该权限授予您。
目标语言未出现在列表中。 请先在 Zendesk 的 Knowledge -> Settings -> Language settings 中启用它，然后在 Lingo.dev 中重新打开 Settings 标签页。该列表每次都会从 Zendesk 重新读取。
点击 Allow 后，Lingo.dev 提示您在 Zendesk 中添加一种语言。 这是因为该帮助中心目前只有一种语言，还没有其他可供翻译的目标语言。
同步结果显示为 Up to date。 要么是自上次运行以来没有任何变更，要么是还没有任何内容开启同步。请在 Categories、Sections 和 Articles 标签页中为您希望覆盖的内容开启同步。
翻译未出现在帮助中心中。 请检查连接是否处于草稿模式。草稿虽已存在于 Zendesk 中，但在发布之前对读者不可见。