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

代码示例

html复制
<button
  open-type="im"
  data-im-id="{{ imId }}"
  bindim="imCallback"
  binderror="onimError"
>
  跳转 IM
</button>

js复制
Page({
  data: {
    imId: "客服的抖音号",
  },
  imCallback(e) {
    console.log("跳转IM客服成功", e.detail);
  },
  onimError(e) {
    console.log("拉起IM客服失败", e.detail);
  },
});