View a markdown version of this page

Zendesk 套件集成 - Amazon Quick
先决条件验证你的 Zendesk 账户配置 Zendesk 账户在 Amazon Quick 中设置集成可用操作问题排查

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Zendesk 套件集成

使用自然语言直接从 Amazon Quick 管理您的 Zendesk 支持工单。使用 Zendesk Suite 操作连接器，您无需离开 Amazon Quick 即可创建、更新、搜索和列出支持请求。

Zendesk Suite 可作为内置连接器在 Amazon Quick 中使用。要设置此集成，请完成以下两个步骤。首先，为你的 Zendesk 账户准备好所需的访问权限。然后，在 Amazon Quick 中创建连接器并使用您的 Zendesk 凭据进行身份验证。

此连接器支持 OAuth 用户身份验证和 API 密钥服务身份验证。有关 Amazon Quick 支持的身份验证方法的信息，请参阅身份验证方法。

先决条件

在设置集成之前，请确认您拥有以下资源和访问权限。

  • 具有管理员角色的活跃 Zendesk 账户。

  • 访问您的 Zendesk 实例中的工单和支持数据的权限。

  • 符合中所述要求的订阅在控制台中设置集成。

验证你的 Zendesk 账户

在配置 Amazon Quick 之前，请验证您的 Zendesk 账户是否满足以下要求。

配置 Zendesk 账户

Amazon Quick 中的自定义 OAuth 应用程序身份验证方法需要在 Zendesk 中配置 OAuth 客户端。API 密钥身份验证方法需要 API 令牌。

配置 OAuth 客户端

  1. 在你的 Zendesk 实例中，依次导航到 “管理中心”、“应用程序和集成”，然后导航到 API 下的 OAuth 客户端。

  2. 选择 “添加 OAuth 客户端”。

  3. 在表单中填写以下字段：

    • 名称-输入您的应用程序的名称。

    • 描述-输入简短的描述。

    • 标识符-输入 OAuth 客户端的唯一标识符。

    • 重定向网址-输入https://region.quicksight.aws.amazon.com/sn/oauthcallback。例如region，用您 AWS 所在的地区替换us-east-1。

  4. 选择保存。Zendesk 会生成一个客户机密钥。

    重要

    立即记录客户机密。离开此页面后，您将无法对其进行检索。

  5. 捕获密钥后，再次选择保存以创建 OAuth 客户端。

当您在 Amazon Quick 中使用自定义 OAuth 应用程序身份验证方法配置操作连接器时，标识符和密钥将用作客户端 ID 和客户端密钥。

有关更多信息，请参阅 Zendesk 网站上的对应用程序使用 OAuth 身份验证。

配置 API 令牌

  1. 依次导航到 “管理中心”、“应用程序和集成” 和 “API 令牌”。

  2. 选择添加 API 令牌。

  3. 在描述中，输入 API 令牌的简短描述。

  4. 选择保存。Zendesk 会生成一个 API 令牌。

    重要

    立即记录 API 令牌。离开此页面后，您将无法对其进行检索。

如果您在 Amazon Quick 中选择 API 密钥身份验证方法，请使用此 API 令牌作为 API 密钥值。

有关更多信息，请参阅 Zendesk 网站上的 “管理 Zendesk API 的 API 令牌访问权限”。

在 Amazon Quick 中设置集成

验证您的 Zendesk 账户访问权限后，在 Amazon Quick 中创建连接器。

  1. 在 Amazon Quick 控制台中，选择 “连接器”。

  2. 选择 “为你的团队创建” 选项卡。

  3. 从可用选项中选择 Zendesk 套件。

  4. 在 Zendesk 套件对话框中，输入以下字段：

    • 名称 — Zendesk 连接器的描述性名称。

    • 描述（可选）-选择 + 添加描述以添加有关如何使用此连接器的注释。

    • 连接类型-选择公共网络。

  5. 选择您的身份验证方法并配置连接器设置：

    • 自定义 OAuth 应用程序-为您的 Zendesk 实例输入以下字段：

      • 基本网址

      • 客户端 ID

      • 客户机密钥

      • 代币网址

      • 授权网址

      • 重定向网址

    • API 密钥-输入以下字段：

      • 基本网址

      • API 密钥（Zendesk API 令牌）

      • 与你的 Zendesk 账户关联的@@ 电子邮件

  6. 选择下一步。

  7. 查看 Zendesk Suite 的操作并选择 “下一步”。

  8. 指定谁可以访问连接器：

    • 要与团队共享，请输入团队名称或群组电子邮件。

    • 要将其保密，请将该字段留空。

    • 要与所有用户共享，请切换组织中的所有人。

  9. 选择发布。

连接器出现在 “可用” 面板中，状态为 “已连接”。

可用操作

设置连接器后，您可以使用以下票证管理操作。

Zendesk 套件的可用操作
处理建议 说明
创建门票 创建新票证
列出搜索结果 搜索门票
列出门票 查看所有门票
演出门票 查看门票详情
更新票证 编辑门票详情
注意

您可以使用的操作取决于您的 Zendesk 账户中配置的权限。

问题排查

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • Sign-in 失败 — 验证您的 Zendesk 账户是否处于活动状态，并且可以登录 Zendesk 网站上的 Zendesk 登录页面。如果您的组织使用单点登录 (SSO)，请确认您的身份提供商配置正确。

  • 访问被拒绝-确认您的 Zendesk 用户具有管理员角色，有权访问工单和支持数据。对于 API 密钥连接，请验证 API 令牌是否有效以及关联的电子邮件地址是否正确。