# 企微客服
企微客服由腾讯微信团队为企业打造，用于满足企业的客服需求，帮助企业做好客户服务。企业可以在微信内、外各个场景中接入企微客服，用户可以发起咨询，企业可以进行回复。 企业可在企微客服官网 (opens new window)使用企业微信扫码开通企微客服，开通后即可使用。
# 依赖配置
# 配置微信客服
企业微信管理员登录企业微信管理后台，按此路径『应用管理-微信客服-通过 API 管理微信客服』进入配置页面，取得 Secret、Token、EncodingAESKey，调用注册/更新基础应用接口将这些配置信息同步到企微中台；
此外，还需将微信客服的接收事件服务器地址配置为企微中台的回调地址；
微信客服的接收事件服务器地址可通过接口获取企微企业回调地址 获取。
# 词汇表
词汇表是统一语言的一部分。英文将用于源代码中。
| 中文名称 | 英文名称 | 英文缩写 | 值示例 | 描述 |
|---|---|---|---|---|
| 客服账号 | KeFu | kf | 接待客户的服务账号。拥有名称和头像。具体和客户对话时将是企微企业的某个企业成员 (opens new window)。 | |
| 接待人员 | Receptionist | 具体响应客户需求的企业成员。与客户具体对话时将以某个客服账号进行。 | ||
| 自动回复 | AutoRespond | 发送给某个客服账号的内容匹配到关键字时，企微中台将自动回复内容。 |
# 页面插件权限控制
# 客服账号管理能力编码：kefu
使用方法请参见页面插件接入章节
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| 00 | 查看客服账号管理 | 是否可以进入客服账号管理功能 |
| 01 | 添加客服账号 | 是否可以创建新的客服账号 |
| 02 | 编辑客服账号 | 是否可以编辑已有的客服账号信息 |
| 03 | 设置接待员工 | 是否可以设置客服账号的接待员工 |
| 04 | 删除客服账号 | 是否可以删除客服账号 |
# 自动回复能力编码：auto_reply
使用方法请参见页面插件接入章节
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| 00 | 查看自动回复 | 是否可以查看自动回复 |
| 01 | 新增自动回复 | 是否可以添加自动回复 |
| 02 | 编辑自动回复 | 是否可以删除自动回复 |
| 03 | 删除自动回复 | 是否可以编辑自动回复 |
数据权限
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| hideGlobalproject | 项目选择-全局 | 选择关联项目时是否可选全局 |
# 接待渠道
能力编码：receive-channels，使用方法请参见页面插件接入章节
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| 00 | 查看接待渠道 | 是否可以查看接待渠道 |
| 01 | 新增接待渠道 | 是否可以添加接待渠道 |
| 02 | 编辑接待渠道 | 是否可以删除接待渠道 |
| 03 | 删除接待渠道 | 是否可以编辑接待渠道 |
# 客服统计数据
能力编码：service_quality，使用方法请参见页面插件接入章节
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| 00 | 查看客服统计数据 | 是否可以查看客服统计数据 |
| 01 | 导出成员统计列表 | 是否可以导出成员统计列表 |
| 02 | 导出客服会话记录列表 | 是否可以导出客服会话记录列表 |
| 03 | 查看客服会话记录聊天记录 | 是否可以查看客服会话记录聊天记录 |
# 自助导航
能力编码：reply_menu，使用方法请参见页面插件接入章节
| 权限代码 | 权限名称 | 含义 |
|---|---|---|
| 00 | 查看 | 是否可以查看自助导航 |
| 01 | 添加/复制 | 是否可以添加/复制自助导航数据 |
| 02 | 编辑 | 是否可以编辑自助导航数据 |
| 03 | 删除 | 是否可以删除自助导航数据 |
# 领域模型
# 对外开放 API
| API 名称 | 定义 | 说明 |
|---|---|---|
| 获取企微成员的客服专属 URL | 查看 | |
| 导入企微中已有的客服账号 | 查看 | |
| 查询客服账号列表 | 查看 |
# 接入方需提供的 API
| API 名称 | 中台代码 | 是否必须实现 | 定义 | 说明 |
|---|---|---|---|---|
| 获取项目列表 | GetProjectList | 是 | 查看 | |
| 获取员工列表 | GetQwUserList | 是 | 查看 | |
| 获取小程序列表 | GetChannelMiniProgramList | 是 | 查看 | |
| 获取小程序页面列表 | GetChannelMiniProgramPages | 是 | 查看 |
# 支持订阅的企微中台事件
| 事件 | 定义 | 说明 |
|---|---|---|
| 客户发起咨询事件 | 查看 | |
| 客户接入人工服务事件 | 查看 | |
| 聊天消息产生事件 | 查看 |