高级对接

对于集成IM客户端的网页，如果您希望用户咨询时，能携带业务参数，如：来源、用户身份等信息，就需要额外对接。

这里以用户身份识别为例，对于用户身份识别有两种方式，

一种是通过接口预先导入到帮我吧系统，进线使用帮我吧的联系人识别逻辑，展示联系人的相关信息，实现效果如图：

另一种，如果不导入联系人资料的话，就需要使用 4.11 外部扩展集成的方式，创建工作台组件，通过外部扩展页面来展示用户信息，帮我吧只负责收集参数，并完整传递给外部扩展链接，识别逻辑由外部系统来实现。实现效果如图：

使用组件对接业务信息

您需要在集成im客户端sdk的网页上，将业务相关参数放在一个id标识为 bw8-third-party 固定元素上，使用data-thirdparty='{"key":"value"}'，将所有要传递的参数都放在其中，用户点击咨询按钮时，会获取相关参数，拼到进线链接上，用于系统识别或传递给外部扩展链接。如：

<span style="display: none" id="bw8-third-party" data-thirdparty='{"vendorID":"18","field_key":"authAccount","field_value":"894433","customInfo":""}'></span>

使用URL对接业务信息

您只需将业务参数和值，追加在IM进线链接上即可，如果开启了签名校验，需要按照签名规则进行签名。

帮我吧 IM 客户端动态签名规则说明

注意：此规则仅当后台开启"客户端动态签名"选项时才生效。

1. URL 必传参数

参数名	说明
`signature`	签名 Token
`timestamp`	13 位时间戳
`nonce`	随机数

2. 签名规则说明

对除 signature 外的全部参数进行签名

签名步骤：先字典升序，后 Hash

sha1(private_key, timestamp, nonce, param1...)

参数	说明
`private_key`	密钥（在后台设置中生成和重置）
`timestamp`	时间戳，1 小时内有效
`nonce`	随机数
`param1...`	其余参数根据实际需要传递

重要：中文参数使用 UTF-8 编码，必须 URL Encode

3. 签名代码示例

① PHP 版本

② Java 版本

4. 最终生成的带签名 URL 链接示例

https://www.bangwo8.com/osp2016/im/pc/index.php?vendorID=128789&uid=u6_128789_1234567890&timestamp=1566385123983&nonce=862739&signature=588370c3a10858fde89e16cc26ea775e0f87129c

关键要点总结

项目	说明
签名算法	SHA1
参数排序	按值字典升序（SORT_STRING）
时间戳精度	13 位毫秒级时间戳
时间戳有效期	1 小时
编码要求	UTF-8，中文必须 URL Encode
必传参数	`private_key`、`timestamp`、`nonce` + 业务参数
UID 格式	`u6_{vendorID}_{第三方系统账号}`（API 方式对接时）

使用组件对接业务信息#

使用URL对接业务信息#

帮我吧 IM 客户端动态签名规则说明#

1. URL 必传参数#

2. 签名规则说明#

3. 签名代码示例#

① PHP 版本#

② Java 版本#

4. 最终生成的带签名 URL 链接示例#

关键要点总结#