zhiChi


概述

智齿客服全面支持桌面网站、移动网站、微信、微博、APP五种接入方式,只要10分钟就可以将智齿客服嵌入所有营销路径,各渠道用户反馈汇总至智齿客服平台统一轻松管理,企业客服效率提升50%以上。

zhiChi是一款实现手机用户与企业保持随时随刻沟通的客服工具。本模块封装了智齿客服的相关接口。使用此模块之前需要先注册智齿获取sysNum (enterpriseId)

图片说明

注册方法如下:

使用管理员账号登陆智齿管理后台,在 桌面网站客服 > 接入桌面网站 页面中即可得到 sysNum 用于配置。

注意:本模块在iOS上支持最低版本为7.0

方法:

回调方法:

  • callBack : 返回或点击链接回调(仅iOS适用)

startZhichi


启动智齿客服唯一方法。

    rd.zhiChi.startZhichi(param,callBack);
说明:

设置对应的启动参数和回调方法,param初始化信息相关参数定义为Json对象,适用于iOS和Android系统(特殊说明除外),callBack为执行某些操作时的监听。
sysNum为必选参数,其它无特殊说明均为可选参数。

参数:
  • sysNum: (String) 注册智齿后,从智齿后台获得的sysNum,不可为空
  • userId: (String) 描述:用户标识,自动备注客户资料时使用,(不做显示,仅作为统计标准),可为空(建议填写,对数据统计更准确,不填默认是设备唯一标识)
  • nickName: (String) 用户昵称,可为空(填写后,客服后台会同步到备注)
  • phone: (String) 用户电话,可为空
  • email: (String) 用户邮箱,可为空
  • customInfo: (Json) 自定义用户资料,自动同步到客户工作台(暂时未显示,后期会同步,有需要建议填写),可为空
  • isKeepSession: (Boolean) 是否保持会话,默认false,点击返回直接断开会话链接
  • isShowEvaluate: (Boolean)默认值:false,自定义关闭的时候是否推送满意度评价
  • isSettingSkillSet: (Boolean) 默认值:false,是否主动传递技能组 值为YES,SDK内部转接人工将不再弹出技能组选项
  • skillSetId: (String) 技能组编号,根据传递的值转接到对应的技能组;配合isSettingSkillSet使用,仅当值为YES时有效
  • goodsTitle: (String) 内容描述,如果要显示必须填写;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息
  • goodsSendText: (String)发送给客服的内容,如果要显示必须填写;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息
  • goodsImage: (String)图片URL(仅支持网络地址);自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息
  • themeColor(仅适用Android): (String) 默认值:#09aeb0,可设置头部颜色; 提交评价问题选中背景色以及提交评价按钮背景色; 聊天内容中,相似问题字体颜色和富文本类型中“阅读全文”字体颜色,可为空
  • isShowTansfer(仅适用iOS): (Boolean)默认值:true,机器人优先模式,是否直接显示转人工按钮(值为NO时,会在机器人无法回答时显示转人工按钮)
  • isCustomLinkClick(仅适用iOS): (Boolean) 默认值:false,自己处理消息中的链接,如果设置为1,将通过callBack返回到页面ret=1,value为link实际地址,desc为描述
  • backButtonTitle(仅适用iOS): (String)默认值:“关闭”返回按钮的文字
  • backButtonImage(仅适用iOS): (String)返回按钮的图片名称(项目的直接路径[UIImage imageNamed:图片名称]),可以与backButtonTitle同时存在
  • callBack: ( callBack ) (仅适用iOS平台)
返回值:

无返回值

示例:
var param = {
    sysNum:"4c349791a07b46c1a70b8ac88aa23257",
    userId:"Your userId",
    nickName:"Your nickName",
    phone:"Your user phone",
    email:"Your email",
    customInfo:{"商品编号":"goodsId","商品链接":"http://www.sobot.com","age":"18"},
    isKeepSession:false,
    isShowEvaluate:true,
    isSettingSkillSet:false,
    skillSetId:"",
    goodsTitle:"商品标题",
    goodsSendText:"发送的内容 http://www.sobot.com 可以点击",
    goodsImage:"http://gtb.baidu.com/HttpService/get?p=dHlwZT1pbWFnZS9qcGVnJm49dmlzJnQ9YWRpbWcmYz10YjppZyZyPTM2MzI4MTA4MCw0MjcwMDE0NjkAa38",
    isShowTansfer:true,
    titleFont:18.0,
    backgroundColor:"#f0f0f0",
    topViewTextColor:"#FFFFFF",
    isCustomLinkClick:false,
    backButtonTitle:"返回",
    backButtonImage:"SobotKit.bundle/ZCWebTitleBack_normal.png",
};


/**
 *
 * 返回时调用
 *
 * 点击链接isCustomLinkClick,仅值为true时有效,
 *
 ret.type 1、返回触发,2链接触发
 ret.value url路径或空字符串
 ret.desc 描述当前功能
 */
function callBack(ret){
    alert("ret.type="+ret.type+"\nvalue="+ret.value+"\nret.desc="+ret.desc);
}

// 测试启动方法
function testClick(){
    alert(param);
    rd.zhiChi.startZhichi(param,callBack);
}

callBack


操作成功时的回调函数。

 function callBack(){
     alert("ret.type="+ret.type+"\nvalue="+ret.value+"\nret.desc="+ret.desc);
 } 
说明:

点击链接isCustomLinkClick,仅值为true时有效
ret.type 1、返回触发,2点击链接触发
ret.value url路径或空字符串
ret.desc 描述当前功能