zhiChiSobot

来自于:智齿客服立即使用

startZhiChiSobot

概述

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

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

图片说明

注册方法如下:

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

注意:本模块在ios上支持最低版本为6.0

startZhiChiSobot

启动智齿客服

startZhiChiSobot(params)

params


初始化信息相关参数,适用于iOS和android系统(特殊说明除外)


appKey

  • 类型:字符串
  • 默认值:无
  • 描述:注册智齿后,从智齿后台获得的appKey,不可为空

receptionistId

  • 类型:字符串
  • 默认值:无
  • 描述:指定客服ID

tranReceptionistFlag:

  • 类型:字符串
  • 默认值:0
  • 描述:定指客服时转接类型,0 可转入其他客服 1 必须转入指定客服(注意:如果当前指定的客服不在线,选择之后不能在转接到其他客服)

robotId

  • 类型:字符串
  • 默认值:0
  • 描述:对接机器人ID (可以转接到对应的机器人)

userId

  • 类型:字符串
  • 默认值:无
  • 描述:用户标识,自动备注客户资料,可为空(建议填写,对数据统计更准确,不填默认是设备唯一标识)

nickName

  • 类型:字符串
  • 默认值:无
  • 描述:用户昵称,可为空(填写后,客服后台会同步到备注)

phone

  • 类型:字符串
  • 默认值:无
  • 描述:用户电话,可为空

email

  • 类型:字符串
  • 默认值:无
  • 描述:用户邮箱,可为空

qqNumber

  • 类型:字符串
  • 默认值:无
  • 描述:用户QQ,可为空

avatarUrl

  • 类型:字符串
  • 默认值:无
  • 描述:用户头像,可为空

sourceURL

  • 类型:字符串
  • 默认值:无
  • 描述:接入的来源URL,可为空

sourceTitle

  • 类型:字符串
  • 默认值:无
  • 描述:接入来源页面标题,可为空

serviceMode

  • 类型:int
  • 默认值:0
  • 描述:自定义接入模式,1只有机器人,2.仅人工 3.智能客服-机器人优先 4智能客服-人工客服优先,可为空

userRemark

  • 类型:字符串
  • 默认值:无
  • 描述:用户备注,可为空

customInfo

  • 类型:json串
  • 默认值:无
  • 描述:自定义用户资料,自动同步到客户工作台,可为空

skillSetId

  • 类型:字符串
  • 默认值:无
  • 描述:技能组编号,根据传递的值转接到对应的技能组,可选

skillSetName

  • 类型:字符串
  • 默认值:无
  • 描述:技能组名称,可选

goodsTitle

  • 类型:字符串
  • 默认值:无
  • 描述:内容描述,如果要显示必须填写;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息

goodsLabel

  • 类型:字符串
  • 默认值:无
  • 描述:内容标签,如果要显示价格、分类等

goodsDesc

  • 类型:字符串
  • 默认值:无
  • 描述:发送给客服的商品摘要,如果要显示必须填写;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息

goodsImage

  • 类型:字符串
  • 默认值:无
  • 描述:图片URL;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息

goodsFromUrl

  • 类型:字符串
  • 默认值:无
  • 描述:当前商品URL;自定义咨询内容,在转接人工成功时,方便用户发送自己咨询的信息

isCloseAfterEvaluation

  • 类型:boolean
  • 默认值:NO
  • 描述:评价完人工是否关闭会话,默认为NO。

isShowTansfer

  • 类型:boolean
  • 默认值:YES
  • 描述:机器人优先模式,是否直接显示转人工按钮(值为NO时,会在机器人无法回答时显示转人工按钮)

isOpenRecord

  • 类型:boolean
  • 默认值:YES
  • 描述:是否开启语音功能,默认开启。

isUseRobotVoice(仅适用于Android)

  • 类型:boolean
  • 默认值:false
  • 描述:是否使用机器人语音功能 默认false时机器人不可以使用语音功能。注意这是一个付费功能

artificialIntelligenceNum(仅适用于Android)

  • 类型:int
  • 默认值:0
  • 描述:未知问题或者向导问题出现 几次时,显示转人工按钮

titleImgId(仅适用Android)

  • 类型:int
  • 默认值:#09aeb0
  • 描述:设置头部为背景图片,可为空。 列:R.drawable.资源名称

themeColor(仅适用Android)

  • 类型:字符串
  • 默认值:#09aeb0
  • 描述:可设置头部颜色; 提交评价问题选中背景色以及提交评价按钮背景色; 聊天内容中,相似问题字体颜色和富文本类型中“阅读全文”字体颜色,可为空

customerFields(仅适用Android)

  • 类型:json串
  • 默认值:无 例:{"weixin":"55555","weibo":"66666","userSex":"女","birthday":"2017-05-17","cardNo":"142201198704102222"}
  • 描述:设置用户自定义字段.(自定义字段的key参考 www.sobot.com登录成功-->设置-->自定义字段-->客户字段-->查看显示ID就是这里的key)

customUserOutWord(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义用户超时下线提示语,默认为空。

customUserTipWord(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义用户超时提示语,默认为空。

customAdminTipWord(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义客服超时提示语,默认为空。

customRobotHelloWord(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义机器人欢迎语,默认为空。

customAdminNonelineTitle(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义客服不在线的说辞,默认为空。

customAdminHelloWord(仅适用iOS)

  • 类型:字符串
  • 默认值:无
  • 描述:自定义客服欢迎语,默认为空。

isCustomLinkClick(仅适用iOS)

  • 类型:boolean
  • 默认值:0
  • 描述:自己处理消息中的链接,如果设置为1,将通过callBack返回到页面ret=1,value为link实际地址,desc为描述

isSetPhotoLibraryBgImage(仅适用iOS)

  • 类型:boolean
  • 默认值:NO
  • 描述:是否设置相册背景图片

自定义字体,(所有参数可选,并且仅适用iOS)


titleFont:

  • 类型:CGFloat
  • 默认值:18.0
  • 描述:顶部标题颜色、评价标题,可为空

listTitleFont:

  • 类型:CGFloat
  • 默认值:16.0
  • 描述:页面返回按钮,输入框,评价提交按钮、Toast提示语,可为空

listDetailFont:

  • 类型:CGFloat
  • 默认值:14.0
  • 描述:各种按钮,网络提醒,可为空

listTimeFont:

  • 类型:CGFloat
  • 默认值:12.0
  • 描述:消息提醒(转人工、客服接待等),可为空

chatFont:

  • 类型:CGFloat
  • 默认值:15.0
  • 描述:聊天气泡中文字,可为空

voiceButtonFont:

  • 类型:CGFloat
  • 默认值:14.0
  • 描述:录音按钮的文字,可为空

自定义背景颜色,(所有参数可选,并且仅适用iOS)


backgroundColor:

  • 类型:字符串
  • 默认值:#f0f0f0
  • 描述:对话页面背景,可为空

customBannerColor:

  • 类型:字符串
  • 默认值:#08b0b0
  • 描述:顶部banner颜色值,可为空

leftChatColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:左侧气泡颜色,可为空

rightChatColor:

  • 类型:字符串
  • 默认值:#08b0b0
  • 描述:右边气泡颜色,可为空

backgroundBottomColor:

  • 类型:字符串
  • 默认值:#e6e9e9
  • 描述:底部工具栏的背景颜色,可为空

bottomLineColor:

  • 类型:字符串
  • 默认值:#e6e9e9
  • 描述:底部工具栏边框线颜色(输入框、录音按钮、分割线),可为空

BgTipAirBubblesColor:

  • 类型:字符串
  • 默认值:#cacacb
  • 描述:提示气泡的背景颜色,可为空

imagePickerColor:

  • 类型:字符串
  • 默认值:#2fb9c3
  • 描述:相册导航栏的颜色,可为空

imagePickerTitleColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:相册导航栏标题颜色,可为空

commentOtherButtonBgColor:

  • 类型:字符串
  • 默认值:#2fb9c3
  • 描述:评价普通按钮选中背景颜色和边框颜色,可为空

commentCommitButtonColor:

  • 类型:字符串
  • 默认值:#2fb9c3
  • 描述:评价(立即结束、取消)按钮文字颜色,可为空

commentCommitButtonBgHighColor:

  • 类型:字符串
  • 默认值:#089899
  • 描述:评价提交按钮背景颜色和边框颜色,可为空

自定义文字颜色,(所有参数可选,并且仅适用iOS)


submitEvaluationColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:提价评价按钮的文字颜色,可为空

topViewTextColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:顶部文字颜色(返回、标题),可为空

leftChatTextColor:

  • 类型:字符串
  • 默认值:#000000
  • 描述:左边聊天气泡文字颜色,可为空

rightChatTextColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:右边聊天气泡文字颜色,可为空

timeTextColor:

  • 类型:字符串
  • 默认值:#666f6f
  • 描述:聊天时间文字的颜色,可为空

tipLayerTextColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:提示气泡文字颜色,可为空

serviceNameTextColor:

  • 类型:字符串
  • 默认值:#67706e
  • 描述:客服昵称文字颜色,可为空

nickNameTextColor:

  • 类型:字符串
  • 默认值:#888888
  • 描述:提示cell中客服昵称文字颜色,可为空

chatLeftLinkColor:

  • 类型:字符串
  • 默认值:#2fb9c3
  • 描述:左边超链文字颜色,可为空

chatRightLinkColor:

  • 类型:字符串
  • 默认值:#0d81c0
  • 描述:右边超链文字颜色,可为空

notificationTopViewLabelColor:

  • 类型:字符串
  • 默认值:#ffffff
  • 描述:通告栏的文字颜色,可为空

notificationTopViewBgColor:

  • 类型:字符串
  • 默认值:#FFA500
  • 描述:通告栏的背景色,可为空

satisfactionSelectedBgColor:

  • 类型:字符串
  • 默认值:#2fb9c3
  • 描述:评价页面中 已解决 未解决 按钮的选中的背景色,可为空

satisfactionTextSelectedColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:评价页面中 已解决,未解决 按钮的 高亮状态的文字颜色,可为空

回调函数说明(仅适用iOS)


ret:

  • 类型:字典
  • 描述:包含3个参数

    type:1 返回,2 点击了消息内容链接(仅当isCustomLinkClick=1时触发)

    value:仅当type=2时,返回链接地址

    desc:当前操作

err:未使用

示例代码

var param = {
    appkey:"7f60287b4f5f411bb553802d3be83450",
    userId:"Your userId",
    nickName:"Your nickName",
    phone:"Your user phone",
    email:"Your email",
    customInfo:{"age":"18","uname":"智齿APICloud"},
    isShowEvaluate:true,
    isSettingSkillSet:false,
    skillSetId:"",
    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);

补充说明

使用此模块,必须先传入appkey参数,其它参数可根据自己实际情况选择设置;

可用性

iOS系统 Android系统

可提供的2.3.3版本