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

基础库 2.68.0 开始支持本能力。支持小程序拉起 IM 客服能力,需要将 button 组件 open-type 的值设置为 im,详见抖音 IM 客服
button 组件常规属性请参考 button 按钮

属性说明

属性名
类型
默认值
必填
说明
最低支持版本
open-type
string
用于调用开放能力,此场景下需要设置为 "im"
2.68.0
data-im-id
string
客服的抖音号,详见接入指南
2.68.0
bindim
EventHandle
监听跳转IM的成功回调
2.68.0
binderror
EventHandle
监听跳转IM的失败回调
2.68.0

商品卡片的额外参数

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

订单卡片的额外参数

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

代码示例

<button open-type="im" data-im-id="{{ imId }}" bindim="imCallback" binderror="onimError" > 跳转 IM </button>
Page({ data: { imId: "客服的抖音号", }, imCallback(e) { console.log("跳转IM客服成功", e.detail); }, onimError(e) { console.log("拉起IM客服失败", e.detail); }, });

Bug & Tip