Zendesk 软件包中的连接操作 - 使用 Zendesk 软件包中的 连接 操作，可使用 Zendesk 域、账户电子邮件和 API 令牌创建经过身份验证的 Zendesk 会话。

Automation 360

使用 Zendesk 软件包中的连接操作，可使用 Zendesk 域、账户电子邮件和 API 令牌创建经过身份验证的 Zendesk 会话。

在运行其他处理工单、用户或组织的软件包操作之前，请先使用此操作。

先决条件

在使用连接操作之前，您必须首先按照以下步骤配置 Zendesk 应用。
  • 以管理员身份登录 Zendesk 应用。
  • 导航到支持 > 管理中心。
  • 单击左侧菜单上的应用和集成。
  • 启用以下身份验证方法之一：
    • 要在 Zendesk 中启用 API 令牌：
      • 单击 API 令牌。
      • 单击添加 API 令牌。
      • 在描述字段中，输入 API 令牌描述以帮助识别。
      • 单击保存以生成 API 令牌。
      • 单击 API 令牌旁边的复制以复制此值。
    • 要在 Zendesk 中注册 OAuth 客户端：
      • 单击 OAuth 客户端。
      • 单击添加 OAuth 客户端。
      • 输入客户端名称和重定向 URL。
        注： 重定向 URL 是您在创建 OAuth 连接时从 Control Room 复制的回调 URL。
      • 单击保存以生成客户端 ID 和客户端密钥。
      • 复制生成的客户端 ID 和客户端密钥。 在 Control Room 配置 OAuth 连接时，需要这些详细信息。
      注： 在 Zendesk 应用中注册 OAuth 客户端后，请确保在您的 Control Room 中配置 OAuth 连接。 连接操作使用 OAuth 2.0 身份验证来安全地对机器人进行身份验证和授权，从而实现与 Zendesk 的安全交互。 有关更多信息，请参阅 在 Control Room 中配置 OAuth 2.0 连接。

设置

  • Zendesk 域： 输入要连接的 Zendesk 实例域名。 例如，yourcompany.zendesk.com。
  • 身份验证类型： 选择以下身份验证方法之一。
    • API 令牌
      • 电子邮件： 单击以下选项卡之一，输入用于 API 身份验证的 Zendesk 账户电子邮件：
        • 凭据： 单击选择按钮，以选择凭据保管库中包含有关 Zendesk 账户电子邮件的信息的值。 默认情况下，此选项卡被选中。
        • 变量： 使用包含有关 Zendesk 账户电子邮件信息的用户定义变量。
        • 不安全字符串： 输入 Zendesk 账户电子邮件。
      • API 令牌： 单击以下选项卡之一以输入用于安全身份验证的 Zendesk API 令牌。
        • 凭据： 单击选择按钮，以选择凭据保管库中包含有关 Zendesk API 令牌的信息的值。 默认情况下，此选项卡被选中。
        • 变量： 使用包含 Zendesk API 令牌信息的用户定义变量。
        • 不安全字符串： 输入 Zendesk API 令牌值。
    • OAuth 2.0
      • OAuth 连接： 单击选择以选择可用的 OAuth 连接。
      • 访问令牌： 单击以下选项卡之一以输入 OAuth 2.0 访问令牌。
        • 凭据： 单击选择按钮，以在包含有关 OAuth 2.0 访问令牌信息的凭据保管库中选择一个值。 默认情况下，此选项卡被选中。
        • 变量： 使用包含有关 OAuth 2.0 访问令牌信息的用户定义变量。
        • 不安全字符串： 输入 OAuth 2.0 访问令牌值。
  • Zendesk 会话： 使用以下选项之一将 Zendesk 会话分配给变量：
    • 本地会话： 输入一个只能在当前自动化中使用的会话名称。 默认会话值为 Default。
    • 全局会话： 输入一个可在多个自动化（例如父和子）中使用的会话名称。
      注： 父和子机器人应具有相同的软件包版本。
    • 变量： 指定或创建一个存储该值的会话变量。 请参阅 创建变量。
  • 注释（可选）： 为自动化步骤添加注释，以记录上下文、假设、引用或实现细节。 注释支持 Markdown 格式，仅用于文档记录用途。 它们不会影响自动化逻辑或执行。
    • 单击添加注释以添加上下文信息、假设、引用或自动化步骤的实施说明。 注释编辑器打开。
      注释编辑器提供以下选项卡：
      选项卡 描述
      来源 使用 Markdown 语法输入或编辑注释。 这是您创建或修改注释的可编辑视图。

      最大长度： 1,000 个字符。 仅用作内部参考，不影响自动化逻辑。
      预览 在保存之前显示 Markdown 内容的渲染预览。

      只读。 随着注释的编辑自动更新。
      双重 并排显示源和预览窗格，使您能够同时编辑和查看格式化内容。
    • 单击更新以保存注释并将其与当前自动化步骤关联。 更新选项在完成更改后才会启用。
    • 单击关闭以关闭注释编辑器而不保存任何更改。

此操作返回一个已认证的 Zendesk 会话，该会话由指定的会话名称引用，并可供自动化中的后续 Zendesk 操作使用。