=====高级对接=====
====对接效果====
**客户咨询端：**
\\
{{ :帮我吧文档:客户咨询端.png?nolink |}}
\\
**客服工作台：**
\\
有两种实现效果，分别如下：\\
1、帮我吧客户信息页根据第三方系统客户标识自动匹配客户信息
\\
{{ :帮我吧文档:客服工作台1.png?nolink |}}
\\
2、帮我吧工作台扩展页面自动匹配客户信息 
\\
\\
一般以下情况会用到此种展示方式：
  * 不希望将自身系统的客户档案同步到帮我吧，但又希望客服服务过程中可以看到客户信息。
  * 希望客服服务时可以看到自身系统的其他信息，比如购买记录、维修记录等。
{{ :帮我吧文档:客服工作台2.png?nolink |}}

====对接步骤====
以下根据客服端不同的实现效果分别进行详细说明。 \\
\\
**一、帮我吧自身客户信息页匹配客户信息**
\\
=== 对接的参数解析 ===


<wrap em>vendorID</wrap>：服务商id，查看路径如图：
{{:帮我吧文档:image_1.png?800|}}
{{:帮我吧文档:image_2.png?800|}}

<wrap em>authAccount</wrap>:第三方系统客户身份唯一识别码（接口对接联系人时使用），可由第三方系统设置规则，authAccount的值仅支持字母，数字，不支持特殊字符，中文等，且需要通过新建或者修改联系人接口将该值同步到帮我吧系统方可识别。

<wrap em>origin_account</wrap>：第三方账号（如果用authAccount对接联系人时，不要填写此参数），对接效果：
{{:帮我吧文档:image_3.png?800|}}

<wrap em>customSource</wrap>：自定义来源，对接效果：
{{:帮我吧文档:image_4.png?800|}}

<wrap em>customInfo</wrap>：给crm外部扩展弹窗时传递的参数，非必要参数

1、将第三方系统的客户档案同步至帮我吧。 \\
（1）帮我吧客户管理下的联系人添加“单行文本”类型的自定义字段，字段唯一标识需设置为“authAccount”。
{{ :帮我吧文档:添加联系人自定义字段.png?nolink |}}
{{:帮我吧文档:authAccount.png?nolink |}}

（2）通过[[帮我吧文档:数据接口:客户管理:联系人|联系人接口]]上传联系人至帮我吧客户管理，如果还需要公司，则继续调用公司相关接口。
\\

2、将帮我吧IM客户端集成到自身网站。 \\
请下载{{:帮我吧文档:bw8imdemo.zip|}}查看具体集成方式。\\
\\
如果采用链接的形式，可以自定义客服入口，通过动态修改访客的authAccount方式，假设用户咨询的聊天链接地址为:http://www.bangwo8.com/osp2016/im/pc/index.php?vendorID={vendorID}&uid=u6_{vendorID}_{authAccount}&customSource={customSource}&customInfo={customInfo},那么只需要动态修改authAccount即可,注意：authAccount的值仅支持字母，数字，不支持特殊字符，中文等。




第1和2步完成后，可直接进行试跑，如果传递给帮我吧IM客户端的客户标识已存在于帮我吧客户管理，则客服工作台上将自动匹配出联系人和公司信息。 \\
//调试小窍门：
如何确定客服工作台已收到第三方系统的客户标识？请看下图：
{{ :帮我吧文档:验证传值.png?nolink |}}

//


\\
**二、帮我吧工作台扩展页面匹配客户信息**
\\

1、开发扩展页，并将开发好的扩展页配置到帮我吧后台，确保帮我吧可以访问到。具体请参考[[帮我吧文档:crm接口:crm接口v2.0:开发向导]]。\\
2、将帮我吧IM客户端集成到自身网站。 \\
请下载{{:帮我吧文档:bw8imdemo.zip|}}查看具体集成方式。