差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
cs:300visitoraccess:web-widget [2020/07/01 07:49] candywang [支持的配置项] |
cs:300visitoraccess:web-widget [2024/04/03 09:12] 丁艺杰 [指定客服] |
||
---|---|---|---|
行 197: | 行 197: | ||
若指定关联,该网页插件由该关联接入客服云。若不指定,该网页插件由系统分配的关联接入客服云。 | 若指定关联,该网页插件由该关联接入客服云。若不指定,该网页插件由系统分配的关联接入客服云。 | ||
- | ==== 信息栏设置 ==== | + | === 输入框上方快捷操作 === |
- | 网页插件-信息栏设置,可设置常见问题及自助服务。开启后,访客端右侧可显示自助服务及常见问题,节省人力,提高客户服务效率。 | + | 支持自定义访客端输入框上方快捷操作,最多可配置16个操作,支持跳转链接、发送消息、转人工、评价行为,可将访客常见问题或快捷业务入口配置在这里。 |
+ | * 跳转链接:点击时,在新的标签页打开指定链接。可配置一些活动说明或用户通知类,点击跳转至详情。 | ||
+ | * 发送消息:可简短描述访客常见操作问题,点击此快捷操作时系统以访客身份自动发送问题,可在机器人知识库中预设相关问题的答案,自动回复访客。 | ||
+ | * 转人工:可配置转人工的业务入口,比如“投诉”,点击投诉时就会转人工。 | ||
+ | * 评价:点击时进行服务评价。 | ||
+ | |||
+ | {{:cs:releasenote:输入框上方快捷操作效果.png?nolink&1000|}} | ||
+ | |||
+ | === H5工具栏扩展操作 === | ||
+ | |||
+ | * 背景:H5端由于设备原因,除了输入框和选择表情在工具栏上直接展示,其他的操作都要点击+才能看到。这里说的工具栏扩展操作就是指点击+之后看到的操作,可以支持自定义。 | ||
+ | * 功能说明:支持自定义扩展操作,最多可配置16个操作,支持跳转链接、弹出窗口、拍照/选照片、拍视频/选视频、评价行为,可将快捷业务入口配置在这里。 | ||
+ | * 跳转链接:点击时,跳转至指定链接。可配置一些活动说明或用户通知类,点击跳转至详情。 | ||
+ | * 弹出窗口:点击时,在当前页面弹出60%高度窗口,支持嵌入iframe页面,比如:商品/订单。iframe页面可按[[cs:300visitoraccess:extended-message-format|扩展消息格式说明]]发送商品/订单轨迹消息格式集成,支持访客一键发送商品/订单卡片消息。 | ||
+ | * 拍照/选照片:点击可拍照/选照片。 | ||
+ | * 拍视频/选视频:点击可拍视频/选视频。 | ||
+ | * 评价:点击可触发服务评价。 | ||
+ | |||
+ | {{:cs:300visitoraccess:img_3286.png?nolink&300|}} | ||
+ | |||
+ | |||
+ | ==== 侧边栏设置 ==== | ||
+ | |||
+ | 网页插件-侧边栏设置,可设置侧边栏宽度、常见问题、自助服务及iframe页面。开启后,访客端右侧可显示自助服务及常见问题,节省人力,提高客户服务效率。 | ||
+ | 侧边栏配置完成后,打开侧边栏开关,侧边栏即可生效。 | ||
pc端访客端样式: | pc端访客端样式: | ||
行 209: | 行 233: | ||
=== 常见问题 === | === 常见问题 === | ||
- | 网页插件-信息栏设置,用户可手动添加常见问题,添加后在访客端展示常见问题列表,访客可点击问题查看对应答案。 | + | 网页插件-侧边栏设置,用户可手动添加常见问题,添加后在访客端展示常见问题列表,访客可点击问题查看对应答案。 |
常见问题仅支持文字类型(问题描述最多20个字符,答案描述最多1000个字符)。 | 常见问题仅支持文字类型(问题描述最多20个字符,答案描述最多1000个字符)。 | ||
行 221: | 行 245: | ||
=== 自助服务 === | === 自助服务 === | ||
- | 网页插件-信息栏设置,新增自助服务功能,用户可通过设定业务名称、业务链接、业务图标添加自助服务。 | + | 网页插件-侧边栏设置,新增自助服务功能,用户可通过设定业务名称、业务链接、业务图标添加自助服务。 |
开关打开时,访客端会自动显示自助服务。关闭时,不显示自助服务。最多可以配置 8 个自助服务。 | 开关打开时,访客端会自动显示自助服务。关闭时,不显示自助服务。最多可以配置 8 个自助服务。 | ||
行 234: | 行 258: | ||
- | === 访客端信息栏样式 === | + | === 访客端侧边栏样式 === |
PC端样式说明: | PC端样式说明: | ||
行 247: | 行 271: | ||
移动端样式说明: | 移动端样式说明: | ||
- | - 新增一个访客端落地页,显示信息栏内容,联系客服作为悬浮按钮,点击后跳转显示聊窗(刷新页面)。 | + | - 新增一个访客端落地页,显示侧边栏内容,联系客服作为悬浮按钮,点击后跳转显示聊窗(刷新页面)。 |
- 悬浮窗显示(集成网页插件)时,点击悬浮按钮后:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 | - 悬浮窗显示(集成网页插件)时,点击悬浮按钮后:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 | ||
- 独立页面显示(集成网页链接)时:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 | - 独立页面显示(集成网页链接)时:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 | ||
行 271: | 行 295: | ||
easemobim.config = { | easemobim.config = { | ||
hide: true, | hide: true, | ||
- | autoConnect: true | + | autoConnect: false |
}; | }; | ||
</script> | </script> | ||
行 277: | 行 301: | ||
</code> | </code> | ||
- | 注意:当设置 hide 为 true 时,建议同时设置 autoConnect 为 true,以便访客端聊天窗口最小化时,收到新消息提醒。 | + | ⚠️注意:当设置 hide 为 true 时,建议同时设置 autoConnect 为 true,以便访客端聊天窗口最小化时,收到新消息提醒。 |
参数解释: | 参数解释: | ||
行 316: | 行 340: | ||
|dialogHeight|String|否|聊天窗口高度,默认值:'550px'| | |dialogHeight|String|否|聊天窗口高度,默认值:'550px'| | ||
|dialogPosition|Object|否|聊天窗口初始位置,坐标以视口右边距和下边距为基准,默认值:{ x: '10px', y: '10px' }| | |dialogPosition|Object|否|聊天窗口初始位置,坐标以视口右边距和下边距为基准,默认值:{ x: '10px', y: '10px' }| | ||
+ | |||
+ | ==== 指定技能组 ==== | ||
+ | 为聊天窗口指定技能组,使客户发起的会话分配到该技能组进行接待。 | ||
+ | <code html> | ||
+ | <script> | ||
+ | function sendCrmExt(){ | ||
+ | window.easemobim.sendExt( | ||
+ | { | ||
+ | // 技能组 | ||
+ | ext:{ | ||
+ | weichat:{ | ||
+ | queueName:"技能组名称", | ||
+ | queueId:"技能组ID" | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </code> | ||
==== 指定客服 ==== | ==== 指定客服 ==== | ||
行 332: | 行 374: | ||
</code> | </code> | ||
- | 注:“指定客服”比“指定技能组”的优先级高。若同时指定客服和技能组,则会话分配给指定的客服。 | + | 特殊说明: |
+ | |||
+ | 1、“指定客服”比“指定技能组”的优先级高。 | ||
+ | |||
+ | 2、若同时指定客服和技能组,则会话分配给指定的客服。只要指定的客服已登录,无论该客服处于各种状态下,且无论是否配置机器人优先接待,此会话均会强制直接分配给此客服接起。 | ||
+ | |||
+ | 3、对应的指定客服处于未登录状态下,该会话依然会被正常创建并指向给该坐席。 | ||
参数解释: | 参数解释: | ||
行 343: | 行 392: | ||
当访客发起咨询时(前提为已登录用户),网站可自动将该用户信息(如名称、手机、邮箱、QQ 等)发送给客服,并显示在聊天窗口右侧。 | 当访客发起咨询时(前提为已登录用户),网站可自动将该用户信息(如名称、手机、邮箱、QQ 等)发送给客服,并显示在聊天窗口右侧。 | ||
+ | |||
+ | 管理员模式 >设置 > 功能设置 >允许访客端修改客户信息 要打开,nickName不能为空。 | ||
配置示例: | 配置示例: | ||
行 379: | 行 430: | ||
|configId|String|是|设置为您的网页插件页面显示的configId的值| | |configId|String|是|设置为您的网页插件页面显示的configId的值| | ||
|visitor|Object|否|访客信息| | |visitor|Object|否|访客信息| | ||
+ | |||
+ | ==== 自定义字段传参集成用户信息 ==== | ||
+ | |||
+ | 配置示例 | ||
+ | <code html> | ||
+ | <script> | ||
+ | window.easemobim = window.easemobim || {}; | ||
+ | easemobim.config = { | ||
+ | configId: '304fe7b6-3046-416b-b169-0398f647b90e', | ||
+ | visitor: { | ||
+ | trueName: '112222',//值外层必须要有单引号以字符串格式传输否则传输失败 | ||
+ | userNickname: '1234', | ||
+ | description: '0909', | ||
+ | email: '', | ||
+ | userDefineColumn: '{"WQQ":"帅哥","QAZ":"LLLLLLLTTTTTTTT"}', | ||
+ | }, | ||
+ | </code> | ||
+ | userDefineColumn里边的key必须是客服系统添加的自定义字段ID才会生效。 | ||
+ | 比如: | ||
+ | {{:cs:300visitoraccess:自定义.jpg?nolink&1000|}} | ||
+ | {{:cs:300visitoraccess:资料设置.jpg?nolink&800|}} | ||
==== 集成用户体系 ==== | ==== 集成用户体系 ==== | ||
行 544: | 行 616: | ||
|configId|String|是|设置为您的网页插件页面显示的configId的值| | |configId|String|是|设置为您的网页插件页面显示的configId的值| | ||
|onready: function () { }|Function|否|聊天窗口加载成功回调| | |onready: function () { }|Function|否|聊天窗口加载成功回调| | ||
- | |onmessage: function ( message ) { }|Function|否|收消息回调,只对当前打开的聊天窗口有效| | + | |onmessage: function ( message ) { }|Function|否|收消息回调,只对当前打开的聊天窗口有效,当访客收到来自系统消息、机器人消息、坐席消息均会触发此回调| |
- | |onsessionclosed: function () { }|Function|否|会话结束回调| | + | |onsessionclosed: function () { }|Function|否|会话结束事件回调| |
+ | |onsessioncreat: function () { }|Function|否|会话创建事件回调| | ||
+ | |||
+ | ==== 支持业务标识路由 ==== | ||
+ | |||
+ | 访客端在集成时候在easemob.config里增加字段 routingRuleFlag:"" | ||
+ | |||
+ | 配置示例: | ||
+ | |||
+ | <code html> | ||
+ | easemobim.config ={ | ||
+ | //增加业务标识路由字段 | ||
+ | configId: '84a85315-4ce7-4f5c-8fac-17e0bccbece0', routingRuleFlag:"测试的业务标识路由", } | ||
+ | </code> | ||
===== 高级功能(H5网页) ===== | ===== 高级功能(H5网页) ===== | ||
行 650: | 行 735: | ||
注:domain、path、staticPath 三个参数,请填写双斜杠(%%//%%)开头的可访问的服务器路径,不要加协议头,结尾无需添加“/”。 | 注:domain、path、staticPath 三个参数,请填写双斜杠(%%//%%)开头的可访问的服务器路径,不要加协议头,结尾无需添加“/”。 | ||
+ | |||
+ | |||
==== 支持的配置项 ==== | ==== 支持的配置项 ==== | ||
行 671: | 行 758: | ||
|dialogHeight|String|否|聊天窗口高度,默认值:'550px'|是|否| | |dialogHeight|String|否|聊天窗口高度,默认值:'550px'|是|否| | ||
|dialogPosition|Object|否|聊天窗口初始位置,坐标以视口右边距和下边距为基准,默认值:{ x: '10px', y: '10px' }|是|否| | |dialogPosition|Object|否|聊天窗口初始位置,坐标以视口右边距和下边距为基准,默认值:{ x: '10px', y: '10px' }|是|否| | ||
- | |onmessage: function ( message ) { }|Function|否|收消息回调,只对当前打开的聊天窗口有效|是|是| | + | |onmessage: function ( message ) { }|Function|否|收消息回调,只对当前打开的聊天窗口有效,,当访客收到来自系统消息、机器人消息、坐席消息均会触发此回调|是|是| |
|onready: function () { }|Function|否|聊天窗口加载成功回调|是|是| | |onready: function () { }|Function|否|聊天窗口加载成功回调|是|是| | ||
|onopen: function () { }|Function|否|聊天窗口打开回调|是|是| | |onopen: function () { }|Function|否|聊天窗口打开回调|是|是| | ||
|onclose: function () { }|Function|否|聊天窗口关闭回调|是|是| | |onclose: function () { }|Function|否|聊天窗口关闭回调|是|是| | ||
- | |onsessionclosed: function () { }|Function|否|会话结束回调|是|是| | + | |onEvaluationsubmit:function(){}|Function|否|满意度评价提交回调|是|是| |
+ | |onsessioncreat: function () { }|Function|否|会话创建事件回调,例如访客发送首条消息后会话成功建立起来后会触发此回调事件|是|是| | ||
+ | |onsessionclosed: function () { }|Function|否|会话结束事件回调|是|是| | ||
+ |