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

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

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

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

1 1 术语.1

2 功能说明.1

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

3 4 前期准备.3 4.1 开发环境准备.3 4.2 配置 AndroidManifest

4 4.3 了解离线消息推送.6

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

7 5.1 导入文件.7 5.2 初始化 SDK

8 5.3 消息推送设置.9 5.4 用户信息和参数设置.9 5.5 启动会话界面.10

6 使用 SDK 接口开发.10 6.1 导入 libs 库10 6.2 代码快速集成.10 6.2.1 初始化 SDK.10 6.2.2 开启消息服务

11 6.2.3 消息接口调用

11 6.2.4 生命周期处理

13 6.2.5 通知设置.13 6.2.6 用户信息设置

14 6.2.7 消息推送设置

14 6.2.8 查询会话消息

14 6.2.9 其他设置.15 V5 智能客服 Android 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

2 7 注意事项.15 7.1 代码混淆.15 7.2 发布提醒.16 7.3 版本更新.16

8 消息结构.16 8.1 异常消息.16 8.2 会话消息.17 V5 智能客服系统 Android 客户端 SDK 接口 深圳市智客网络科技有限公司 www.v5kf.com

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

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

64 字节以内的字符串.

2 功能说明 V5 智能客服系统客户端可集成到 web、APP 等第三方平台提供客户在线咨询服务,实 时接收客户的反馈. 支持发送文本、 位置、 图片以及表情等消息, 并可显示图文、 打开链接. 本文档介绍 V5 智能客服系统客户端 SDK 的Android 版本的集成和使用.本SDK 兼容 Android API

9 以上,并为开发者提供源码和 Demo 工程,可以参照 Demo,使用 SDK 提供的 UI 快速集成到你的项目中;

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

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

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

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

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

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

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