跨平台应用开发进阶 (四十五)uni-app 集成企微客服实战

作者：No Silver Bullet

2023-04-15
上海
本文字数：925 字
阅读完需：约 3 分钟

一、前言

应用运营过程中，考虑接入企业微信客服功能，大致看了下官方接入文档，并不困难，引入代码量也不大。按照手册来操作即可。

二、功能实现

2.1 环境准备

在接入企微客服前，需要启用微信客服，并添加客服账号，并在企微管理后台将 APP 信息、企业信息、企微客服关联起来。

第一步：登录微信开放平台，在「管理中心-应用详情」中查看并复制对应的AppID。

第二步：登录企业微信管理后台，在「应用管理-应用-微信客服-在微信外接入-关联 App」处，填写AppID，关联已在微信开放平台审核通过的同主体 App。

备注⚠️：一个 AppID 暂仅可同时被 15 家同主体的微信客服关联，关联后才可正常跳转微信并打开微信客服。

第三步：进入「我的企业」，在企业信息处复制企业 ID。

第四步：进入「应用管理-应用-微信客服」，选择接入场景为「在微信外接入」。选择需要在 App 中接入的客服帐号，并复制对应的客服链接。

第五步：参照 2.2 小结，在 App 中接入调起企微客服逻辑。

第六步：用户在 App 中点击即可自动跳转微信并打开对应的微信客服会话，向客服发起咨询。

注⚠️：如果你想在其他企业的 App 中接入你的微信客服，可授权安装该企业创建的第三方应用。安装后，该应用关联的 App，即可接入你的微信客服。

2.2 代码层面

APP 调起企微客服代码如下：

// #ifndef APP-PLUSuni.showToast({  title: '请在app打开',icon:"none"});// #endiflet wechat = nullplus.share.getServices(res => { wechat = res.find(i => i.id === 'weixin')  if (wechat) {    wechat.openCustomerServiceChat({      corpid: 'ww1576eb419421ba30',//企业ID      url: 'https://work.weixin.qq.com/kfid/kfc8dw2f91c9ab6e60',//客服地址    }, src => {      console.log("success:", JSON.stringify(src))    }, err => {      console.log("error:", JSON.stringify(err))    })  } else {    uni.showToast({      title: '当前环境不支持微信操作',icon:"error"    });  }}, function() {  uni.showToast({    title: "获取服务失败，不支持该操作。" + JSON.stringify(e),    icon: 'none'  })});