介绍

• 这里提供的功能，帮助客服平台搭建的更加完整，你可以选择性集成
• 如果您对客服平台接入不清楚，可以参考客服平台快速集成
• 请先务必下载千牛这个版本，千牛这个版本，千牛这个版本
• 用户信息定制提供两种方式：
  方式一：同步数据给OpenIM服务器。支持的用户字段包含自定义昵称、头像、订单状态、会员等级等，具体见下表。
  方式二：不同步数据给OpenIM服务器，提供独立的http服务，千牛端会在合适的时机调用。支持的用户字段包含自定义昵称、头像、订单状态、会员等级等，具体见下表。

现状

目前因为openim用户的userid是md5后的，在千牛端（客服）无法很好的获知这个用户的昵称，头像，订单状态，会员等级等，导致客服效率下降。

定制化后视觉

客服可以在接入列表看到用户的昵称，头像，订单状态，会员等级等。

客服可以在官方足迹插件看到用户更加详细的信息，例如年龄，手机等，同时允许客服修改用户信息，例如年龄等。

解决方式一：同步数据给OpenIM服务器

所有OpenIM账号信息是开发者导入到OpenIM服务器，OpenIM服务器保存了用户的登录信息（用户名和密码的hash值），开发者在账号导入同时可以导入用户头像、昵称、年龄等。如何维护IM账号

客服在足迹插件修改用户信息时，千牛会自动保存到OpenIM服务器，不需要集成方做开发。

解决方式二：不同步数据给OpenIM服务器

在TOP开发后台，开发者可以设置一个http服务url，该http服务可以自主选择提供的服务种类，具体见http服务接口协议。
此处包含getprofile和setprofile
getprofile请求的参数和返回格式约定如下：

request格式：

{
    "userids":["u1","u2",...],//userids 数组
    "fields":["nickname","avatar","trade","vip",...] //用户信息字段
}
fields字段如下表格，千牛会在打开用户会话和打开足迹插件时拼装不同的fields字段到集成方，集成方根据自己的业务场景选择需要实现的fields信息。

response格式：

{
    "users": [
    {
        "userid": "u1",
        "nickname": "nn",
        "avatar": "www.a.com/a/a.jpg",//长宽随意
        "trade": {//交易
            "status":"done" //订单状态，同一个订单状态对应的图片在一个登陆期间只下载一次
            "text": "",//订单状态文案
            "time": "2015-06-03 12:12:50",//订单时间
            "tradepic": "www.a.com/trade/b.jpg"//订单状态图片url 16*16
        },
        "vip": {//会员等级
            "level":"v1", //会员等级
            "text": "tttt",//会员等级文案
            "vippic": "www.a.com/vip/c.jpg"//会员等级图片url? 16*16
        },
        ...
    },
   {
        ...
   }
   ]
}

客服在足迹插件修改用户信息时会调用setprofile接口，接口约定如下：
request格式

{
    "userid": "nn",
    "profile":
    {
        "name": "",
        "gender": "",
        "nickname": "",
        "age": 7,
        ...
    }
}

response格式

{
    "code": 200,
    "desc": "" //返回描述，例如错误描述
}

用户信息字段

extra格式：

{"k1":"v1","k2":"v2",...}

vip格式（会员等级）：

{
   "orderindex": 0,//排序值
   "level":"v1", //会员等级
   "text": "tttt",//会员等级文案
   "vippic": "www.a.com/vip/c.jpg"//会员等级图片url
}

trade格式（订单状态）：

{
     "status":"done" //订单状态，同一个订单状态对应的图片在一个登陆期间只下载一次
     "text": "",//订单状态文案
     "time": "2015-06-03 12:12:50",//订单时间
     "tradepic": "www.a.com/trade/b.jpg"//订单状态图片url 16*16
}

常见问题

用户信息没有展现
1.如果在开发者后台填充了http的服务链接和勾选getprofile服务，千牛优先调用开发者后台服务展现profile。如果你使用导入profile到OpenIM服务器的方案，请不要勾选getprofile服务。
2.客服端（千牛）会根据实际的业务场景，拼装不同的fields字段来访问开发者服务，请保证服务的可用性。
3.使用fiddler抓包确定开发者服务是否有被调用到，是否有返回如文档的response格式。


足迹插件上用户信息不能编辑
1.如果你实现了getprofile的服务，请也尽可能实现setprofile服务，保证客服做的编辑结果能正常的保存到开发者的服务器。
2.如果你不实现getprofile服务，请也不要实现setprofile服务，保证所有的profile数据的获取和修改到同步到OpenIM服务器。


VIP图片，订单图片显示不完全
1.请使用16*16的图片

FAQ