PDF《V5 智能客服 iOS 客户端 SDK 接口》

V5 智能客服 iOS 客户端 SDK 接口 (Ver0.

2) V5 智能客服 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

1 目录・ V5 智能客服 iOS 客户端 SDK 接口.1

1 术语.1

2 功能说明.1

3 业务流程.1 业务结构.1 交互流程.2 SDK 工作流程

3 4 前期准备.3 开发环境准备.3 SDK 导入

4 4.2.1 SDK 文件夹导入.4 4.2.2 引入依赖库

4 Info.plist 配置

4 关于离线消息推送.5

5 使用 SDK 提供的 UI 快速集成

5 初始化 SDK

5 用户信息和参数设置.6 启动会话界面.6 生命周期处理.8 为消息添加自定义参数.9

6 使用 SDK 接口开发.10 初始化 SDK

10 用户信息和参数设置.10 开启消息服务.10 消息代理.10 消息接口调用.11 生命周期处理.12 查询会话消息.12

7 其他事项.13 V5 智能客服 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

2 版本更新.13 异常及枚举说明.13 V5 智能客服系 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

1 1 术语 应用账号:V5KF 网站后台 AppSDK 应用配置中的应用账号. 站点编号: V5KF网站的账号对应的站点编号 (可以在V5KF官网后台查看或向客服获取) . Demo 工程:使用智能客服系统 SDK 客户端开发的接口使用示例工程. 会话界面:针对使用本 SDK 的iOS APP 而言,表示进行对话的一个 UIViewController. deviceToken:推送平台用于标识设备的唯一 ID,长度为

64 字节以内的字符串. 用户 ID(uid):标识 APP 所登录的用户的唯一 ID,长度为

64 字节以内的字符串. 坐席:使用 V5 智能客服系统的客服人员.

2 功能说明 V5 智能客服系统客户端可集成到 web、APP 等第三方平台提供客户在线咨询服务,实 时接收客户的反馈. 支持发送文本、 位置、 图片以及表情等消息, 并可显示图文、 打开链接. 本文档介绍 V5 智能客服系统客户端 SDK 的iOS 版本的集成和使用.本SDK 兼容 iOS 7.0 以上,并为开发者提供 Demo 工程,可以参照 Demo,使用 SDK 提供的 UI 快速集成到你的 项目中;

对UI 有较高定制需求的开发者可根据 SDK 接口进行开发,自行开发界面.

3 业务流程 业务结构 图3-1 应用结构 V5 智能云服务 V5 客户端授权、 认 证服务 客户端 V5 智能客服系 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

2 ? V5 智能云服务 V5 智能云服务,是连接座席和访客的桥梁.并通过云智能机器人,提供替代、协助座 席进行优质客服的服务. ? V5 客户端授权、认证服务 分发访客接入 V5 智能云服务的凭据服务器. 交互流程 ? 客户端首先向 V5 客户端授权、认证服务发送认证信息(HTTP POST 请求方式) ,以 获取连接 V5 智能云服务的授权信息;

? 用认证成功返回的授权信息向 V5 智能云服务建立会话连接;

? 开启会话,进行即时消息对话. 图3-2 交互流程 客户端 V5 网页客户 授权、认证服务 V5 智能云服务 客户认证 返回会话服务器授权信息 会话消息 开始会话 V5 智能客服系 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

3 SDK 工作流程 图3-3 SDK 工作流程

4 前期准备 开发环境准备 1. V5KF 客服系统账号 没有 V5KF 账号需要前往官网注册账号. 2. 获得应用账号、站点编号 应用账号、 站点编号作为 SDK 连接服务端的身份凭证, 可到后台 App SDK 的应用配 置界面获取. 3. 填写对应平台的推送服务器地址 为了使您的 APP 在集成本 SDK 后具有离线消息推送,建议填写您的推送服务器地 开始 结束 设置用户信息,连接认证 初始化 SDK 是否认证成功 开启消息服务 Yes No 收发即时消息 用户退出 接收离线通知 设置离线推送? No Yes 点击通知 V5 智能客服系 iOS 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com