从 Zendesk 导入
使用 Zendesk 导入工具,将 Zendesk 社区论坛(Zendesk Gather)中的帖子、评论、赞同票和关注者迁移到 UserJot 看板。
此导入工具用于迁移 Zendesk 社区论坛,不适用于 Zendesk Support 工单或 Help Center 知识库文章。要迁移 Zendesk Help Center 文章,请使用 导入现有帮助中心。
所有套餐(包括免费套餐)均可使用,适用于工作区管理员和所有者。
在 Zendesk 中创建机密 OAuth 客户端
UserJot 通过 OAuth client_credentials 授权方式连接 Zendesk(无需重定向 URI)。
打开 Zendesk 管理中心 → 应用和集成 → API → OAuth 客户端。
创建一个机密 OAuth 客户端,并授予它
hc:read和users:read范围。这些范围允许 UserJot 读取社区主题、帖子、评论、投票、订阅和成员邮箱,而不会访问 Support 工单。复制客户端标识符和客户端密钥。
UserJot 不会永久存储您的 Zendesk 凭据。凭据仅在后台导入任务运行期间加密保存,并会在任务结束后立即删除。
运行导入
在 UserJot 中,打开 设置 → 数据 & 导入,然后点击 从 Zendesk 导入。
输入您的 Zendesk 子域名(即
.zendesk.com子域名,例如acme.zendesk.com;不接受support.acme.com这类自定义映射域名)、客户端标识符和客户端密钥,然后点击继续。在选择主题页面,将每个 Zendesk 主题映射到一个 UserJot 看板,或将主题设置为不导入。名称与现有 UserJot 看板匹配(不区分大小写)的主题会自动预选。至少映射一个主题,然后点击继续。
查看准备导入页面(通常需要约 15 分钟),然后点击开始导入。
UserJot 会在后台运行导入,并在完成后向发起导入的管理员发送邮件(主题:Your Zendesk import is done)。重新运行导入是安全的,因为系统会根据 Zendesk ID 对之前导入的帖子、评论、投票和关注者去重。
导入和跳过的内容
Zendesk 数据 | 在 UserJot 中的处理方式 |
|---|---|
帖子 | 导入为公开请求,包含标题、正文(HTML 转换为纯文本,最多 20,000 个字符)、原始创建日期、状态和赞同票总数。 |
状态 |
|
评论 | 以扁平列表形式导入到对应帖子中(最多 10,000 个字符),并保留创建日期和赞同票数。没有文本或图片的空评论会被跳过。 |
图片 | 外部 HTTPS 图片会被复制并附加。Zendesk 托管的 |
投票 | 会导入赞同票,跳过反对票。对于有邮箱或外部 ID 的用户,会创建单独的投票者记录(已删除的 Zendesk 投票者仍计入帖子的总票数)。 |
关注者 | 如果用户有邮箱或外部 ID,则会作为请求订阅者导入,并保留其原始关注日期。 |
不导入的内容 | Support 工单、Help Center 文章、内容标签、反对票、未映射的主题和更新日志。 |
故障排除
“找不到 Zendesk 账户。”请输入
.zendesk.com子域名,而不是自定义域名。“Zendesk 不接受该标识符和密钥。”请确认 Zendesk 中的 OAuth 客户端设置为机密,而不是公开。
“此 OAuth 客户端无法读取论坛。”请确认客户端已启用
hc:read和users:read两个范围。速率限制。每小时最多可加载主题 10 次;每小时最多可启动导入 3 次,每天最多 5 次。