button组件bytehi客服能力
收藏
我的收藏

基础库 3.1.0 开始支持本能力。支持小程序拉起byteHi客服能力,需要将 button 组件 open-type 的值设置为 byteHi。
button 组件常规属性请参考button 按钮
小程序类目需要为IT科技 - IT科技 - 电信业务代理商 / 基础电信运营商 / 虚拟运营商及代理商。请至抖音开放平台 -> 控制台 -> 设置 -> 基础设置 -> 小程序服务类目查看。
使用前,开发者需登录控制台,在小程序应用中筛选消息及客服,开启小程序商家客服

属性说明

属性名
类型
默认值
必填
说明
最低支持版本
open-type
string
用于调用开放能力,此场景下需要设置为 "byteHi"
3.1.0
bindbytehi
EventHandle
监听跳转回调
3.1.0

商品卡片的额外参数

属性名
类型
默认值
必填
说明
最低支持版本
data-im-type
string
IM卡片类型,商品卡片时的固定填写 "goods"
3.1.0
data-goods-id
string
商品的id,仅支持泛知识课程库和生活服务商品库中的商品,可参考商品上架接口
3.1.0
data-biz-line
string
商品类型,“1”代表生活服务,“2”代表泛知识。
3.1.0

订单卡片的额外参数

属性名
类型
默认值
必填
说明
最低支持版本
data-im-type
string
IM卡片类型,订单卡片时的固定填写 "order"
3.1.0
data-order-id
string
订单的id,仅支持交易2.0订单,可参考预下单接口
3.1.0

bindbytehi 事件对象的 detail

object 类型,属性如下:
属性名
类型
说明
最低支持版本
errMsg
string
错误描述
3.1.0
errNo
number
错误码
3.1.0
回调成功
Object 类型,属性如下:
参数
参数类型
说明
errMsg
string
跳转成功信息,恒为'byteHi:ok'
errNo
number
恒为0
回调失败
Object 类型, 属性如下:
参数
参数类型
说明
errMsg
string
跳转失败信息,以'byteHi:fail'开头
errNo
number
错误代码
错误说明:
errNo
errMsg
说明
最低支持版本
21100
service error : %s , code = %s
透传服务端错误具体见错误信息
3.1.0
21101
Internal error , code = %s
内部错误
3.1.0
21102
host cannot open schema failInfo: %s, schema = %s
宿主无法打开客服页schema
3.1.0

代码示例

<button open-type="byteHi" bindbytehi="eventHandler" > 跳转byteHi客服页 </button>
Page({ eventHandler(e) { if (e.detail.errNo) { console.log("跳转byteHi客服页失败", e.detail); } else { console.log("跳转byteHi客服页成功"); } }, });

Bug & Tip