5.3 用户信息和参数设置

使用 SDK 提供的 UI 集成，需要在启动会话界面之前进行用户信息和参数配置。配置项如下:

//需要#import "V5ClientAgent.h"
//获得V5ClientAgent配置对象
V5Config *config = [V5ClientAgent shareClient].config;

//用户信息单次设置即生效，更新用户信息或者切换用户时需调用shouldUpdateUserInfo，设置用户信息前调用
//[config shouldUpdateUserInfo];

//设置用户信息，坐席端可查看
config.nickname = @"test-张三";
config.gender = 1; //性别:0-未知 1-男 2-女
config.avatar = @"头像URL"; //客户头像URL
config.vip = 2; //VIP等级

//openId:用户唯一ID,长度32字节以内,不同的openId消息记录单独保存,可透传到座席端提供给座席插件,替代v1.2.0之前版本的uid（uid不再使用）
//若您是旧版本SDK用户，只是想升级，为兼容旧版，避免客户信息改变可继续使用config.uid，可不用openId
config.openId = @"ios-user-id-for-test";
// 注：openId尽量不要携带特殊字符（$&+,/:;=?@%#[]以及空格之类的字符），若包含则会经过urlencode编码，客席插件收到这样的oid后要相应的解码处理(decodeURIComponent)

// 添加自定义用户信息NSDictionary,(仅在开启对话页面前设置生效)
config.userInfo = @{@"商品名称": @"牛仔裤",
                  @"商品价格": @"¥168.00"};

// [1.3.8新增]设置V5系统内置的客户基本信息，区别于userInfo，这里设置的是V5系统内置字段
// 支持字段：country,province,city,language(上面的nickname,gender,avatar,vip也可在此设置)
config.baseInfo = @{@"country": @"中国",
              @"province": @"广东",
              @"city": @"深圳",
              @"language": @"zh-cn"};

当 nickname、openId、avatar、device_token 等配置项配置完，下次需要修改(如App内切换了登录账号，修改了客户昵称或头像时)并向座席更新时需要在设置新信息前调用 [config shouldUpdateUserInfo]，这样才会向服务端更新这几个配置项。同样若想更新站点信息，需要在onChatActivityConnect中调用 [[V5ClientAgent shareClient] updateSiteInfo]。客户信息、站点信息（包含机器人信息和转人工开场白等V5后台可设置的信息）的更新存在缓存策略，系统每隔7天更新，一般无需处理，需要即时更新时方才调用此处接口。

指定人工客服或分组设置方式：

/*
 * 连接建立后才可以调用下面接口，以下是两种转人工情况示例（在onClientViewConnect回调中执行，参考：5.5 对话界面代理）
 */
// 【转】指定人工客服（调用时立即转），参数: 客服组id,客服id （以下数字仅作为示例，具体ID请前往V5后台查看客服信息）
[[V5ClientAgent shareClient] humanServiceOfGroupId:0 workerId:114052];
// 【指定人工客服】点击转人工按钮或者问题触发转人工时会转到指定人工，参数"0 132916"中两个数字先后对应需要转的客服组ID和客服ID
[[V5ClientAgent shareClient] sendMessage:[[V5ControlMessage alloc] initWithCode:4 argc:2 argv:@"0 114052"]];