客户信息辅助组件设置与使用

一、客户信息辅助组件概述

Udesk客服系统内部包括客户管理模块，可以给客户设置多个字段来显示客户信息，但是一些与客户相关的复杂信息如订单或物流信息等不方便以字段的形式展现。客户信息辅助组件通过在Udesk查看客户信息时调用企业自己的iframe网页来展示客户的复杂信息。

二、企业开发网页

2.1使用效果展示

Udesk 客服系统会在IM相关信息和呼叫中心弹屏上加以iframe的形式加载网页如下图所示。切换客户时，会以不同形式的参数加载网页，实现展示不同客户信息的目的。

2.2企业开发网页的尺寸和技术方案

网页在IM显示时为宽度为448px，在呼叫中心弹屏显示时宽度为800px，因此需要网页支持448px到800px的自适应，非自适应网页Udesk会出现横向滚动条来显示网页。

出于安全性考虑Udesk的iframe sandbox设置为空，以下属性默认均不支持

如需支持请联系Udesk客服

allow-same-origin	允许将内容作为普通来源对待。如果未使用该关键字，嵌入的内容将被视为一个独立的源。
allow-top-navigation	嵌入的页面的上下文可以导航（加载）内容到顶级的浏览上下文环境（browsing context）。如果未使用该关键字，这个操作将不可用。
allow-forms	允许表单提交。
allow-scripts	允许脚本执行。

2.3企业开发网页的链接规则

Udesk在调用企业网页时会将客户信息参数传给URL,网页通过其中的客户参数（Udesk客服系统内的客户字段信息）识现用户识别客户从而展示不同的客户的信息，通过加密串来验证请求的合法性，URL规则如下。

调用URL=link + request_str + &timestamp=?&sign=?

字段名称说明

link 嵌入链接

request_str 请求参数

各个参数的连接串，如number=13312223343&email=someone@qq.com
如果是参数值是用户字段，且值是多个选项，则用 | 连接各个值，
如number=13312223343&email=someone@qq.com&user_field=v2|v3

timestamp 时间戳

如20151023104626

KEY 共享key（管理员登录设置后台可以获取）

sign 密串

sign=md5(request_str&timestamp=?&key)

2.4 客户信息辅助组件的设置

管理员登录Udesk系统后在【客户中心-客户设置-自定义用户信息辅助组件】中进行相关设置

开启功能，填写辅助组件名称，将网页URL填入嵌入链接字段中，选择加载的参数名称和参数字段，点击保存。点击生成预览链接系统会按照请求规则自动取一个用户信息生成一条测试链接，点击链接打开网页正常显示则客户即可在im和呼叫中心中使用客户信息辅助组件。

最后更新：2017-01-17 10:01:40