流施工调用APIstep允许消息传递机器人使用REST API请求从外部系统(如Shopify或Salesforce)获取数据。
在这个配方中,您将创建一个机器人回答,它检索由最终用户提供的位置的天气数据。答案从OpenWeather API。您可以使用本配方中创建的答案流作为起点,构建您自己的api驱动的答案。
任务1:检查您的设置
要完成这个食谱,你需要以下材料:
- 带有亚博已发布的消息机器人的Zendesk帐户。如果你愿意,你可以用a沙盒测试环境在生产环境中使用bot之前对其进行测试。
要在web和移动消息传递通道上设置消息传递机器人,请参见为你的网络和移动渠道使用聊天机器人。要在社交频道上设置消息机器人,请参见使用Flow Builder创建一个社交聊天机器人。有关在沙箱环境中使用消息传递的信息,请参见在沙盒中使用消息传递。
- 的API密钥OpenWeather帐户。这个配方中使用的API可以在OpenWeather的免费计划中获得。
要注册一个免费的OpenWeather帐户,请参阅创建新帐户页面openweathermap.org。登录后,您可以在您的OpenWeather帐户页面。
要激活OpenWeather API密钥,您必须验证您的帐户电子邮件地址。经过验证后,API密钥可能需要两个小时才能激活。有关更多信息,请参阅FAQopenweathermap.org。
任务2:创建API连接
首先,创建一个API连接来存储OpenWeather API密钥。您的消息传递机器人可以使用此连接来验证对OpenWeather API的调用。
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择连接>连接。
- 点击创建连接。
- 选择API密匙身份验证类型。
- 输入openweather_api_key随着连接名。
- 输入x-api-key随着标题名称。
- 输入OpenWeather API密钥作为价值。
- 输入api.openweathermap.org随着允许域。
- 点击保存创建连接。
任务3:创建自定义票证字段
任务4:使用Flow Builder构建答案
本节将引导您在Flow Builder中创建答案、设置其目的以及添加答案的步骤。这包括以下步骤:
步骤1:创建答案
使用Flow Builder为你的聊天机器人创建一个答案。
- 在管理中心,点击渠道在侧边栏中,然后选择机器人和自动化>机器人。
- 将鼠标悬停在您想要使用的机器人上并单击编辑。
- 点击创建的答案。
第二步:设定答案的意图
设定答案的意图和训练短语。这些包括在对话中用来触发答案的短语和单词。
- 在机器人编辑页面的Answers选项卡上,单击创建的答案。
- 输入得到的天气作为答案意图。
- 下培训的短语,输入获取天气预报和获取当前温度。
- 点击下一个。
在Flow Builder中打开答案,您可以在其中构建机器人的响应。
步骤3:添加初始消息步骤
添加一个发送消息步骤向用户询问位置。这是答案流程的第一步。
- 在Flow Builder中,单击添加步骤。
- 下选择步骤中,选择发送消息。
- 在机器人的信息,输入以下文本:
您想查询哪个地点的天气信息?包括国家代码。例如:“澳大利亚墨尔本”或“美国旧金山”
步骤4:向最终用户询问位置
在初始消息之后,添加一个询问细节步骤向最终用户呈现基本表单。的文本框位置票务字段的值。
- 在Flow Builder中,单击添加步骤图标().
- 下选择步骤中,选择询问细节。
- 输入得到位置随着名字。
- 在字段,输入并选择位置票。
步骤5:检索该位置的天气数据
添加一个调用API步骤从OpenWeather API获取该位置的天气数据现时天气资料端点。
- 在Flow Builder中,单击添加步骤。
- 下选择步骤中,选择调用API。
- 输入得到的天气随着名字。
- 下API的细节,输入
https://api.openweathermap.org/data/2.5/weather?units=metric&q=
随着端点URL。 - 使用添加一个变量图标()来附加位置字段变量设置为端点URL价值。
完成的端点URLValue应该是这样的:
- 在身份验证,选择openweather_api连接。
- 要测试API请求,请单击调用API。
- 下测试数据,输入墨尔本,非盟随着位置。
- 点击调用API。
- 使用默认名称保存以下变量:
- 主要>临时
- 天气>第一项>描述
第六步:向终端用户发送天气信息
检索天气数据后,使用发送消息步骤,使用包含天气数据的消息进行响应。
- 在Flow Builder中,单击添加步骤下得到的天气一步的API调用成功分支。
- 下选择步骤中,选择发送消息。
- 在机器人的信息,输入以下文本:
它是{{temp}}°C, {{description}} in
- 使用添加一个变量图标()来附加位置字段变量设置为机器人的信息价值。然后加上句号(.)。
完成的机器人的信息Value应该是这样的:
步骤7:添加失败消息
期间提出的请求调用API步骤可能失败。例如,请求可能包含一个不存在的位置。添加一个发送消息走到API调用失败分支。如果OpenWeather API调用失败,此步骤将返回一条消息。
- 在Flow Builder中,单击添加步骤下得到的天气一步的API调用失败分支。
- 下选择步骤中,选择发送消息。
- 在Bot message中输入如下文本:
我很抱歉。我无法获得天气数据
- 使用添加一个变量图标()来附加位置字段变量设置为机器人的信息价值。然后加上句号(.)。
完成的机器人的信息Value应该是这样的:
步骤8:发布更新后的bot
要实时推送答案,请发布更新后的bot。
- 点击完成在Flow Builder的右上角。
- 在聊天机器人界面,单击发布机器人。
- 点击发布。
任务5:测试您的更改
发布更改后,您可以通过询问“How 's the weather?”来测试新的答案。在与更新后的机器人的对话中。有关测试消息机器人的更多信息,请参见测试最终用户的消息传递体验。
1评论
API是否可以使用经过身份验证的用户的外部ID来基于ID自动检索客户特定的数据?
请登录留下评论。