1、介绍

版本： V1.0.0

YoukeSDK帮助您快速构建客服系统。
主要实现功能：

• 即时沟通
• 提交工单
• 数据分析
• 触碰营销
• FAQ功能
• 更换皮肤

### 2、集成方法

2.1 安装方式一：通过cocoapods安装：

pod 'YoukeSDK'

2.2 安装方式二：下载 iOS SDK ，解压缩后得到 YoukeSDK 文件夹，把 YoukeSDK 文件夹拖入Xcode项目工程中。
2.3 在Xcode的Build Settings>Other Linker Flags>添加-ObjC。
2.4 Xcode切换到Build Phases选项卡，选择Link Binary With Libraries，点击+号，导入以下链接库：

libresolv.dylib  
libsqlite3.dylib  
libxml2.dylib

2.5 在appdelegate里导入YoukeSDK.h

#import "YoukeSDK.h"

2.6 获取Appkey，进入YoukeSDK后台，注册账号并登录，登录后在左边菜单中选择 开发者>AppKey> 复制企业APPKEY

2.7 在didFinishLaunchingWithOptions中加入以下代码，将“企业APPKEY”改成上一步得到的APPKEY，集成完成。 ```objective-c //注册有客 [YoukeSDK registerYouKeWithAppKey:@"企业APPKEY"]; ```
### 3、实现客服功能（即时沟通） 在需要实现客服聊天功能的地方（如按钮点击事件）中加入以下代码，即可跳转到客服聊天界面，客服列表中的客服人员，需在[YoukeSDK](http://t.youkesdk.com/)后台添加。 ```objective-c //跳转到客服聊天界面 [YoukeSDK contactCustomServiceWithViewController:self]; ``` 

4、工单提交与处理

当调用

[YoukeSDK contactCustomServiceWithViewController:self]

方法时正巧没有客服在线，会自动跳转到工单提交界面，用户提交的工单会自动分配给各个客服处理：

 
### 5、实现数据分析

5.1 在商品详情页加入记录商品信息的代码，此处商品信息为必传，用于将用户访问的商品信息传到客服后台，方便客服了解用户当前正在浏览的商品，以及对用户访问的商品信息进行统计和数据分析功能；用户信息可传可不传。

/**
 *  提交商品及用户信息
 *
 *  @param goodsId      商品id
 *  @param goodsTitle   商品标题
 *  @param goodsPrice   商品价格
 *  @param goodsImg     商品图片
 *  @param userName     用户昵称（app账号体系内的用户昵称）
 *  @param userPhoto    用户头像（app账号体系内的用户头像）
 *  @param callNumber   电话号码（app账号体系内的电话号码）
 *  @param email        Email（app账号体系内的Email）
 *  @param qq           QQ号（app账号体系内的QQ号）
 *  @param text         备注信息
 */
[YoukeSDK visitGoodsWithGoodsId:goodsId
                     GoodsTitle:goodsName
                     GoodsPrice:goodsPrice
                       GoodsImg:goodsImage
                       UserName:nil
                      UserPhoto:nil
                     CallNumber:nil
                          Email:nil
                             QQ:nil
                           Text:nil];    

5.2 在商品详情页的viewWillDisappear中加入以下代码，此步骤为了记录用户离开商品页面的时间、记录访问商品时长、进行数据统计和分析。

- (void)viewWillDisappear:(BOOL)animated{
     [YoukeSDK leaveGoods];
}

### 6、触碰营销功能 在后台触碰营销菜单进行相关设置，比如设置：在商品详情页停留1分钟或查看该商品10次以上，触发该计划。当用户浏览商品时间或次数达到该要求时，就会显示在创意管理中添加好的“优惠券”信息：  

### 7、FAQ功能（在线问答） 请在[YoukeSDK](http://t.youkesdk.com/)后台添加问题分类和问题以及答案。在需要打开FAQ界面的地方（如按钮点击事件）添加以下代码，即可实现在线问答功能。 ```objective-c //跳转到FAQ界面 [YoukeSDK openHelpViewControllerWithViewController:self]; ```  
### 8、更换皮肤 更换皮肤功能主要用于修改导航栏颜色、导航文字的颜色，修改聊天气泡颜色、聊天文字颜色。修改方法是替换skin.plist中对应的value：

MessageBubbleBackgroundColorFromOther //聊天气泡背景色（他人）
MessageBubbleBackgroundColorFromMe //聊天气泡背景色（我的）
MessageBubbleTextColorFromOther //聊天文字颜色（他人）
MessageBubbleTextColorFromMe  //聊天文字颜色（我的）
NavigationTitleColor  //导航栏文字颜色
NavigationBackgroundColor  //导航栏背景色