Flutter、DCloud、APICloud
# Flutter、DCloud、APICloud
—— 智齿客户 SDK 第三方多渠道(Flutter、DCloud、APICloud)对接。
# 文档介绍
智齿客服全面支持桌面网站、移动网站、微信、微博、APP 五种接入方式,只要 10 分钟就可以将智齿客服嵌入所有营销路径,各渠道用户反馈汇总至智齿客服平台统一轻松管理,企业客服效率提升 50% 以上。智齿客服 SDK 是以 Android 和 iOS 原生语言开发,作为移动端插件使用,能完美的适配各个版本和系统特性,同时具备优秀的使用体验。
考虑客户开发环境的不同,根据客户需要,智齿客服 SDK 提供了基于 Flutter、APICloud、DCloud 等平台的插件支持,能方便用户更便捷的集成智齿客户端产品。
- 注册方法如下:
使用管理员账号登陆智齿管理后台 (opens new window),在 桌面网站客服 - APP - 添加 APP 创建应用后可得到 app_key
用于配置。
【注意:本模块在 iOS 上支持最低版本为 9.0,Android 支持最低版本为 4.2。】
# 支持渠道使用说明
# ● Flutter
# 1. 渠道说明
在 Flutter平台,智齿以原生插件存在,点击路径https://pub.dev/packages/flutter_sobot (opens new window)即可看到智齿提供的智齿客服 SDK 原生插件。
【说明:Flutter 平台未提供独立的电商平台版本,如果需要使用,请联系售后转接给我们。】
# 2. 集成说明
- 添加依赖和导包:
flutter_sobot: ^(填写版本号)
//导包
import "package:flutter_sobot/sobotsdk.dart";
//实例化
final zhiChiSobot = SobotApi();
2
3
4
5
方法说明:
1、启动智齿客服 startZhiChi2、启动客户服务中心 openSobotHelpCenter
3、获取未读消息数 getUnReadMessage
4、注销会话 closeSobotChat
事例代码
//启动智齿客服
Future<void> startZhichi() async {
var params = {
'app_key': 'your appkey',
'partnerid': '123456789',
};
final result = await zhiChiSobot.startZhichi(params);
handleJson(result);
}
//启动客户服务中心
Future<void> openSobotHelpCenter() async {
var params = {
'app_key': 'your appkey',
'partnerid': '123456789',
};
final result = await zhiChiSobot.openSobotHelpCenter(params);
print(result);
}
// 获取未读消息数
Future getUnReadMessage() async {
var params = {'partnerid': '123456789'};
var result = await zhiChiSobot.getUnReadMessage(params);
print(result);
}
//注销会话
Future<void> closeSobotChat() async {
final result = await zhiChiSobot.closeSobotChat();
print(result);
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
- 参数说明
参见平台对接页面 (opens new window)说明。
# ● DCloud
# 1. 渠道说明
在 DCloud 平台,智齿以原生插件存在,在路径https://ext.dcloud.net.cn/search?q=智齿 (opens new window)即可看到智齿提供的 智齿客服 SDK (opens new window) 原生插件。
【说明:DCloud 平台未提供独立的电商平台版本,如果需要使用,请联系售后转接给我们。】
# 2. 集成说明
- 模块名称 zhiChi-SobotKit
实例化插件
const zhiChiSobot = uni.requireNativePlugin('zhiChi-SobotKit');
2
方法说明
1、启动智齿客服 startZhiChi
2、启动客户服务中心 openSobotHelpCenter
3、获取未读消息数 getUnReadMessage
4、注销会话 closeSobotChat
事例代码
const zhiChiSobot = uni.requireNativePlugin('zhiChi-SobotKit');
// 启动智齿客服
zhiChiSobot.startZhiChi({app_key:"1c1da2c0aad047d7ba1d14ecd18ae4f6",
partnerid:"123456789",
user_nick:"Your nickName"},result => {
//用户不在聊天页面,如果会话还没结束,可实时获取到最后一条消息和未读消息数;返回值{type:3,value:新消息内容,num:未读消息数,desc:描述}
const msg = JSON.stringify(result);
uni.showToast({
title: msg,
duration: 5000
});
});
// 启动客户服务中心
zhiChiSobot.openSobotHelpCenter({
app_key:"1c1da2c0aad047d7ba1d14ecd18ae4f6",
partnerid:"123456789",
user_nick:"Your nickName",
});
//获取未读消息数:
zhiChiSobot.getUnReadMessage({partnerid:"123456789"},result => {
//返回值{type:4,value:消息数:desc:描述}
const msg = JSON.stringify(result);
uni.showToast({
title: msg,
duration: 5000
});
});
zhiChiSobot.closeSobotChat();
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
- 参数说明
参见平台对接页面 (opens new window)说明.
# ● APICloud
# 1. 渠道说明
在 APICloud 平台,智齿以原生模块Store存在,在路径https://www.apicloud.com/mod_tags?tag=智齿客服 (opens new window)即可看到智齿提供的2个智齿客服SDK(电商版 (opens new window)和普通版 (opens new window))支持模块。
【说明:普通版本和电商版本具有相同的基础服务能力,不同在于电商版本具有多级的客户体系,使用时一定要根据实际支持的服务接入。】
# 2. 集成说明
模块名称
电商版本:zhiChiSobotMall
普通版本:zhiChiSobot方法说明
1.启动智齿客服 startZhiChiSobot(params)
2.获取未读消息数 getUnReadMessage(params)
3.主动结束会话 closeSobotChat(params)
4.启动智齿消息中心(咨询的商家列表) startZhiChiSobotMsgCenter(params)事例代码
var param = {
app_key:"f9caa813546b42c98d5f5701f6d1c30d",
partnerid:"Your userId",
user_nick:"Your nickName",
user_tels:"Your user phone",
user_emails:"Your email",
params:{"age":"18","uname":"智齿APICloud"},
groupid:"",
isShowTansfer:true,
titleFont:18.0,
backgroundColor:"#f0f0f0",
topViewTextColor:"#FFFFFF",
isCustomLinkClick:false,
};
function callBack(ret,err){
alert("ret.type="+ret.type+"\nvalue="+ret.value+"\nret.desc="+ret.desc);
}
var zhichi = api.require('zhiChiSobot');
// 启动智齿
zhichi.startZhiChiSobot(param,callBack);
// 获取未读消息数
zhiChiSobot.getUnReadMessage({
},function(ret){
alert("ret.type="+ret.type+"\nvalue="+ret.value+"\nret.desc="+ret.desc);
});
// 主动结束会话
zhiChiSobot.closeSobotChat({"isClosePush":true});
// 启动商家列表
zhiChiSobot.startZhiChiSobotMsgCenter({
userId:"00002",
customBannerColor:"#08b0b0",
socketStatusButtonBgColor:"#08b0b0",
});
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
- 参数说明
参见平台对接页面 (opens new window)说明。
# 常见问题
智齿 iOS_SDK UI 源码 Git 下载地址: https://github.com/ZCSDK/sobotKit_UI_iOS (opens new window)。
常见问题解答:
请点击链接 (opens new window) 进入智能机器人输入您的问题。