差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
cs:300visitoraccess:web-widget [2019/06/05 12:06] 吴玉萍 [显示样式设置] |
cs:300visitoraccess:web-widget [2019/08/09 03:48] candywang [样式设置] |
||
---|---|---|---|
行 16: | 行 16: | ||
* 兼容性:兼容旧版网页插件的代码集成方式,升级新版后,不影响已有的网页聊天窗口功能。 | * 兼容性:兼容旧版网页插件的代码集成方式,升级新版后,不影响已有的网页聊天窗口功能。 | ||
- | {{:cs:300visitoraccess:admin-channel-web4.png?nolink|新版网页插件}} | + | {{:cs:releasenote:渠道管理-网页插件.png?nolink|渠道管理-网页插件}} |
=== 旧版网页插件 === | === 旧版网页插件 === | ||
行 40: | 行 40: | ||
* 对于其他用户(多租户系统的用户):请您登录环信客服云后,选择“管理员模式 > 渠道管理 > 手机APP”,在该页面依次点击“添加APP关联”和“快速创建”,环信将为您创建一个APP关联。该关联可以作为网页访客端收发消息的通道,也可用于APP渠道集成。 | * 对于其他用户(多租户系统的用户):请您登录环信客服云后,选择“管理员模式 > 渠道管理 > 手机APP”,在该页面依次点击“添加APP关联”和“快速创建”,环信将为您创建一个APP关联。该关联可以作为网页访客端收发消息的通道,也可用于APP渠道集成。 | ||
- | ===== 快速集成===== | ||
- | 新版网页插件支持聊天窗口和H5网页两种方式: | + | ===== 设置网页插件 ===== |
- | ==== 聊天窗口 ==== | + | 可以在客服工作台设置网页插件的接入方式、样式设置、功能设置、信息栏设置。除特殊说明外,以下设置对PC端、移动端聊天窗口和H5网页均生效。 |
- | 在“管理员模式 > 渠道管理 > 网页”页面,将网页插件的代码复制并粘贴到您的网站的</body>标签之前,保存并发布。 | ||
- | 移动端集成需要加自定义按钮,详见 [[#自定义“联系客服”按钮 | 自定义“联系客服”按钮]] | + | ==== 接入方式 ==== |
- | {{:cs:300visitoraccess:admin-channel-web4.png?nolink|网页插件代码}} | + | |
- | === 英文版聊天窗口 === | + | 支持集成网页插件和集成网页链接两种方式。 |
- | 集成英文版聊天窗口: | + | === 集成网页插件 === |
+ | |||
+ | 在“管理员模式 > 渠道管理 > 网页 > 接入方式”页面,将网页插件的代码复制并粘贴到您的网站的</body>标签之前,保存并发布。 | ||
+ | |||
+ | 英文版集成网页插件: | ||
- 进入“客服模式 > 客服信息”页面,将系统语言修改为英文。 | - 进入“客服模式 > 客服信息”页面,将系统语言修改为英文。 | ||
行 60: | 行 61: | ||
代码示例: | 代码示例: | ||
- | <code html><script src='//kefu.easemob.com/webim/en-US/easemob.js?configId=304fe7b6-3046-416b-b169-0398f647b90e'></script></code> | + | <code html><script src='//kefu.easemob.com/webim/easemob.js?configId=982d8f2d-06db-49ab-9e14-673c151172b6'></script></code> |
+ | |||
+ | === 集成网页链接 === | ||
+ | |||
+ | 使用网页链接将客服聊天页面集成到您到网站,即可完成客服云的快速接入。 | ||
+ | |||
+ | 网页链接示例: | ||
+ | |||
+ | <code http>https://kefu.easemob.com/webim/im.html?configId=982d8f2d-06db-49ab-9e14-673c151172b6</code> | ||
注意:en-US区分大小写。 | 注意:en-US区分大小写。 | ||
+ | ==== 样式设置 ==== | ||
- | ==== H5网页 ==== | + | === 广告栏设置 === |
- | 在浏览器地址栏输入以下地址,并将{configId}替换为您的网页插件页面显示的configId的值。 | + | 文本模式: |
- | <code http>https://kefu.easemob.com/webim/im.html?configId={configId}</code> | + | 开关开启,可以设置广告消息,并展示在聊天窗口。 |
- | === 英文版H5网页 === | + | {{:cs:300visitoraccess:admin-channel-web10.png?nolink|信息栏(文本)}} |
- | 集成英文版H5网页: | + | 导航菜单模式: |
- | 将以下URL中{configId}修改为您的网页插件的configId的值: | + | 支持将文本信息栏切换为自定义导航菜单,并展示在聊天窗口。自定义导航菜单包含一级菜单和二级菜单,可创建最多3个一级菜单,每个一级菜单下可创建最多5个二级菜单。可在菜单上设置图文消息(从素材库选择),当访客点击菜单项时,自动向访客发送对应的图文消息。 |
- | <code http>https://kefu.easemob.com/webim/en-US/im.html?configId={configId}</code> | + | 开关打开时,同时将访客对导航菜单的选择作为轨迹消息发送给客服,并创建会话。 |
- | 注意:en-US区分大小写。 | + | {{:cs:300visitoraccess:admin-channel-web13.png?nolink|信息栏(自定义导航菜单)}} |
- | ===== 设置网页插件 ===== | + | 访客端示例(导航菜单显示在聊天窗口上方): |
+ | |||
+ | {{:cs:300visitoraccess:admin-channel-web14.png?nolink|导航菜单示例}} | ||
+ | |||
+ | 注:自定义导航菜单为企业版、旗舰版功能。 | ||
+ | |||
+ | === 企业形象展示位 === | ||
+ | |||
+ | 开关开启,可以设置企业品牌广告,并展示在聊天窗口。 | ||
+ | |||
+ | {{:cs:300visitoraccess:admin-channel-web11.png?nolink|企业形象展示}} | ||
+ | |||
+ | === 选择主题风格 === | ||
+ | |||
+ | 选择聊天窗口和悬浮按钮的颜色主题。 | ||
+ | |||
+ | {{:cs:300visitoraccess:admin-channel-web12.png?nolink|主题风格}} | ||
+ | |||
+ | === H5网页标题 === | ||
+ | |||
+ | 设置H5网页在浏览器页签中显示的名称。 | ||
+ | |||
+ | 注:该功能只对H5网页生效。 | ||
+ | |||
+ | === 邀请窗口 === | ||
+ | |||
+ | 开关开启,网页访客端可自动弹出邀请窗口,邀请访客加入会话。 | ||
- | 可以在客服工作台设置网页插件的常用功能和显示样式。除特殊说明外,以下设置对PC端、移动端聊天窗口和H5网页均生效。 | + | 配置窗口可配置邀请机制及邀请样式。 |
- | 设置网页插件: | ||
- | - 在“网页”页面,选择一个网页插件。 | ||
- | - [[#功能设置|设置网页插件的功能]]。 | ||
- | - [[#显示样式设置|设置网页插件的样式显示]]。 | ||
- | - 点击“预览实际效果”按钮,对网页插件进行预览。 | ||
- | - 点击“保存”按钮,保存该网页插件的设置。 | ||
==== 功能设置 ==== | ==== 功能设置 ==== | ||
行 106: | 行 136: | ||
* 展示默认消息(需要设置消息内容) | * 展示默认消息(需要设置消息内容) | ||
* 进入聊天窗口 | * 进入聊天窗口 | ||
+ | |||
+ | === 满意度评价邀请方式 === | ||
+ | |||
+ | 可选择“发送系统消息”或“主动弹出邀请”两种邀请评价方式。 | ||
=== 主动评价功能 === | === 主动评价功能 === | ||
行 149: | 行 183: | ||
若指定关联,该网页插件由该关联接入客服云。若不指定,该网页插件由系统分配的关联接入客服云。 | 若指定关联,该网页插件由该关联接入客服云。若不指定,该网页插件由系统分配的关联接入客服云。 | ||
- | === H5网页标题 === | + | ==== 信息栏设置 ==== |
- | 设置H5网页在浏览器页签中显示的名称。 | + | === 常见问题 === |
- | 注:该功能只对H5网页生效。 | + | 网页插件-信息栏设置,用户可手动添加常见问题,添加后在访客端展示常见问题列表,访客可点击问题查看对应答案。 |
- | ==== 显示样式设置 ==== | + | 常见问题仅支持文字类型(问题描述最多20个字符,答案描述最多1000个字符)。 |
- | === 信息栏设置(文本) === | + | 开关打开时,访客端会自动显示常见问题。关闭时,不显示常见问题。 |
- | 开关开启,可以设置广告消息,并展示在聊天窗口。 | + | {{:cs:releasenote:网页插件-常见问题new.png?nolink|网页插件-常见问题}} |
- | {{:cs:300visitoraccess:admin-channel-web10.png?nolink|信息栏(文本)}} | + | === 自助服务 === |
- | === 企业形象展示位 === | + | 网页插件-信息栏设置,新增自助服务功能,用户可通过设定业务名称、业务链接、业务图标添加自助服务。 |
- | 开关开启,可以设置企业品牌广告,并展示在聊天窗口。 | + | 开关打开时,访客端会自动显示自助服务。关闭时,不显示自助服务。最多可以配置 8 个自助服务。 |
- | {{:cs:300visitoraccess:admin-channel-web11.png?nolink|企业形象展示}} | + | {{:cs:releasenote:网页插件-自助服务new.png?nolink|网页插件-自助服务}} |
- | === 选择主题风格 === | + | 添加自助服务: |
- | 选择聊天窗口和悬浮按钮的颜色主题。 | + | {{:cs:releasenote:添加自助服务new.png?nolink|添加自助服务}} |
- | {{:cs:300visitoraccess:admin-channel-web12.png?nolink|主题风格}} | + | === 访客端信息栏样式说明 === |
+ | PC端样式说明: | ||
- | === 信息栏设置(导航菜单) === | + | - 根据常见问题开关状态、自助服务开关状态,在访客端右侧显示或不显示常见问题列表、自助服务按钮。 |
+ | - 点击常见问题列表可以展开显示问题和答案或收起只显示问题;点击自助服务按钮,跳转至设定的URL。 | ||
+ | - 悬浮窗显示(集成网页插件)时,访客端宽度增加一倍,聊窗尺寸不变,聊窗右侧显示常见问题和自助服务。 | ||
+ | - 独立页面显示(集成网页链接)时,访客端默认显示1024*768,聊窗右侧显示常见问题和自助服务(各占一半)。 | ||
- | 支持将文本信息栏切换为自定义导航菜单,并展示在聊天窗口。自定义导航菜单包含一级菜单和二级菜单,可创建最多3个一级菜单,每个一级菜单下可创建最多5个二级菜单。可在菜单上设置图文消息(从素材库选择),当访客点击菜单项时,自动向访客发送对应的图文消息。 | + | {{:cs:releasenote:访客pc端信息栏样式.png?nolink|访客pc端信息栏样式}} |
- | 开关打开时,同时将访客对导航菜单的选择作为轨迹消息发送给客服,并创建会话。 | + | 移动端样式说明: |
- | {{:cs:300visitoraccess:admin-channel-web13.png?nolink|信息栏(自定义导航菜单)}} | + | - 新增一个访客端落地页,显示信息栏内容,联系客服作为悬浮按钮,点击后跳转显示聊窗(刷新页面)。 |
- | + | - 悬浮窗显示(集成网页插件)时,点击悬浮按钮后:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 | |
- | 访客端示例(导航菜单显示在聊天窗口上方): | + | - 独立页面显示(集成网页链接)时:常见问题和自助服务,开关有一方打开,访客端显示新的落地页;开关均关闭,显示现有访客端页面。 |
- | + | ||
- | {{:cs:300visitoraccess:admin-channel-web14.png?nolink|导航菜单示例}} | + | |
- | + | ||
- | 注:自定义导航菜单为企业版、旗舰版功能。 | + | |
+ | {{:cs:releasenote:访客移动端信息栏样式.png?nolink|访客移动端信息栏样式}} | ||
===== 高级功能(聊天窗口) ===== | ===== 高级功能(聊天窗口) ===== | ||
行 296: | 行 331: | ||
userNickname: '我是黎小冷', | userNickname: '我是黎小冷', | ||
description: '描述信息', | description: '描述信息', | ||
- | email: '123456@**.com' | + | email: '123456@**.com', |
+ | tags:[ | ||
+ | 'vip1', | ||
+ | 'vip2' | ||
+ | ] | ||
} | } | ||
}; | }; | ||
行 306: | 行 345: | ||
* 若再次更新 visitor 字段信息,需要访客端清除浏览器 cookie 才能正确显示更新后的用户信息。 | * 若再次更新 visitor 字段信息,需要访客端清除浏览器 cookie 才能正确显示更新后的用户信息。 | ||
* 在会话过程中,如果客服对访客的资料进行了编辑,则显示客服编辑后的访客资料。 | * 在会话过程中,如果客服对访客的资料进行了编辑,则显示客服编辑后的访客资料。 | ||
+ | * ‘tags’字段可标出VIP用户,其值可以为零到多个。 | ||
参数解释: | 参数解释: | ||
行 319: | 行 359: | ||
执行以下步骤: | 执行以下步骤: | ||
- | - 参考环信服务器端[[http://docs.easemob.com/im/100serverintegration/20users|用户体系集成]],获取环信后台 username 和 password。 | + | - 参考环信服务器端[[http://docs.easemob.com/im/100serverintegration/20users|用户体系集成]],获取环信后台 username 和 password,以及管理员Token。 |
- 登录环信客服云,进入“管理员模式 > 渠道管理 > 手机App”页面,使用您的AppKey等信息[[cs:300visitoraccess:createappchannel|创建App关联]]。 | - 登录环信客服云,进入“管理员模式 > 渠道管理 > 手机App”页面,使用您的AppKey等信息[[cs:300visitoraccess:createappchannel|创建App关联]]。 | ||
- 进入环信客服云的“管理员模式 > 渠道管理 > 网页”页面,在您的网页插件的功能设置区域,找到[[#指定关联|指定关联]],选择上一步创建的App关联。 | - 进入环信客服云的“管理员模式 > 渠道管理 > 网页”页面,在您的网页插件的功能设置区域,找到[[#指定关联|指定关联]],选择上一步创建的App关联。 | ||
行 352: | 行 392: | ||
} | } | ||
</script> | </script> | ||
+ | </code> | ||
+ | |||
+ | 获取用户Token:根据username和password获取access_token。 | ||
+ | |||
+ | |||
+ | * Path:https://a1.easemob.com/orgName/appName/token(北京集群);https://a1-vip5.easemob.com/orgName/appName/token(客服快速关联appkey) | ||
+ | * HTTP Method:POST | ||
+ | * Request Headers: Content-Type=application/json | ||
+ | |||
+ | Request body: | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "grant_type":"password", | ||
+ | "username":"user", | ||
+ | "password":"pwd" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | Response示例 | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "access_token": "YWMtI5JsbKhHEem57CF4KOxCxnljbbBGLhHpjpSjqzuD_CB4YttqkNER6YIJEZ8gpOpaAwMAAAFr_hTkLQBPGgB7xNZ6-mjCRkn_nivCNcB01uiyS9Yt9pdiU_6LH579zA", | ||
+ | "expires_in": 5184000, | ||
+ | "user": { | ||
+ | "uuid": "7862db6a-90d1-11e9-8209-119f20a4ea5a", | ||
+ | "type": "user", | ||
+ | "created": 1560756495382, | ||
+ | "modified": 1560765534117, | ||
+ | "username": "test1", | ||
+ | "activated": true, | ||
+ | "device_token": "Getg6CgqFanQ4dwAvn9/qxoa5crWpNSkiVFcVt3eDr1S6xqz5X2sm0dbi1yNAQsl", | ||
+ | "notifier_name": "2882303761517507836" | ||
+ | } | ||
+ | } | ||
</code> | </code> | ||