从 Zendesk 导入

Shayan Taslim更新

使用 Zendesk 导入工具,将 Zendesk 社区论坛(Zendesk Gather)中的帖子、评论、赞同票和关注者迁移到 UserJot 看板。

Note

此导入工具用于迁移 Zendesk 社区论坛,不适用于 Zendesk Support 工单或 Help Center 知识库文章。要迁移 Zendesk Help Center 文章,请使用 导入现有帮助中心。

所有套餐(包括免费套餐)均可使用,适用于工作区管理员和所有者。

在 Zendesk 中创建机密 OAuth 客户端

UserJot 通过 OAuth client_credentials 授权方式连接 Zendesk(无需重定向 URI)。

  1. 打开 Zendesk 管理中心 → 应用和集成 → API → OAuth 客户端。

  2. 创建一个机密 OAuth 客户端,并授予它 hc:read 和 users:read 范围。这些范围允许 UserJot 读取社区主题、帖子、评论、投票、订阅和成员邮箱,而不会访问 Support 工单。

  3. 复制客户端标识符和客户端密钥。

UserJot 不会永久存储您的 Zendesk 凭据。凭据仅在后台导入任务运行期间加密保存,并会在任务结束后立即删除。

运行导入

  1. 在 UserJot 中,打开 设置 → 数据 & 导入,然后点击 从 Zendesk 导入。

  2. 输入您的 Zendesk 子域名(即 .zendesk.com 子域名,例如 acme.zendesk.com;不接受 support.acme.com 这类自定义映射域名)、客户端标识符和客户端密钥,然后点击继续。

  3. 在选择主题页面,将每个 Zendesk 主题映射到一个 UserJot 看板,或将主题设置为不导入。名称与现有 UserJot 看板匹配(不区分大小写)的主题会自动预选。至少映射一个主题,然后点击继续。

  4. 查看准备导入页面(通常需要约 15 分钟),然后点击开始导入。

UserJot 会在后台运行导入,并在完成后向发起导入的管理员发送邮件(主题:Your Zendesk import is done)。重新运行导入是安全的,因为系统会根据 Zendesk ID 对之前导入的帖子、评论、投票和关注者去重。

导入和跳过的内容

Zendesk 数据

在 UserJot 中的处理方式

帖子

导入为公开请求,包含标题、正文(HTML 转换为纯文本,最多 20,000 个字符)、原始创建日期、状态和赞同票总数。

状态

none → 待处理,planned → 计划中,completed → 已完成,not_planned 和 answered → 已关闭。

评论

以扁平列表形式导入到对应帖子中(最多 10,000 个字符),并保留创建日期和赞同票数。没有文本或图片的空评论会被跳过。

图片

外部 HTTPS 图片会被复制并附加。Zendesk 托管的 /hc/ 图片会作为链接保留在正文中,因为 Zendesk 会阻止服务器端下载。

投票

会导入赞同票,跳过反对票。对于有邮箱或外部 ID 的用户,会创建单独的投票者记录(已删除的 Zendesk 投票者仍计入帖子的总票数)。

关注者

如果用户有邮箱或外部 ID,则会作为请求订阅者导入,并保留其原始关注日期。

不导入的内容

Support 工单、Help Center 文章、内容标签、反对票、未映射的主题和更新日志。

故障排除

  • “找不到 Zendesk 账户。”请输入 .zendesk.com 子域名,而不是自定义域名。

  • “Zendesk 不接受该标识符和密钥。”请确认 Zendesk 中的 OAuth 客户端设置为机密,而不是公开。

  • “此 OAuth 客户端无法读取论坛。”请确认客户端已启用 hc:read 和 users:read 两个范围。

  • 速率限制。每小时最多可加载主题 10 次;每小时最多可启动导入 3 次,每天最多 5 次。

后续步骤

这是否解答了您的问题?