kf5sdk

来自于:逸创云客服立即使用

initKF5 showHelpCenter showRequestCreation showRequestList showChatView setCustomFields setTopBarColor

概述

kf5提供给开发者发送工单、查看工单列表、查看知识库等功能。本模块封装了kf5的相关接口,使用此模块需先注册kf5来获取appid和hostName。注册kf5:登录kf5官网( www.kf5.com )注册kf5账号,进入控制面板 - 系统设置 - 支持渠道 - 移动APP SDK中添加一个APP以获取appid,hostName为你注册的域名,例如:kf5.kf5.com。

initKF5

初始化kf5

initKF5({params}, callback(ret, err))

params

hostName:

  • 类型:字符串
  • 描述:注册后的域名

appId:

  • 类型:字符串
  • 描述:注册kf5后,从后台添加APP后获取

email:

  • 类型:字符串
  • 描述:(手机和邮箱,必须传其一)用户的邮箱

phone:

  • 类型:字符串
  • 描述:(手机和邮箱,必须传其一)用户的手机号

verifyUserType:

  • 类型:整型
  • 描述:(可选项)用户信息验证方式,只能传1(验证邮箱)或2(验证手机号),只有当邮箱和手机号同时传入时才生效,默认为1(验证邮箱)
  • 默认值:1/2

appName:

  • 类型:字符串
  • 描述:(可选项)应用名称
  • 默认值:iOSAPP/AndroidAPP

deviceToken:

  • 类型:字符串
  • 描述:(可选项)应用推送的deviceToken

userName:

  • 类型:字符串
  • 描述:(可选项)用户的昵称

callback(ret, err)

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. message"" //错误描述
  3. }

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. message"" //成功描述
  3. }

补充说明

使用此模块,必须先用initKF5进行初始化。手机和邮箱必须格式正确。

1.email和phone必须传其一,如果单独传入email或者phone,则verifyUserType无效;
2.如果email和phone都传入时以verifyPriorityType(用户信息验证方式)为主;

2.1 如果verifyUserType设置为1,则验证kf5系统中有没有该email,有则验证成功,并修改该用户的手机号(如果手机号已在系统中存在,将不会修改);
2.2 如果verifyUserType设置为2,则验证kf5系统中有没有该phone,有则验证成功;

2.2.1 如果该用户不存在email则添加该email(如果该email已在系统中存在,将不会添加);
2.2.1 如果该用户存在email,则email不能修改;

示例代码

  1. var param = {
  2. hostName : "xxx.kf5.com",
  3. appId : "xxxxxxx",
  4. email : "",
  5. phone : "",
  6. verifyUserType : 1,
  7. appName : "",
  8. deviceToken : "",
  9. userName : "",
  10. };
  11. var kf5 = api.require('kf5sdk');
  12. kf5.initKF5(param, callback);
  13. function callback(ret, err) {
  14. api.alert({
  15. msg: ret.message
  16. });
  17. }

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本

showHelpCenter

弹出kf5帮助文档页面

showHelpCenter({params})

params

type:

  • 类型:数字
  • 默认值:0
  • 描述:(可选项)显示帮助文档的方式,为0展示分区列表(默认),为1直接展示分区列表,为2直接展示所有分类列表,为3直接展示所有文档列表

示例代码

  1. var params = {
  2. type: 0
  3. };
  4. var kf5 = api.require('kf5sdk');
  5. kf5.showHelpCenter({ params });

补充说明

使用此接口,必须先使用initKF5进行初始化。

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本

showRequestCreation

弹出kf5反馈问题页面

showRequestCreation()

示例代码

  1. var kf5 = api.require('kf5sdk');
  2. kf5.showRequestCreation();

补充说明

使用此接口,必须先使用initKF5进行初始化。 使用此接口需添加相机、麦克风和照片的权限。

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本

showRequestList

弹出kf5查看反馈页面

showRequestList()

示例代码

  1. var kf5 = api.require('kf5sdk');
  2. kf5.showRequestList();

补充说明

使用此接口,必须先使用initKF5进行初始化。

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本

showChatView

弹出kf5即时交谈

showChatView({params})

params

metadata:

  • 类型:数组
  • 描述:(可选项)IM自定义信息

示例代码

  1. var params = {
  2. metadata : [
  3. {
  4. "name":"姓名",
  5. "value":"小明"
  6. },
  7. {
  8. "name":"性别",
  9. "value":"男"
  10. }
  11. ],
  12. };
  13. var kf5 = api.require('kf5sdk');
  14. kf5.showChatView(params);

补充说明

使用此接口,必须先使用initKF5进行初始化。 使用此接口需添加相机、麦克风和照片的权限。

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本

setCustomFields

设置工单自定义字段

setCustomFields({params})

params

custom_fields:

  • 类型:数组
  • 描述:工单自定义字段数组,每次提交工单时,都会将自定义字段添加到工单中

示例代码

  1. var params = {
  2. custom_fields : [{
  3. "name" : "fields_123",
  4. "value" : "iOS"
  5. }, {
  6. "name" : "fields_321",
  7. "value" : "测试应用"
  8. }]
  9. }
  10. var kf5 = api.require('kf5sdk');
  11. kf5.setCustomFields(params);

补充说明

使用此接口,需配合工单模块一起使用。工单自定义字段的key在kf5后台的设置工单自定义字段里获取。

可用性

iOS系统 Android系统(SDK10及以上)

可提供的2.7.1及更高版本

setTopBarColor

设置头部nav的颜色样式

setTopBarColor()

params

navColor:

  • 类型:字符串
  • 描述:(可选项)头部nav背景颜色
  • 默认值:#3E4245

textColor:

  • 类型:字符串
  • 描述:(可选项)头部nav TextView字体颜色
  • 默认值:#FFFFFF

centerTextSize:

  • 类型:整型
  • 描述:(可选项)头部Nav 中间Textview字体大小
  • 默认值:22

rightTextSize:

  • 类型:整型
  • 描述:(可选项)头部Nav 右侧TextView字体大小,iOS不可用
  • 默认值:20

centerTextVisible:

  • 类型:布尔型
  • 描述:(可选项)头部Nav中间TextView是否可见,iOS不可用
  • 默认值:true

rightTextVisible:

  • 类型:布尔型
  • 描述:(可选项)头部Nav右侧TextView是否可见
  • 默认值:true

示例代码

  1. var params = {
  2. navColor: "#3E4245",
  3. textColor: "#FFFFFF",
  4. centerTextSize: 22,
  5. rightTextSize: 20,
  6. centerTextVisible: true,
  7. rightTextVisible: true,
  8. };
  9. var kf5 = api.require('kf5sdk');
  10. kf5.setTopBarColor({ params });

补充说明

使用此接口,需配合其他接口一起使用。

可用性

iOS系统(iOS8以上) Android系统(SDK10及以上)

可提供的2.7.1及更高版本