# 多平台(Flutter、DCloud、APICloud)对接

# 1 概述

智齿客服全面支持桌面网站、移动网站、微信、微博、APP五种接入方式，只要10分钟就可以将智齿客服嵌入所有营销路径，各渠道用户反馈汇总至智齿客服平台统一轻松管理，企业客服效率提升50%以上。智齿客服SDK是以Android和iOS原生语言开发，作为移动端插件使用，能完美的适配各个版本和系统特性，同时具备优秀的使用体验。

考虑市场开发需要，智齿客服SDK提供了基于Flutter、APICloud、DCloud等平台的插件支持，能方便用户更便捷的集成智齿客户端产品。

注册方法如下:

使用管理员账号登陆智齿管理后台，在 桌面网站客服 > APP >添加App 创建应用后可得到 app_key 用于配置。

注意：本模块在ios上支持最低版本为8.0，Android支持最低版本为4.2

# 2 支持平台

# 1.1 Flutter

# 1.1.1 平台说明

在Flutter平台，智齿以原生插件存在，点击路径https://pub.dev/packages/flutter_sobot即可看到智齿提供的智齿客服SDK原生插件。

【说明：Flutter平台未提供独立的电商平台版本，如果需要使用，请联系售后转接给我们。】

# 1.1.2 集成说明

# 添加依赖和导包

flutter_sobot: ^（填写版本号）
//导包
import "package:flutter_sobot/sobotsdk.dart";
//实例化
final zhiChiSobot = SobotApi();

# 方法说明

1、启动智齿客服 startZhiChi

2、启动客户服务中心 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);
  }

# 参数说明

参见平台对接页面说明

# 1.2 DCloud

# 1.2.1 平台说明

在DCloud平台，智齿以原生插件存在，在路径https://ext.dcloud.net.cn/search?q=智齿即可看到智齿提供的智齿客服SDK原生插件。

【说明：DCloud平台未提供独立的电商平台版本，如果需要使用，请联系售后转接给我们。】

# 1.2.2 集成说明

# 模块名称

zhiChi-SobotKit

实例化插件
const zhiChiSobot = uni.requireNativePlugin('zhiChi-SobotKit');

# 方法说明

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();

# 参数说明

参见平台对接页面说明

# 1.3 APICloud

# 1.3.1 平台说明

在APICloud平台，智齿以原生模块Store存在，在路径https://www.apicloud.com/mod_tags?tag=智齿客服即可看到智齿提供的2个智齿客服SDK(电商版和普通版)支持模块。

【说明：普通版本和电商版本具有相同的基础服务能力，不同在于电商版本具有多级的客户体系，使用时一定要根据实际支持的服务接入。】

# 1.3.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",
});

# 参数说明

参见平台对接页面说明

# 3 常见问题

常见问题解答：

请点击链接进入智能机器人输入您的问题