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平台，智齿以原生插件存在，点击路径 SDK_v1 (opens new window) 或 SDK_v6 (opens new window) 即可看到智齿提供的智齿客服 SDK 原生插件。

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

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

• 参数说明
  参见平台对接页面 (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');

• 方法说明

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

• 参数说明

参见平台对接页面 (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",
});

• 参数说明

参见平台对接页面 (opens new window)说明。

常见问题

智齿 iOS_SDK UI 源码 Git 下载地址： https://github.com/ZCSDK/sobotKit_UI_iOS (opens new window)。

常见问题解答：
请点击链接 (opens new window) 进入智能机器人输入您的问题。

智齿科技 SDK 收集使用个人信息说明

《智齿科技 SDK 收集使用个人信息说明》 (opens new window)