开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
视图容器
基础内容
表单组件
导航
媒体组件
画布
地图
开放组件
web-view
无障碍访问
页面属性配置节点
扩展组件
广告
开发 > 组件 > 开放组件 > contact-button 智能客服
贡献者
收藏
订阅更新
我的文档
设置
简介
智能客服能力由蚂蚁集团零号云客服提供。唤起智能客服组件,开通智能客服:进入对应小程序详情页 > 小程序信息 > 在线客服 即可打开云客服免费使用。详情可查看 智能客服
使用限制
版本要求基础库 1.14.1 或更高版本;支付宝客户端 10.1.10 或更高版本,若版本较低,建议做 兼容处理
native 渲染引擎:暂不支持。可以通过 my.caniuse('contact-button') 判断是否支持。
智能客服仅支持企业用户。
使用
示例代码
集成咨询窗(必选)
html
复制代码
<contact-button tnt-inst-id="企业编码" scene="聊天窗编码" />
在云客服中进入 设置 > 服务窗配置,点击操作栏中的 部署 ,获取 tntinstid(企业编码)和 scene(聊天窗编码)。
说明: 每个聊天窗编码都是唯一的。

自定义咨询按钮(可选)
默认咨询按钮如下:
修改后咨询按钮如下:

支付宝端内消息提醒(可选)
其中 alipay-card-no,ext-info 两个属性的说明详见下方的属性描述表格。
提醒一:打开支付宝,中间位置显示提示,点击即进入对话窗。按一定的频率进行消息提醒,默认 30 分钟提醒一次。

提醒二:服务提醒中显示客服回复的消息内容,点击即进入对话窗。

提醒三:朋友 > 小程序 > 我的 显示未读的客服消息,点击即进入对话窗。用户离开聊天窗期间客服发的消息会进行提醒。

接入访客名片
通过 java sdk 可以将零号云客服访客名片功能添加至支付宝小程序中,可查看
属性说明
属性
类型
描述
tnt-inst-id
string
必填。企业唯一编码,一个企业支付宝账号对应一个编码。
scene
string
必填。聊天窗编码,每个聊天窗的唯一编码。
size
number/string
选填。咨询按钮大小,正方形设置边长(如 25*25 px)。 默认值: 25 版本要求: 基础库 1.9.0
及以上、支付宝客户端 1.12.0
以及上支持 rpx 单位
color
string
选填。咨询按钮颜色,默认白底蓝色。 默认值: #00a3ff 版本要求: 基础库 1.9.0
及以上
icon
imgurl
选填。咨询按钮头像。 版本要求: 基础库 1.9.0
及以上
alipay-card-no
string
选填。支付宝访客用户 id(2088 开头)。 说明: 客服回答问题时,如客户已离开咨询窗口,则通过推送消息到支付宝 card 中提醒客户。
ext-info
string
选填。该属性主要用于传递一些扩展信息给组件,以实现一些高级功能。该属性值的生成方式为:encodeuricomponent({"字段名":"字段值"}), 其中,字段名和字段值要根据实际使用的功能进行替换。 目前通过传入扩展信息可支持的 3 个功能: 1.访客名片。需传 cinfo 和 key 两个扩展字段,代码形如在云客服中进入 设置 > 服务窗配置,点击操作栏中的 部署 ,获取 tntinstid
(企业编码)和 scene
(聊天窗编码)。encodeuricomponent({"cinfo":"生成的 cinfo","key":"生成的key"})
,cinfo 和 key 的值说明 支付宝小程序接入访客名片; 2.聊天窗默认带出用户的小程序订单数据。需传 appid 字段,代码形如encodeuricomponent({"appid":"商户小程序appid"})
3.未读客服消息同步至"我的小程序-我的"。同样需传 appid 字段,代码形如 encodeuricomponent({"appid":"商户小程序appid"})

常见问题
contact-button 组件写了没展示,如何查看聊天记录?
首先检查基础版本库是否匹配,然后在 支付宝 app > 朋友 > 服务提醒 中查看消息记录。
开通云客服没有加 contact-button 智能客服代码,为何有的手机上显示有的不显示客服图标?
进入 小程序控制台 > 设置 > 小程序信息 > 在线客服,选择是否显示客服图标。
如何获取 tntinstid(企业编码)和 scene(聊天窗编码)?
中进入 设置 > 服务窗配置,点击操作栏中的 部署 ,获取 tntinstid(企业编码)和 scene(聊天窗编码)。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图