工作流程生成器的“进行 API 调用” 步骤允许消息传送智能机器人使用 REST API 请求从外部系统(例如 Shopify 或 Salesforce)抓取数据。
在这个秘籍中,您将创建一个智能机器人答案,用于检索终端用户提供的位置的天气数据。答案从 OpenWeather API获取数据。您可以使用此范例中创建的答案流程作为起点,建立您自己的由 API 提供技术支持的答案。
任务 1:正在检查您的设置
要完成此配方,您将需要以下内容:
- 带有已发布消息传送智能机器人的 Zendesk 帐户。如果需要,您可以使用 沙盒测试环境 来测试智能机器人,然后再将其用于生产环境。
要在网络和移动消息传送渠道中设置消息传送智能机器人,请参阅 将消息传送智能机器人用于您的网络和移动渠道。要在社交渠道中设置消息传送智能机器人,请参阅 使用工作流程生成器创建社交消息传送智能机器人。有关在沙盒环境中使用消息传送的信息,请参阅在沙盒环境中 使用消息传送。
-
OpenWeather 帐户的 API 密钥。此配方中使用的 API 在 OpenWeather 的免费服务模式中可用。
要注册免费的 OpenWeather 帐户,请参阅 openweathermap.org上的“创建新帐户”页面。登录后,您可以在您的 OpenWeather 帐户页面上获得一个 API 密钥。
要激活 OpenWeather API 密钥,您必须验证您的帐户电邮地址。验证后,API 密钥可能需要最多两小时才能激活。如需更多信息,请 查阅 openweathermap.org上的常见问题。
任务 2:创建 API 连接
首先,创建一个 API 连接以存储您的 OpenWeather API 密钥。您的消息传送智能机器人可使用此连接对 OpenWeather API 调用进行身份验证。
- 在 管理中心中,单击 应用和整合 ,然后选择“ 连接”>“连接”。
- 单击 创建连接。
- 选择 API 密钥 身份验证类型。
- 输入 openweather_api_key 作为 连接名称。
- 输入 x-api-key 作为 标头名称。
- 输入您的 OpenWeather API 密钥作为 值。
- 输入 api.openweathermap.org 作为 允许的域名。
- 单击“ 保存 ”以创建连接。
任务 3:创建自定义工单字段
任务 4:使用工作流程生成器建立答案
本部分将指导您在工作流程生成器中创建答案、设置其意向,以及为答案添加步骤。这涉及以下步骤:
第 1 步:创建答案
使用工作流程生成器为您的消息传送智能机器人创建答案。
- 在 管理中心中,单击 ( 渠道 ),然后选择“ 智能机器人和自行程序 > 智能机器人”。
- 将鼠标悬停在您要使用的智能机器人上,然后单击“ 编辑”。
- 单击 创建答案。
第 2 步:设置答案的意向
设置答案的意图和培训短语。其中包括用于在对话中触发答案的短语和词语。
- 在智能机器人编辑页面的“答案”标签上,单击“ 创建答案”。
- 输入 Get weather 作为答案的 Intent。
- 在“ 培训短语”下,输入 “获取天气预报 ”和 “获取当前温度”。
- 单击下一步。
答案将在工作流程生成器中打开,您可以在其中构建智能机器人的响应。
第 3 步:添加初始消息步骤
添加“ 发送消息 ”步骤以询问用户位置。这是答案工作流程的第一步。
- 在工作流程生成器中,单击 添加步骤。
- 在 “选择步骤”下,选择“ 发送消息”。
- 在 Bot message中,输入以下文本:
What location would you like to get the weather for? Include the country code. For example: "Melbourne, AU" or "San Francisco, US"
第 4 步:询问终端用户位置
在初始消息后,添加“ 询问详情” 步骤,以便向终端用户显示一张基本表格。该表格包括 位置 工单字段值的文本框。
- 在工作流程生成器中,单击 添加步骤 图标 ()。
- 在 “选择步骤”下,选择“ 询问详情”。
- 输入 Get location 作为 Name。
- 在 字段中,输入并选择 位置 工单字段。
第 5 步:正在检索该位置的天气数据
添加进行 API 调用 步骤,以便从 OpenWeather API 的 当前天气数据 端点获取该位置的天气数据。
- 在工作流程生成器中,单击 添加步骤。
- 在 选择步骤下,选择进行 API 调用。
- 输入 Get weather 作为 Name。
- 在 API 详情下, 输入
https://api.openweathermap.org/data/2.5/weather?units=metric&q=
作为 端点 URL。 - 使用 添加变量 图标 () 以将 位置 字段变量附加到 端点 URL 值。
已完成的 端点 URL 值应如下所示:
- 在 身份验证中,选择 openweather_api 连接。
- 要测试 API 请求,单击进行 API 调用。
- 在“ 测试数据”下,输入“Melbourne, AU”作为“ 位置”。
- 单击进行 API 调用。
- 使用默认名称保存以下变量:
- 主 > 临时
- 天气 > 项目 1 > 描述
第 6 步:发送天气消息给终端用户
检索天气数据后,使用“ 发送消息 ”步骤回复一条包含天气数据的消息。
- 在工作流程生成器中,单击 获取天气 步骤的 API 调用成功 分支下的 添加步骤 。
- 在 “选择步骤”下,选择“ 发送消息”。
- 在 Bot message中,输入以下文本:
It's {{temp}}° C with {{description}} in
- 使用 添加变量 图标 () 以将 位置 字段变量附加到 智能机器人消息值。然后添加一个句点 (.)。
已完成的 Bot 消息值应如下所示:
第 7 步:添加失败消息
在进行 API 调用 步骤中发出的请求可能会失败。例如,请求可能包含一个不存在的位置。添加一个 发送消息 步骤到 API 调用失败 分支。如果 OpenWeather API 调用失败,此步骤将返回一条消息。
- 在工作流程生成器中,单击“ 获取天气” 步骤的 API 调用失败 分支下的“ 添加步骤 ”。
- 在 选择 步骤下,选择 发送消息。
- 在 Bot 消息中,输入以下文本:
I'm sorry. I wasn't able to get weather data for
- 使用 添加变量 图标 () 以将 位置 字段变量附加到 智能机器人消息值。然后添加一个句点 (.)。
已完成的 Bot 消息值应如下所示:
第 8 步:发布更新后的智能机器人
要实时推送答案,发布更新后的智能机器人。
- 单击“工作流程生成器”右上角的 “完成”。
- 在智能机器人页面上,单击 发布智能机器人。
- 单击发布。
任务 5:测试您的更改
发布更改后,您可以通过询问“天气怎么样?”来测试新的答案。在与已更新智能机器人的对话中。有关测试消息传送智能机器人的更多信息,请参阅 测试终端用户的消息传送体验。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。