步骤3:配置连接器
基于应用模板创建聊天机器人应用后,系统预置了连接器实例,您需要修改相应参数,用于AppCube该应用与5G消息云服务平台对接,实现上传、下载、删除多媒体内容文件以及下发消息功能。
前提条件
基于应用模板快速创建应用后,系统创建了如下四个Flow:
- ChatBotTemplate__UploadMediaFile(其中“ChatBotTemplate”为3中配置的应用名称)
- ChatBotTemplate__UpdateMediaAuthStatus
- ChatBotTemplate__DeleteMediaFile
- ChatBotTemplate__SendMessages
除了“ChatBotTemplate__UpdateMediaAuthStatus”,其他三个Flow都使用了5G消息连接器,分别调用5G消息云服务平台的上传、删除多媒体内容文件以及下发消息接口。您需要了解在这些Flow中使用的具体连接器名称,再去配置该连接器。在应用开发界面打开Flow“ChatBotTemplate__UploadMediaFile”编排页面,选择5G Message图元,在右侧基本信息区域查看使用的具体连接器名称,如下图所示,使用的连接器为“命名空间__media”。
操作步骤
- 在App开发界面左侧列表单击
,选择“连接 > 连接器”。
- 在“行业”中单击“5G消息”图标,打开连接器列表。
- 单击连接器名称“命名空间__media”进入该连接器详情页面。请单击编辑按钮,配置基本信息中的对接参数。(若连接器列表页没有连接器“命名空间__media”,请单击“新建”,打开新建连接器页面。在页面中输入与5G消息云服务平台对接的参数。)图1 编辑已有连接器图2 编辑连接器
表1 对接参数说明 参数
说明
名称
连接器的名称。
保持默认,不需要修改。
应用ID
5G消息云服务平台分配的应用ID,用于标识该应用。
登录5G消息控制台,选择“5G消息增强版 > 应用管理”,进入应用管理界面,获取“APP ID”取值,即为应用ID取值。
应用密钥
访问5G消息云服务平台的请求密钥。
登录5G消息控制台,选择“5G消息增强版 > 应用管理”,进入应用管理界面,获取“APPSecret”取值,即为应用密钥取值。
终端类型
业务应用终端类型:
- Chatbot
- SP
- RCS SP
- H5
保持默认,不需要修改。默认值为“Chatbot”。
业务能力
业务能力标识。配置成“ChatbotSA”。
chatbot版本
chatbot版本号。
保持默认,不需要修改。
chatbot身份
chatbot身份信息,包含chatbot码号信息。对应5G消息接口参数“User-Agent”。
登录5G消息控制台,选择“5G消息增强版 > 应用管理”,进入应用管理界面,获取“Chatbot ID”取值,即为chatbot身份取值。
例如:SP/sip:10086@botplatform.rcs.chinamobile.com
消息文件接口地址
Maap(5G消息云服务平台中的一个网元)提供的服务接口地址,用于消息下发、文件上传、文件下载或文件删除。
保持默认,不需要修改。
撤回消息接口地址
Maap(5G消息云服务平台中的一个网元)提供的撤回消息接口地址。
保持默认,不需要修改。
5G消息标准版链接
5G消息标准版API。
保持默认,不需要修改。
描述
连接器的描述信息。
- 单击“保存”。
- (可选)创建连接器后,您可进行简单的测试,测试是否能调用5G消息云服务平台提供的接口。
- 在该连接器详情页面单击“测试”区域的接口,例如单击“uploadMedia”。
- 单击“测试一下”。
- 参考表2配置入参,单击“执行”。页面显示成功响应,表示调用成功。图3 进行测试
表2 uploadMedia参数说明 参数
说明
notifyUrl
多媒体内容文件审核结果通知根地址。
该地址获取方法:在聊天机器人应用开发界面左侧选择“Logic > DataAccess”,单击“应用名__MediaReviewNotice”,打开该数据接入设计页面。在右侧数据接入页面单击
,复制数据推送地址,配置到连接器“NotifyUrl”取值中。
fileName
上传文件名。
例如:test.txt
content
媒体文件,采用base64编码。
例如:data:text/plain;base64,dGVzdA==
thumbnail
缩略图文件,采用base64编码。可以为空(如语音片段可以由客户端使用默认缩略图);非空时需要包含文件类型(image/png)、缩略图内容等信息。
description
描述信息。
bodyTemp
扩展字段,暂不配置。
bodyVar
扩展字段,暂不配置。
