自定义IFRAME应用开发与使用

赵旭发表于:2016年11月29日 早上 10:40:05更新于:2019年03月17日 晚上 8:11:29

自定义Iframe应用在面对企业想将其自己的系统的功能集成进入逸创云客服,并在操作和处理客户问题时能方便查询其自己系统的场景时非常有用

自定义IFRAME应用允许客户通过自定义开发一个IFRAME的H5页面通过云客服的 自定义IFRAME应用 内嵌进入 工单处理页面、用户页面、IM对话面板、电话面板的侧栏,实现业务集成的功能;常用场景有嵌入客户自己的CRM系统,方便在业务操作时查阅客户信息;或嵌入客户自己的订单系统,方便在业务操作时查阅对应客户订单信息等常见场景

Iframe是用URL传参的形式进行交互的,框架的宽度是320px,可以适配移动版网页。若Web版网页的话,需要技术人员写一个320px宽度的H5页面来适配应用界面。

添加Iframe应用

image2018-11-6_1-29-51.png?version=1&modificationDate=1541439139000&api=v2

Iframe可以添加多个,所以即便显示已安装,也可以再添加新的。

blob.png

可以设置Iframe权限、显示的位置以及框体的高度,高度单位为px

blob.png

blob.png


URL处填写需要显示的系统的URL地址。我们给提供了一些占位符,这些占位符与系统里的信息相对应。不同的显示位置,提供的占位符是不一样的,不可跨界面使用标签,不然传参不成功。

blob.png

对于安装在不同地方,他可以调取当前应用安装页面由云客服系统所传递的多种参数,企业通过这些参数的获取,从而实现和企业自行应用的参数传递集成

下面列出了在各个页面所支持的传递参数:

仅限于工单编辑页面使用的标签

{{ticket.id}}
{{ticket.title}}
{{ticket.status}}
{{ticket.priority}}
{{ticket.type}}
{{ticket.tags}}
{{ticket.requester.id}}
{{ticket.requester.name}}
{{ticket.requester.email}}
{{ticket.requester.phone}}
{{ticket.assignee.name}}
{{ticket.assignee.email}}
{{ticket.assignee.phone}}

可用于用户信息页面、IM对话页面、电话通话页面使用的标签

{{user.name}}
{{user.email}}
{{user.phone}}
{{user.id}}
{{user.wechat_appid}}
{{user.wechat_openid}}

仅限于IM对话页面

{{chat.id}}
{{visitor.metadata}}

所有页面可用标签

{{current_user.id}}
{{current_user.name}}
{{current_user.email}}
{{current_user.phone}}


后面的parametre是您系统中值的名称,按照您系统里的值进行填写就好了,{{}}是我们提供的占位符。若需要多个值进行用户身份确认的话,每个值中间加&。(这只是一个示例,不代表要有这么多值才能确认用户)

客户方的技术人员可以构造出类似如下的IFRAME APP网页地址:

https://yourdomain.com/iframeapp?parametre1={{current_user.phone}}&parametre2={{current_user.email}}&....

填入如下框中

image2018-11-14_21-5-21.png?version=1&modificationDate=1542200722000&api=v2


如上示例地址: 这样在使用时,就方便把当前页面的客户的手机和邮箱传参给客户的APP网页地址,同时客户的网页接受到了手机和邮箱信息,则通过客户需要实现的功能处理,将所需展示的客户或对应信息展示在APP中

如下图示例所示: 

则在处理工单页面可以查看到客户第三方系统里CRM里的对应客户信息

image2018-11-6_1-32-47.png?version=1&modificationDate=1541439315000&api=v2

上面只举了一个应用的例子,可以根据不同页面给到的参数,实现客户多样化的集成场景,如在用户信息页面展示对应客户订单列表信息;在工单列表侧栏查看关联的任务列表信息等


要使用IFRAME APP界面SDK请访问下面地址下载获取:

https://support.kf5.com/hc/kb/article/1249406/ 


    您需要登录后才可以回复

    10秒免费开通服务,拥有和逸创云客服官方一样的帮助中心+讨论社区+全渠道客服平台

    10秒免费开通服务

    在线客服 电话咨询 免费开通 返回顶部