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(仅适用iOS)

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

avatarUrl(仅适用iOS)

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

sourceURL(仅适用iOS)

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

sourceTitle(仅适用iOS)

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

serviceMode(仅适用iOS)

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

userRemark(仅适用iOS)

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

customInfo(仅适用iOS)

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

skillSetId(仅适用iOS)

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

skillSetName(仅适用iOS)

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

goodsTitle(仅适用iOS)

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

goodsLabel(仅适用iOS)

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

goodsDesc(仅适用iOS)

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

goodsImage(仅适用iOS)

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

isOpenRecord(仅适用iOS)

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

themeColor(仅适用Android):

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

isShowTansfer(仅适用iOS):

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

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颜色值,可为空

socketStatusButtonBgColor:

  • 类型:字符串
  • 默认值:#08b0b0
  • 描述:网络状态中的背景色(连接中),可为空

socketStatusButtonTitleColor:

  • 类型:字符串
  • 默认值:#08b0b0
  • 描述:网络状态中的背景色(连接中),可为空

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
  • 描述:右边超链文字颜色,可为空

回调函数说明(仅适用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系统

可提供的1.0.0版本