目录
企业微信新向服务商开放会话内容存档三方接口,经客户企业授权后,服务商可通过接口获取企业内部员工以及员工和客户间的会话记录(不含内容),并使用展示组件安全展示会话内容,用以满足企业的合规检查和提升客户服务质量的诉求。
合作伙伴可按照以下流程接入:
服务商可根据自身的产品定位、使用场景、客户需求等综合考虑要基于「会话内容存档三方接口」实现的功能,以下是对基于「会话内容存档三方接口」实现的常见功能及用到的接口的说明,供服务商参考。
功能:查看员工之间、员工和客户间的会话内容
使用到的API/能力:
功能:
使用到的API/能力:
功能:对会话内容进行审计,可设定审计的会话范围,并针对会话范围中出现的敏感内容和敏感行为进行预警
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
关键词规则管理 | 可通过定义关键词、关键行为来定义一个关键词规则,命中规则的消息将回调通知 |
获取命中关键词规则的会话记录 | 可获取一段时间内命中关键词规则的会话记录 |
会话展示组件 | 可使用展示组件展示群名称、会话内容 |
功能:导出某部分会话内容,如导出员工 A 和客户 B 的会话内容 或 发送涉嫌敏感内容的会话内容,方便审核人员进行二次审核
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
会话内容导出 | 可通过接口提交导出任务,在导出的文件中由企业微信进行转译,转译成正确的内容之后展示给用户 |
功能:针对某部分会话内容,快速提取摘要。如针对员工 A 和客户 B 的沟通内容,快速提取一段会话摘要,方便审核人员进行审核
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
会话内容分析 | 通过接口提交分析任务,对多条会话消息批量分析并提取摘要 |
功能:可定义一组关键词,当会话内容中命中关键词时进行相应的产品处理。如设定某些商品的关键词,如服饰行业的“卫衣”“运动裤”等,当客户发送的消息包含对应的关键词,在消息侧边栏展示对应商品,方便导购发送到会话中
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
关键词规则管理 | 可通过定义关键词、关键行为来定义一个关键词规则,命中规则的消息将回调通知 |
获取命中关键词规则的会话记录 | 可获取一段时间内命中关键词规则的会话记录 |
会话展示组件 | 可使用展示组件展示群名称、会话内容 |
功能:基于员工和客户的会话内容,对员工的客户服务质量进行评估,如:
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
获取会话记录 | 获取授权范围内成员的会话记录,包括会话ID、消息ID、消息发送人、消息接收人、消息发送时间、消息类型 |
会话内容分析 | 通过接口提交分析任务,分析会话消息的情感状态(正中负) |
功能:对企业会话数据进行统计,包括但不限于:
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
获取会话记录 | 获取授权范围内成员的会话记录,包括会话ID、消息ID、消息发送人、消息接收人、消息发送时间、消息类型 |
功能:针对会话内容的其他自定义分析功能,如词频分析、客户画像分析等,且相关的分析代码为服务商自行实现
使用到的API/能力:
API/能力 | API/能力说明 |
---|---|
数据分析专区 | 服务商可将分析代码打包成镜像部署到企业微信的数据分析专区,数据分析专区与外界网络隔离,只能通过专属网络访问专区接口,以拉取消息内容到专区服务上进行分析。既保证服务商功能的完整性,同时保证数据的安全性。 |
序号 | 接口 | 接口描述 | 使用场景举例(供参考) |
---|---|---|---|
1 | 获取会话记录 | 可获取授权范围内成员的会话记录,包括会话ID、消息ID、消息发送人、消息接收人、消息发送时间、消息类型 | ● 结合展示组件,展示成员会话内容 ● 统计分析成员会话数据 |
2 | 会话展示组件 | 可使用展示组件展示群名称、会话内容 | ● 结合获取会话记录接口,展示成员会话内容 |
3 | 获取内部群消息 | 可获取企业内部群信息,包括群主、群成员、群创建时间、群成员入群时间 | ● 结合获取会话记录接口、会话展示组件,按群的维度展示群中会话内容和群信息 |
4 | 会话名称搜索 | 基于名称搜索群 | ● 用于搜索群,查看指定群名的群会话内容 |
5 | 会话消息搜索 | 基于名称搜索会话消息 | ● 用于搜索消息,查看指定内容对应的会话消息 |
6 | 关键词规则管理 | 可通过定义关键词、关键行为来定义一个关键词规则,命中规则的消息将回调通知 | ● 敏感会话内容、敏感行为预警相关功能 ● 基于特定内容、行为实现的产品功能 |
7 | 获取会话同意情况 | 获取成员客户的会话存档同意情况 | ● 基于成员客户会话存档同意情况实现的展示分析功能 |
8 | 会话情感分析 | 获取会话消息的情感状态(正中负) | ● 评估企业客户服务质量 |
9 | 客户同意会话存档回调事件 | 成员客户同意会话存档的事件通知 | ● 基于成员客户会话存档同意情况实现的展示分析功能 |
10 | 产生会话回调事件 | 新产生会话消息通知事件 | ● 产生新会话消息时去获取会话记录,避免无效请求 |
步骤说明:
1.2 参考 授权成功事件
1.3 参考设置公钥
2.3 参考 产生会话回调事件
2.4 参考获取会话记录
3.2 参考设置公钥
3.3 参考会话展示组件
1.会话内容存档第三方接口和企业内部接口的区别是什么?
答:1)调用主体差异:第三方接口的调用主体是第三方服务商,企业内部接口的调用主体是企业;2)接口实现差异:第三方接口不对外输出会话内容,服务商可通过会话展示组件展示会话内容,并使用配套分析接口进行内容分析,以实现相关产品功能。
2.会话内容存档第三方接口是否需要购买,如何购买?
答:会话内容存档第三方接口为服务商付费购买的增值接口,接口单独定价,详情请查看收费方案 。
3.会话内容存档企业内部接口的购买是否有调整?
答:暂无调整。
4.会话内容存档企业内部接口的调用是否有调整?
答:暂无调整。会话内容存档企业内部接口定位是企业主体调用,对于服务商应以第三方主体调用第三方接口。
5.调用会话内容存档第三方接口,与使用会话展示组件是同一个应用吗?
答:不是同一个应用。调用会话内容存档第三方接口需要使用“会话内容存档接口授权”进行调用,而会话展示组件需要使用第三方应用或代开发应用进行调用。
6.企业取消授权会话内容存档接口授权,再重新授权,在会话组件里还能展示原来的消息吗?
答:企业取消授权之后,存档的消息就会自动清除,故重新授权之后也不能再展示原来存档的消息。
如有其他问题,可咨询企业微信产品客服。