“客户资料接口”是为增强客服能力，对有自建客户系统，同时又具备一定开发对接能力的用户，提供的对接接口。完成对接后，可以在微友助手后台显示用户在您的客户管理系统中的用户信息，如订单，历史服务记录等等。 ## 查询接口 查询接口是通过微信公众平台unionid去你方的客户系统查询具体的客户信息。返回结果显示在聚合聊天的“客户画像”选项卡里。 **查询接口配置方法：** **1. 管理员账号在应用市场-API对接中填写你方的查询地址**   配置好后，我们会带上用户微信公众平台unionid和mobile，及其他相关参数信息，向企业所填写的查询地址通过查询接口获取具体的客户信息。 具体参数如下： | 参数名 |说明| 备注 | | --- | --- | --- | | unionid | 微信公众平台unionid | 微信联系人对应的唯一身份标识 | | mobile | 用户的客户画像的手机号信息 | timestamp | 请求时间戳 | 可以对时间做一个校验，降低重放攻击 | | nonce | 长度16的随机数（字母+数字） | 增加签名结果的随机性 | | sign | 签名 | 详情见「关于签名」 | **2. 查询结果输出参数要求** 如果客户系统查询到相关客户信息，请您按一下参数要求输出返回JSON的形式数据： ``` { "errcode":0, "data":{ crm_info: [ { "label":"手机号", "value":"13100000000" , "value_color":"red" }, { "label":"购买数", "value":"5" } ] } } ``` **返回参数说明：** data里的每一个对象，都是一组用户信息，label表示标题，value表示具体的客户信息。value_color（可选返回值）表示value显示颜色，支持颜色值：red、green、blue、geekblue。  errcode为-100的时候，表示用户未绑定，会展示下图页面,其它非0值表示获取用户信息失败 <br> <br> ## 如何绑定unionid？ [如何绑定unionid](https://www.kancloud.cn/weiyoubot/weiyouzhushou/2312568) ## 如何看到mobile？   ## 关于签名 为了接口合法使用，我们对接口调用进行了鉴权。在设置界面完善信息后，我们系统会生成一串随机码，即密钥（SecretKey）。在调用贵司接口的时候，我们服务端会根据SecretKey，计算出签名值，即sign，具体算法如下： 所有发送的数据为集合M，集合M中添加secret= SecretKey (客户资料对接界面显示的secretKey)，将集合M内参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA，并对stringA进行sha256运算，再将得到的字符串所有字符转换为大写，得到sign值signValue