更新时间:2022-04-27 GMT+08:00
分享

步骤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”。

操作步骤

  1. 在App开发界面左侧列表单击,选择“连接 > 连接器”。
  2. 在“行业”中单击“5G消息”图标,打开连接器列表。
  3. 单击连接器名称“命名空间__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。

    保持默认,不需要修改。

    描述

    连接器的描述信息。

  4. 单击“保存”。
  5. (可选)创建连接器后,您可进行简单的测试,测试是否能调用5G消息云服务平台提供的接口。

    1. 在该连接器详情页面单击“测试”区域的接口,例如单击“uploadMedia”。

    2. 单击“测试一下”。

    3. 参考表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

      扩展字段,暂不配置。

分享:

    相关文档

    相关产品

close