Zendesk用户身份信息认证失败，应如何清除冲突用户记录？

当用户身份认证失败时，系统会弹出以下提示弹窗，表示用户当前身份信息与 Zendesk 中的记录发生冲突：

• 管理员视角：

• 员工视角：

• 客户视角：

此时请联系品牌管理员，由其登录 Zendesk 后台，联系 Zendesk 支持团队获取冲突 external_ID，并使用 API 删除旧的 AppUserID（即已绑定该 external_ID 的用户记录）

Zendesk 管理员操作步骤

1. 登录 Zendesk 后台，点击右上角头像

2. 在下拉菜单中选择 「获得帮助」

3. 页面左下角会弹出与 Zendesk 官方团队的聊天窗口

4. 在聊天框中点击「新对话」说明问题，例如：“我遇到了 JWT 身份验证冲突错误，请帮我查询该邮箱的 external_ID”，并附上：

   • 冲突用户的邮箱地址

   • Zendesk 官方帮助链接：如何解决 409 与 JWT 身份验证冲突错误？

5. 请求 Zendesk 告知该邮箱当前绑定的 external_ID

清除冲突用户记录（API 操作）

获取到 external_ID 后，您需要删除旧的 AppUserID 与该 external_ID 的绑定关系。操作步骤如下：

1. API 请求方式

• 请求地址（DELETE 方法）：

  https://api.smooch.io/v2/apps/{appId}/users/{userIdOrExternalId}

• 替换参数：

  • {appId}：在 [应用中心 - Zendesk客户工具 - 插件配置]页获取，对应[应用ID]

    

  • {userIdOrExternalId}：Zendesk 提供的 external_ID

2. 身份验证方式

• 类型：Basic Auth

• 用户名：API_KEY_ID（在 [应用中心 - Zendesk客户工具 - 插件配置]页获取，对应[密匙ID]）

• 密码：API_KEY_SECRET（在 [应用中心 - Zendesk客户工具 - 插件配置]页获取，对应[密匙密码]）

3. 请求 URL（根据区域选择）：

• 全球区域（默认）：
  https://api.smooch.io/v2/apps/{appId}/users/{userIdOrExternalId}

• 🇪🇺 欧洲区域：
  https://api.eu-1.smooch.io/v2/apps/{appId}/users/{userIdOrExternalId}

操作成功后

API 请求成功（返回 200 OK）后，冲突用户的绑定关系将被清除。用户重新打开 Shipber 客服插件，即可正常加载对话。

如遇配置问题，请联系技术支持协助处理。