将您的 Zendesk 帮助中心连接到本地化引擎。选择想要覆盖的分类、分区和文章后，Lingo.dev 会将它们翻译成目标语言，并把译文写回 Zendesk。
支持 Zendesk Guide（帮助中心）内容：分类、分区和文章。
Zendesk 集成按组织启用。如果您没有在 Settings -> Integrations 下看到它，请联系我们，我们会为您开启。
开始前#
您需要准备三样东西：
Zendesk 管理员权限。 连接使用 OAuth，发起授权的账号需要具备管理帮助中心内容的权限。
您在 Zendesk 中启用的目标语言。 Zendesk 只接受帮助中心已启用语言的翻译。请前往 Zendesk 的 Knowledge -> Settings -> Language settings 启用这些语言。
在 Admin Center -> Account -> Appearance -> Localization 中添加的语言属于另一份独立列表，不会启用帮助中心语言。
如果您想准确查看帮助中心支持哪些语言，请以管理员身份登录后打开
https://<subdomain>.zendesk.com/api/v2/help_center/locales.json。该端点中列出的语言，就是您可以在 Lingo.dev 中选择的语言。一个本地化引擎。 您的帮助中心翻译会遵循它的术语表、品牌语气和规则。
语言区域代码必须与 Zendesk 完全一致
Zendesk 使用像 en-us 和 de-de 这样的代码。如果您的帮助中心源语言显示为 en-us，请在 Lingo.dev 中选择 English (United States)，而不是单纯的 English——这是两个不同的语言区域（en-US 和 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 中对应的项目，方便您确认自己选中了什么。
选择分类不会自动选中其中的内容
分类、分区和文章需要分别选择。如果您想翻译整个分类，请同时选择该分类以及其下的分区和文章。
先保存，再同步。 新建连接时，范围默认是空的；同步时读取的是已保存的范围，不是你当前在页面上勾选的内容。如果还没保存就直接同步，这次运行就会显示没有可翻译内容。先点击 Save，再开始翻译。
会翻译哪些内容#
| 项目 | 翻译字段 |
|---|---|
| 分类 | 标题、描述 |
| 分区 | 标题、描述 |
| 文章 | 标题、正文 |
文章正文会按 HTML 进行翻译，因此格式、链接和嵌入媒体在整个往返过程中都能保留下来。
同步与重新翻译#
两个按钮，各司其职：
| 按钮 | 作用 | 适用场景 |
|---|---|---|
| Sync | 只翻译自上次运行以来发生变化的内容 | 适合日常更新。大多数时候，您用这个就够了 |
| Retranslate | 从头重新翻译范围内的全部内容 | 当您修改了引擎的术语表、品牌语气或规则，并希望重新生成现有译文时使用 |
这两个按钮在两个位置都能使用：页面顶部的按钮会覆盖您整个已保存的范围；内容表格上方的按钮则只处理当前选中的行。
运行需要手动发起。在 Zendesk 中编辑文章不会自动开始运行，何时翻译由你决定。
同一时间只能有一个运行任务进行中。任务执行期间，这两个按钮都会被禁用。
查看运行任务#
Runs 标签页会列出每一次运行的状态、触发方式、开始时间和耗时。仍在进行中的任务也可以直接在列表中取消。
打开某次运行即可查看详细信息：当前处于哪个阶段——从 Zendesk 拉取内容、翻译、回写——以及整体进度和各目标语言的进度。这样你可以清楚看到，例如德语已完成，而日语仍在进行中。
如果某次运行最终显示为 nothing to translate，这并不代表失败。这表示范围内的所有内容都已经与译文保持一致；如果你在两次同步之间没有做任何编辑，连续同步两次出现这个结果是正常的。
译文会保存在哪里#
每条译文都会以对应语言版本的形式，附加在同一篇文章、分区或分类下——这正是 Zendesk 自身的翻译机制。读者只需在帮助中心切换语言即可查看；内容不会被重复创建，也不会被移到别处。
译文会署名给谁
在 Zendesk 中，每条译文的作者都是授权该连接的账户，而不是点击 Sync 的那个人。如果你不希望整个帮助中心都显示某位同事的名字，建议使用共享服务账户来建立连接。
草稿与发布#
开启 Save as drafts 后，译文会以未发布草稿的形式进入 Zendesk。在有人于 Zendesk 中审核并发布之前，客户都看不到这些内容。这是更稳妥的默认设置，也建议您在评估翻译质量期间保持开启。
关闭后，译文一写入就会立即发布。
之后您也可以在 Settings -> Integrations -> Zendesk 中修改这一设置，同时调整引擎和目标语言。
断开连接#
断开连接会移除该连接、其运行历史，以及按文章记录的“哪些内容已经翻译过”的信息。已经写入 Zendesk 的译文会保留——它们属于你的帮助中心，不属于我们。
重新连接后将从零开始
由于按文章保存的同步状态已被清除，重新连接后的首次同步会将你整个范围视为全新内容，并将其全部重新翻译——相应也会产生对应成本。只有在你明确想停止时才断开连接，不要把它当作排障手段。
限制#
| 限制项 | 说明 |
|---|---|
| 内容类型 | 分类、分区和文章。工单、宏、主题和社区帖子不包含在内。 |
| 内容块 | 使用 Zendesk 内容块构建的文章不会被翻译 |
| 触发方式 | 仅支持手动——没有 webhook，文章变更时也不会自动同步 |
| 并发运行任务 | 每个连接仅支持一个 |
| 目标语言 | 必须先在 Zendesk 帮助中心中启用，运行任务才能将内容写入这些语言 |
故障排查#
点击 Allow 后连接立即失败。 这通常是因为语言区域设置不匹配：您选择的源语言区域设置在帮助中心中并不存在。打开 https://<subdomain>.zendesk.com/api/v2/help_center/locales.json，记下其中列出的准确代码，然后使用该代码重新连接。
下拉菜单中找不到目标语言。 请先在 Zendesk 的 Knowledge -> Settings -> Language settings 中启用该语言，然后重新打开 Lingo.dev 中的配置。
同步提示没有可翻译内容。 一般有两种情况：要么你保存的范围为空——请在 Content 标签页中选择内容并点击 Save——要么其中所有内容都已经是最新状态。
译文没有出现在帮助中心。 请检查连接是否处于草稿模式。草稿虽然已经写入 Zendesk，但在发布前对客户不可见。
