网页客服组件IM外链

新IM链接引出简介

IM外链引出功能，能很方便的让企业通过更灵活的方式调用IM功能，并在多端，各种形式应用IM功能；IM外链引出能增加许多参数，以方便企业更灵活的应用此功能，具体请查看下面介绍。

此功能可以在系统下面位置设置和使用：

设置 > 网页客服组件 > 管理 > 组件引用

链接参数说明

不带任何参数的链接引出地址示例，其中123456为网页客服组件ID

https://yourdomain.kf5.com/kchat/123456

高级参数

下面是网页外链引出IM交谈框的高级参数，您可以根据实际情况向外链引出地址上额外增加这些参数，以实现数据传入功能


NameTypeComment
namestring用户的姓名或昵称
emailstring用户的邮箱地址
phonestring用户的手机号
metadatastring

用户自定义信息，数组JSON字符串，每个元素是一个对象，

每个对象包括两个键：name、value

 identity 

int(19)

调用者端唯一的客户身份（例如客户在调用者方系统中的用户ID,数组类型为int，长度最多19位）

该参数用于在对话创建时唯一身份区分，加该参数，则访问者在

同一个浏览器里面多开网页进行访问，会多次分配对话，如果不加该参数，

则多个窗口进行访问就不会进行多次分配


高级参数示例地址

https://yourdomain.kf5.com/kchat/123456?name=kf5&email=user@kf5.com&phone=13810111111&metadata=[{"name":"商品名称","value":"XXX手机"},{"name":"商品链接","value":"https://www.yourdomain.com/goods/xxxx.html"}]

注意：另需要对GET参数的值进行urlencode编码，实际访问时：

https://yourdomain.kf5.com/kchat/123456?name=kf5&email=user@kf5.com&phone=13810111111&metadata=%5b%7b%22name%22%3a%22%e5%95%86%e5%93%81%e5%90%8d%e7%a7%b0%22%2c%22value%22%3a%22XXX%e6%89%8b%e6%9c%ba%22%7d%2c%7b%22name%22%3a%22%e5%95%86%e5%93%81%e9%93%be%e6%8e%a5%22%2c%22value%22%3a%22https%3a%2f%2fwww.yourdomain.com%2fgoods%2fxxxx.html%22%7d%5d

展示示例

传入的参数会在IM客服操作面板的侧栏里显示，客服可以对该信息进行确认、修改或者保存

总结

企业可以根据自己的场景灵活配置IM外链引出地址的参数，以达成实际的效果，非常灵活方便。