Zendesk 配置

本页面介绍了如何在创建 Zendesk 数据存储区之前设置身份验证和权限。

启用令牌访问权限

如需允许 Zendesk 对您的 Zendesk 实例进行身份验证并与之互动,您必须启用令牌访问权限。请按以下步骤启用令牌访问权限:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。
  2. 在导航菜单中,展开应用和集成,然后从API中选择API 配置
  3. 选中允许 API 令牌访问权限 复选框。
  4. 点击保存

设置身份验证和权限

如需使用 OAuth 2.0 进行安全集成,您必须在 Zendesk 中注册应用,以获取必要的客户端 ID 和客户端密钥。

创建 OAuth 客户端并获取身份验证凭据

如需在 Zendesk 中创建 OAuth 客户端并获取身份验证凭据,请按以下步骤操作:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。

  2. 点击 Zendesk 产品图标,然后选择 Admin Center

    Zendesk 管理中心界面。
    Zendesk Admin Center
  3. 在导航菜单中,展开应用和集成 ,然后从 API 中选择 OAuth 客户端

  4. 点击添加 OAuth 客户端

  5. 输入以下客户端详细信息:

    • 名称 :为您的应用输入一个描述性名称。
    • 可选:说明 :输入简短说明。
    • 可选:公司 :输入您的公司名称。
    • 可选:徽标 :提供一个徽标,该徽标会显示在权限请求页面上。
    • 唯一标识符(客户端 ID) :为您的客户端提供一个唯一的名称。您可以修改初始建议,但该名称必须是唯一的。
    • 客户端类型 :对于在浏览器或移动设备上运行的应用,请选择公开 ;对于在安全服务器上运行的应用,请选择机密
    • 重定向网址(必需) :输入 https://vertexaisearch.cloud.google.com/oauth-redirect。这是 Zendesk 在授权后重定向到的网址,用于接收授权代码。
  6. 点击保存 以获取客户端密钥。

    • 客户端 ID唯一标识符 字段中的值。
    • 客户端密钥 :系统会显示一个新的密钥 字段。请复制此密钥,并立即将其保存在安全的位置。出于安全考虑,系统只会显示一次完整密钥。如果您丢失了该密钥,则必须重新生成。
    界面中显示生成的客户端密钥。
    生成的客户端凭据
  7. 再次点击保存 以完成更改。

设置权限

如需设置所需权限,请按以下步骤操作:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。
  2. 点击 Zendesk 产品图标,然后选择 Admin Center
  3. 在导航菜单中,展开应用和集成 ,然后从连接 中选择 OAuth 客户端
  4. 点击添加客户端
  5. 输入以下客户端详细信息:

    • 名称:输入描述性名称。此区域无法更改。
    • OAuth 授权类型:选择授权代码
    • 客户端 ID:输入从在 Zendesk 中创建 OAuth 客户端部分获取的客户端 ID。
    • 客户端密钥:输入从在 Zendesk 中创建 OAuth 客户端部分获取的客户端密钥值。
    • 授权网址:授权端点通常采用 https://<var>your-subdomain</var>.zendesk.com/oauth/authorize 格式。将 <var>your-subdomain</var> 替换为您的实际 Zendesk 子网域。
    • 令牌网址:令牌端点通常采用 https://<var>your-subdomain</var>.zendesk.com/oauth/token 格式。将 <var>your-subdomain</var> 替换为您的实际 Zendesk 子网域。
      用于在 Zendesk 管理中心内输入 API 作用域的字段。
      添加授权范围
    • 授权范围:根据您的连接模式,输入以下授权范围(以空格分隔):
    连接模式 范围 用途
    联合搜索 readusers:read 执行跨 Zendesk 数据的搜索所必需的。
    联合搜索和操作 tickets:write 执行搜索、创建、更新和合并工单所必需的。
    hc:write 创建类别和更新帖子所必需的。
  6. 点击保存