考虑到用户会在企业的小程序里联系客服,为此支持在小程序里接入微信客服。微信小程序打开微信客服的功能已向非个人的全体小程序开放,小程序开发者在小程序管理后台处绑定同主体的微信客服(企业ID)后即可调用小程序相关接口,接入微信客服。
接入方式:https://developer.work.weixin.qq.com/document/path/94739、https://kf.weixin.qq.com/api/doc/path/94772
- 在微信客服管理后台获取对外的企业ID和客服链接。
- 在小程序管理后台的【功能】【客服】【微信客服】处,填写同一主体的微信客服对应的企业ID,完成小程序和微信客服的绑定。
- 调用「小程序打开微信客服」接口,完成接入。
注:仅可正常接入已在小程序管理后台绑定的企业ID下的微信客服
- 小程序管理后台-关联企业微信客服
注意:企业ID必须跟该小程序的企业主体一致;
在小程序中的接入流程:https://work.weixin.qq.com/nl/act/p/a733314375294bdd
详情如下:
- 登录企业微信管理后台-开启微信客服功能
参考:https://baijiahao.baidu.com/s?id=1735577920604728565&wfr=spider&for=pc、
https://blog.csdn.net/weixin_42065713/article/details/126137884?from_wecom=1
(1)登录【企业微信管理后台】选择【应用管理】【微信客服】,开启【微信客服】旁边的按钮;
注意:若需要后台对接客服信息的话需要开启“通过API管理微信客服”的,若不需要则不开启。
(2)然后在【客服账号】一栏点击【创建账号】来指定接待人员;创建客服账号时,企业管理员可以选择展示的视频号,设置接待人员、接待规则、接待上限、接待时间、智能回复、超时结束聊天等内容。
(3)选择【接入场景】
在这里我们选择【在微信内其他场景接入】,进入页面后点击【去接入】。企业管理员可以选择需要配置的客服账号,复制客服链接后可以配置到以下场景:在网页接入、在公众号菜单接入、在小程序接入、在搜一搜品牌官方区接入、点击微信支付凭证接入。接入后,客户点击客服入口即可发起咨询。
(4)可以在【服务工具】找到相应的配置设置客服的自动回复
- 在小程序中添加打开微信客服的点击事件,调用「wx.openCustomerServiceChat」接口完成接入。
export default {
methods: {
// 跳转微信客服
jumpToWeChatCustomerService() {
openWeChatCustomerService("https://work.weixin.qq.com/xxxxx", "wwed1ca4d3597eXXXX");
},
// 打开微信客服
openWeChatCustomerService (
weiXinCustomerServiceUrl = "",
corpId = "",
showMessageCard = false,
sendMessageTitle = "",
sendMessagePath = "",
sendMessageImg = ""
) {
if (!weiXinCustomerServiceUrl || !corpId)
return Toast("请配置好客服链接或者企业ID");
// eslint-disable-next-line no-undef
wx.openCustomerServiceChat({
// 客服信息
extInfo: {
url: weiXinCustomerServiceUrl, // 客服链接 https://work.weixin.qq.com/xxxxxxxx
},
corpId, // 企业ID wwed1ca4d3597eXXXX
showMessageCard, // 是否发送小程序气泡消息
sendMessageTitle, // 气泡消息标题
sendMessagePath, // 气泡消息小程序路径(一定要在小程序路径后面加上“.html”,如:pages/index/index.html)
sendMessageImg, // 气泡消息图片
success(res) {
console.log("success", JSON.stringify(res));
},
fail(err) {
console.log("fail", JSON.stringify(err));
// eslint-disable-next-line no-undef
return wx.showToast({
title: err.errMsg,
icon: "none"
});
},
});
},
},
}
- 常见错误:
(1)"fail" "{"errCode":1,"errMsg":"openCustomerServiceChat:fail invalid param: url"}"
原因是:属性extInfo拼错了。
解决方法:将extInfo属性名写对即可。
(2)sendMessagePath属性设置的小程序绝对路径后,在微信客服消息的气泡消息点击打开会提示“页面不存在”。
在小程序内正常访问路径如:“pages/index/index”是可以访问成功的,但如果在sendMessagePath属性设置该路径的话,在微信客服消息的气泡消息点击打开会提示“页面不存在”。
解决方法:在小程序文件路径后面加上“.html”即可,如“pages/index/index.html”或者“/pages/index/index.html”都可
这里可以绑定联合主体的企业微信么?
报错:errCode: 6, errMsg: "openCustomerServiceChat:fail not bind",是什么问题导致的呢,如何解决
project.config.json中的内容要改成"libVersion": "2.20.0"以上版本,否则版本过低可能也无法加载
这个气泡消息需要手动触发么?
因为绑定错误需要取消接入重新绑定,但无法取消成功,提示”已取消“但实际重新填写的新信息未被带入,也无法成功调用,请问如何处理?
似乎是不支持快捷跳回
您好,在小程序中引用企业微信客服,客人点击的时候是跳转回微信,还是直接 在小程序内就可以发消息。
我希望就可以小程序内直接开启聊天,
如果主体不一样,但是绑定到和企业微信同主体的开发者平台上,不知道行不行
uniapp中该怎么接呀