适用客户

场景	说明
场景一	不希望将客户的任何信息同步到帮我吧，但希望在帮我吧工作台能看到第三方系统里的客户信息
场景二	可以将客户的部分信息同步到帮我吧（如：公司名称、服务期限），但希望在帮我吧工作台能看到第三方系统里的其余信息
场景三	希望在帮我吧工作台看到第三方系统的客户信息（如：订单信息、物流信息等）

对接效果

下图中红框部分为信息页展示区域：

在线聊天：工作台侧边栏展示客户信息页

呼叫中心：通话时展示客户信息页

帮我吧客服端：远程服务时展示客户信息页

对接说明

要实现对接，第三方系统需提供信息页，帮我吧工作台会以 iframe 的形式加载该页面。

重要提示：帮我吧登录是 HTTPS 的，所以信息页建议支持 HTTPS，否则使用者需要每次手动将帮我吧登录切换成 HTTP。

对接步骤

开发信息页 — 按照本文档规范开发客户信息展示页面

部署信息页 — 将信息页存放到帮我吧可以访问的地址上

配置信息页 — 将信息页的地址配置到帮我吧后台（具体参考系统配置文档）

参数传递

帮我吧工作台根据客户来源不同分为四种方式，不同工作台有对应的用户标识。帮我吧默认将系统用户标识推送给信息页，工作台上也可设置其他字段推送给信息页。

1. IM（即时聊天）

系统默认用户标识

IM 来源的客户主要分为微信原生、微信 H5、网站三种，不同来源对应的系统用户标识不同：

标识字段	说明
`weChatId`	微信原生来的客户标识，即微信的 OpenID
`webChatId`	微信 H5 和网站来的客户标识，由帮我吧系统自动生成

可设置的其他推送字段

模式	可推送字段
2B 模式	公司和联系人的自定义字段
2C 模式	联系人的自定义字段

特殊参数

参数	说明
`custominfo`	第三方系统的用户身份标识，无需设置字段推送，默认已有。常用对接场景：第三方系统集成 IM 客户端时，将该标识传递给帮我吧，客服在帮我吧工作台上的扩展页面根据该标识显示客户信息

2. 远程

系统默认用户标识

标识字段	说明
帮我吧客户端的 9 位 ID	客户端安装时自动生成

特殊参数

参数	说明
`custominfo`	第三方系统的用户标识，无需设置字段推送，默认已有。常用对接场景：第三方系统集成帮我吧客户端时，将该标识传递给帮我吧，客服在帮我吧工作台上的扩展页面根据该标识显示客户信息

3. 呼叫中心

系统默认用户标识

标识字段	说明
联系人的系统字段"手机号码"	来电号码匹配的客户手机号

可设置的其他推送字段

模式	可推送字段
2B 模式	公司的系统字段"服务账号"、公司和联系人的自定义字段
2C 模式	联系人的自定义字段

4. 工单

系统默认用户标识

标识字段	说明
联系人的系统字段"手机号"	工单关联客户的手机号

可设置的其他推送字段

字段类型	说明
联系人的系统字段	"邮箱"
当前工单模板里的自定义字段	工单模板中配置的所有自定义字段

通用说明

数据格式: 参数通过 URL Query 参数传递给信息页

安全建议: 信息页建议支持 HTTPS，确保数据传输安全

身份验证: 信息页可根据传递的标识参数，向第三方系统请求客户详细信息

适用客户

适用客户#

对接效果#

对接说明#

对接步骤#

参数传递#

1. IM（即时聊天）#

系统默认用户标识#

可设置的其他推送字段#

特殊参数#

2. 远程#

系统默认用户标识#

特殊参数#

3. 呼叫中心#

系统默认用户标识#

可设置的其他推送字段#

4. 工单#

系统默认用户标识#

可设置的其他推送字段#

通用说明#

适用客户

对接效果

对接说明

对接步骤

参数传递

1. IM（即时聊天）

系统默认用户标识

可设置的其他推送字段

特殊参数

2. 远程

系统默认用户标识

特殊参数

3. 呼叫中心

系统默认用户标识

可设置的其他推送字段

4. 工单

系统默认用户标识

可设置的其他推送字段

通用说明