Zendesk 帮助中心
为帮助中心的类别、分区和文章翻译并更新现有语言版本,手动掌控同步与发布。
无需将内容移出 Zendesk,即可翻译帮助中心内容。Lingo.dev 连接会按帮助中心的默认语言读取所选类别、分区和文章,通过本地化引擎翻译,再将目标语言版本写回原项目。
在 Studio 2.5 导航中,请打开 Studio 2.5 → 集成,而非 设置 → 集成。现有的连接和配置链接仍可正常使用。
所有运行都需手动启动。文章更改后,请对需要更新的内容启动同步。首次写入前,请选择将译文保存为草稿还是直接发布:如果将已发布的目标语言版本写为草稿,读者可能暂时无法访问该版本,直到它重新发布。
准备访问权限并配置帮助中心语言 #
Zendesk 帮助中心集成需要 Enterprise 套餐。当前可用情况请参阅定价。如果组织尚未获得相应的套餐访问权限,设置 → 集成中 Zendesk 旁会显示当前套餐不支持。
请使用有权访问帮助中心内容的 Zendesk 管理员账户。用于向 Radar 收集活动的文章发布 webhook 必须由管理员注册。写入操作会记在授权账户名下;如果团队需要统一的操作归属,请使用合适的服务账户。在 Lingo.dev 中,您还需要组织的相应权限和连接使用资格,以及所选本地化引擎的访问权限。
请在帮助中心的语言设置中启用目标语言。Zendesk 的账户级本地化列表与此独立,不能用于启用帮助中心翻译。获得适当授权后,可通过只读端点 https://<subdomain>.zendesk.com/api/v2/help_center/locales.json 查看帮助中心的语言区域配置。
Lingo.dev 每次运行都会读取帮助中心的默认语言,并将其作为源语言。连接表单不支持选择其他源语言。
建立连接并翻译第一篇文章 #
- 打开设置 → 集成,选择 Zendesk 对应的连接。输入名称和帮助中心子域名。如果地址为
acme.zendesk.com,请输入acme。 - 继续前往 Zendesk 并授权访问。授权成功后,连接才会创建。
- 在 Studio 的已连接列表中选择帮助中心,然后选择配置。
- 选择本地化引擎和回写模式,然后选择继续。首次运行时,请从帮助中心已启用的语言中选择一种目标语言。源语言不在可选范围内;如果没有其他可用语言,请先在 Zendesk 中启用一种。
- 打开文章,为一篇源文本稳定的文章启用同步开关。等待设置保存后,勾选该文章所在行的复选框,再选择将同步加入队列。
- 检查工作流结果和 Zendesk 中实际的目标文章,核对标题、正文、链接、语言区域,以及草稿或已发布状态。如果文章应当已发布,还需打开面向读者的 URL 进行检查。
首次同步会沿用已有的完整译文,不会覆盖文本或更改草稿状态,只会翻译缺失的内容。如果您确实希望替换现有译文,请使用重新翻译。
选全需要翻译的内容区域 #
类别、分区和文章各有独立的表格,以及会持续保存状态的同步开关。启用某个类别,只会翻译该类别的名称和描述,不会同时启用其下的分区或文章。要翻译帮助中心的完整内容区域,请分别选择这些项目。
| 项目 | 翻译字段 |
|---|---|
| 类别 | 名称/标题和描述 |
| 分区 | 名称/标题和描述 |
| 文章 | 标题和正文 |
行复选框可限定单次将同步加入队列或将重新翻译加入队列操作的范围,但仅对同步开关已启用的项目生效。勾选某一行不会启用该项目的同步开关。表头操作会覆盖此连接中已启用的范围。启动前,请确认操作将处理哪些选定项目。
文章正文会经过 HTML 处理,以重建格式、链接和嵌入式媒体。回写时,系统可将识别出的帮助中心链接调整为目标语言区域。请检查结果中的这些链接,并确认链接指向的译文页面是否存在。外部链接和站点专有导航仍需单独检查。
此连接不翻译工单、宏、主题、社区帖子,也不翻译基于 Zendesk 内容块的文章。它用于本地化帮助中心内容,而非支持工单的分类处理。
更新更改后的内容或替换译文 #
同步会将当前源内容与已记录的状态和现有译文进行比较。可用它处理日常源内容更新、补全缺失内容,以及完成上次运行中未完成的工作。
即使源文本没有更改,重新翻译也会为所选项目和语言重新生成译文,并可能替换已接受的人工修改。覆盖较大范围的表头操作会要求确认;对选定行执行操作时,您仍需选择要替换的范围。
每个连接同一时间只能有一次运行。后续请求会进入队列;队列已满时,需等待空位。工作流运行中可查看结果;停止会取消仍可停止的工作。“已是最新”表示所选范围内没有需要处理的更改,并不代表对译文质量进行了新的评估。
确认读者能看到的内容 #
发布模式会写入已发布的译文。草稿模式会写入未发布的语言区域版本,供您在 Zendesk 中审核。使用草稿模式更新已发布的语言版本时,新草稿可能使原先的已发布版本暂时不可见,直到有人重新发布。开始更新前,请确认这种中断是否符合此次发布安排。
写入后,请打开预期语言的目标 URL,将实际标题和正文与源内容修订版本对照,逐一访问链接,并检查是否残留源语言片段。翻译运行完成只是发布流程的一环;是否接受和发布译文,仍由编辑决定。
处理源内容变更和部分完成的结果 #
回写时会重新读取源项目。如果源项目在任务规划后发生更改或被移除,Lingo.dev 会跳过对应的目标内容。源内容准备就绪后,请再次手动同步,使记录与新状态保持一致。
某个语言区域处理失败,不会撤销其他语言区域已成功写入的内容。请检查已写入、已跳过和失败的项目,再对受影响的范围重试。强制重新处理整个帮助中心,可能会替换已接受的文本,却无法解决最初的问题。
如果未生成预期输出,请检查项目选择、帮助中心已启用的语言、本地化引擎访问权限、回写模式、内容块排除情况,以及源内容是否发生更改。沿用现有完整译文时,本就不会生成新文本。如果某种目标语言已在 Zendesk 中停用,运行会跳过该语言;请刷新连接的目标语言选择。
如果 Zendesk 暂时不可用,请在服务恢复后重试。如需恢复授权,请对现有连接使用重新连接;断开连接后再创建新连接会丢失同步状态。
断开连接或重新连接 #
在 Studio 中,打开帮助中心的设置选项卡,即可更改目标语言、本地化引擎和模式。在设置 → 集成中可重命名账户或重新连接账户。使用重新连接可恢复现有连接的授权。
断开连接会停止读取和写入,并移除本地连接、运行历史及各项目的同步记录,但会保留 Zendesk 中已有的译文。之后创建新连接会建立新的基准:首次同步会保留已有的完整译文,并补全缺失内容。需要终止访问时,请另行撤销提供方授权。如需恢复此前发布的文本,请直接在 Zendesk 中操作。
在 Radar 中收集活动 #
此连接也会向 Radar 提供帮助中心活动。收集译文以进行测量介绍了事件设置方法,以及如何在运行历史测量前导入提供方历史记录。
如果手动翻译正常,却未收集到新的文章活动,请检查连接的 webhook 注册和投递情况。非管理员账户即使无法注册 webhook,也可能成功授权。请在设置 → 集成中,对现有 Zendesk 连接使用重新连接,并以管理员身份授权。发布一篇测试文章,在 Radar 中确认其事件后,再依赖自动收集。