辅助组件
功能简介
1、 总体功能简介
得助系统支持企业配置辅助组件，通过iframe页面嵌套方式，来快速方便地查看一些复杂的、不方便以字段直接显示的信息，如用户自己的CRM页面、订单查询、报告查询等，辅助组件功能分为全局组件与工作台组件；
2、 全局辅助组件
全局辅助组件位于左侧一级菜单栏展示，通过Iframe页面加载信息，方便企业灵活对接第三方系统，实现客服灵活、高效处理业务。
3、 工作台辅助组件
工作台辅助组件位于页面标签栏展示，场景支持呼入、呼出、在线客服等等（具体以配置页面为准）, 通过Iframe页面加载信息，并支持根据客户信息传递不同参数，坐席可快速便捷地查询客户在第三方系统的信息，如订单信息、交易记录。
接入须知
企业原系统必须是https站点。
配置说明
- 全局辅助组件配置
管理员登录得助系统后在【设置-公共设置-辅助组件-全局】中进行相关配置，如下图：
点击“新增”按钮进入配置页面，如下图
配置项与对应功能为：
菜单名称：全局辅助组件在左侧一级菜单栏展示的名称；
URL地址：执行网站链接时的嵌入链接；
KEY: 根据租户生成的唯一ID（不可变动），用于安全校验；
选择图标：全局辅助组件在左侧一级菜单栏展示的图标样式；
- 工作台辅助组件配置
管理员登录得助系统后在【设置-公共设置-辅助组件-工作台】中进行相关配置，如下图：
点击“新增”按钮进入配置页面，如下图
配置项与对应功能为：
名称：工作台在调用企业网页展示的页面名称；
URL地址：执行网站链接时的嵌入链接；
弹屏类型：选择使用场景；
KEY: 根据租户生成的唯一ID（不可变动），用于安全校验；
参数名称：调用企业网站时需要添加的参数名称；
参数字段：调用企业网站时需要添加的参数对应值；
功能说明
- 网页链接规则
得助平台在调用企业网页时会将客户信息参数传给URL，网页通过其中的客户信息参数（得助系统内配置的客户字段信息）实现自动识别客户从而展示不同的信息，并通过加密串来验证请求的合法性，URL规则如下：
URL=link + request_str + ×tamp=?&sign=?
- 安全性说明
URL中的签名sign是由KEY +时间戳MD5生成，其中KEY不会在URL中暴露，服务器收到请求后按照相同的规则，使用KEY +URL中获取的时间戳重新生成一遍，然后比对结果，如果一致，说明这个请求是由掌握Key的服务发起的请求，从而验证了请求的合法性。
- 字段说明
| 字段名 | 说明 |
|---|---|
| link | 嵌入链接 |
| request_str | 请求参数，多个参数的连接串如下：number=13312223343&name=userName 如果是参数值是用户字段，且值是多个选项，则｜用连接各个值，示例如下： number=13312223343&name=userName&user_field=v2｜v3 |
| timestamp | 时间戳，如1574131345 |
| sign | 密串 |
| KEY | Key值（管理员登录设置后台可以获取） |
签名sign的生成代码：
org.springframework.util.DigestUtils
DigestUtils.md5DigestAsHex((timestamp + key).getBytes());
功能使用
客服只需要在左侧一级菜单栏、工作台选择相应辅助组件的标签页点击即可显示辅助组件。
效果演示
全局辅助组件效果演示
FAQ:
此处描述接口的常见问题。如无，则不需要此项。