整合生成器可用于使用人工智能专员从对话创建 Zendesk 工单。这篇文章将详细说明如何进行此操作。
如需了解更多信息，请单击 此处找到相关的 Zendesk 开发者文档。
本文章包含以下主题：
前提条件
要开始设置，您需要：
- 您的 Zendesk 子域名
- 您的授权密钥（有关更多信息，请参阅以下部分）
创建整合
- 在 API 整合中创建一个新整合。
- 为其命名，例如创建 Zendesk 工单，并添加描述。
环境和端点
要访问 Zendesk 工单 API，您需要向以下端点发出 POST 请求：http://[您的子域名].zendesk.com/api/v2/tickets
通过 Zendesk 子域名，您可以构建 Zendesk 实例的端点 URL。然后会在整合生成器的“环境”部分使用此 URL 来发出 POST 请求。
- 导航到整合生成器的环境部分。
- 对于方法类型，选择 POST。
- 为工单 API 添加您自行构造的 URL 端点。
Auth
要访问 Zendesk API，您需要在管理中心创建一个密钥。
- 在管理中心，前往应用和整合，选择 API >Zendesk API。
您将看到以下屏幕，可以在其中添加新密钥。
- 单击 添加 API 密钥。
- 为其命名，例如 创建工单。
- 将该密钥复制到安全的地方，因为您需要用它来在整合生成器中设置整合。
准备就绪后，您可以使用整合生成器将其添加到整合中。
- 在 环境 部分，单击 授权。
- 在 授权 类型中，选择 基本身份验证。
- 输入管理员电邮地址，末尾添加 /token。
- 粘贴您创建的密钥作为密码。
- 请务必在标头中手动构建授权密钥，以将其包含在请求中。
请求参数
您将在这里将数据从人工智能专员对话传递到整合以创建工单。
对于实时整合，您需要在对话中设置参数，然后在整合生成器中将这些参数与您的请求参数进行匹配。出于测试目的，您可以创建带有测试值的请求参数，因为我们不使用来自对话的实时数据。
确保您的请求参数名称与您在对话中设置的（通过操作）相匹配。有关更多信息，请参阅 在对话生成器中进行构建 。
正文
正文是您将发送对话中的所有数据的地方，以通过工单 API 创建工单。此正文的结构必须匹配工单 API 的架构。
要查看架构以及工单可创建哪些字段，请 在此处参阅 Zendesk 开发者文档。
以下是我们之前创建的带有请求参数的请求正文示例。
单击 测试生产测试整合。
然后您应该可以在 Zendesk 面板中看到新创建的工单。
在线交谈记录副本格式：标准与 HTML 正文
工单 API 支持使用 正文 或 html_body 进行评论。当使用 正文时，多个连续的空格将折叠到一个空格中，多个换行符（“/n”）折叠到一个新行中。而使用 html_body时，您可以使用标准 HTML 语法设置评论格式。
有关更多信息，请参阅 此处的Zendesk 开发者文档。
要在已创建工单中使用其中之一，您需要在请求正文的“评论”中设置要使用的结构。
注意：使用任一选项，而不是像下面的演示一样同时使用这两个选项。
如果您从对话发送在线交谈记录副本，建议您使用重新格式化值工具使记录副本更具可读性。您可以在每条消息的开头添加换行符，而不仅仅是在一大段文本中。
如果您要发送 HTML 正文，可以使用重新格式化值工具添加 HTML。
有关如何使用重新格式化值工具的说明，请参阅 为高级人工智能专员重新格式化请求参数中的值。
在下面的屏幕截图中，我们重新格式化了在线交谈记录副本，使其 URL 可点击，并添加了换行符：<br>更新。
标准字段与自定义字段值
除了可创建并在请求正文中发送的标准字段外，您还可以创建自定义字段值。有关如何在正文中设置自定义字段的说明，请参阅 此处的Zendesk 开发者文档。
在对话生成器中构建
- 添加 API 节点并选择您在上面创建的 Zendesk 工单整合。
- 在 API 节点上创建一个 操作 ，从对话中设置参数。
如下所示：
- 为成功和回退场景添加消息。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。