企业微信H5应用相关知识点汇总(入门向)

以下内容如果没有实际开发过可能会看不懂 没关系 当你开发后遇到问题再回过头看看 可能会对你有所帮助
官方文档 请认真阅读官方文档. 本文只做些许补充 主要以记录为主
前提摘要: 文中提及的 微信指的是我们正常使用 绿色logo的 微信客户端
企微指的是白色logo的 企业微信客户端

1.jsapi_ticket

jsapi_ticket作为后端生成签名的参数 后端开发文档分为企业的和应用的两种
wx.config 是使用企业的
wx.agentConfig是使用应用的
后端需要出2个接口提供给前端使用


2.jweixin的版本号

官方文档中
微信环境的版本号是1.6.0 企微的版本号是1.2.0
虽然我没找到有何不同 但是最好是按照文档的要求去使用 官方文档只提供了script标签引入的方法
可以npm 安装依赖包 引入使用
1.6.0的使用weixin-js-sdk
1.2.0 的使用weixin-jweixin


3.签名算法验证工具

微信 JS 接口签名校验工具
上面链接为测试wx.config中签名的工具 如果wx.config返回错误 可以自行检查wx.config的参数是否正确
反之也可以测试wx.agentConfig
应用的签名校验工具 <<<这个我本人没测试过 后端提供给我的


4.应用管理 配置文件

当你需要使用wx相关api的时候,需要配置白名单域名 否则无法使用

(每次都要发测试环境去开发代码.基本都属于盲写阶段 对git提交非常不友好 后面会提及)
如果有大佬知道如何开发环境联调 烦请留言 谢谢.


首先可以通过企微pc端左上角(点击头像->管理企业)
跳转到网页地址后 点击应用管理 ->选择自建的应用->开发者接口 配置可信域名 不需要二级路径和协议名 并且联系运维在根路径放置配置文件

5.API调用

企微api相关使用 目前是直接在手机上扫码测试的
小程序开发者工具里使用公众号开发的环境 很多api是无法调用的 需要注意

错误码查询工具
本人上传了官方1.2.0的jweixin npm包 weixin-jweixin

企业微信官方 js-sdk1.2.0 es6 版本 (非1.6.0微信版本) 说明: 仅将官方 js-sdk 发布到 npm,便于 webpack 使用 注意事项:此包为企业微信wx.config相关api所需的依赖包 如需使用wx.agentConfig注入应用权限请使用其他依赖包

ps: 如需安装jwxwork-1.0.0.js 配合使用 可以使用wecomjsdk这个包
或者引入js
<script src="https://open.work.weixin.qq.com/wwopen/js/jwxwork-1.0.0.js"></script>

注意!!! 如果使用script标签引入jwxwork 配合weixin-jweixin依赖包使用的话 在android企微中和PC端企微中会不识别jwxwork相关api . IOS是正常的注意!!!

安装:npm install weixin-jweixin -S
安装:npm install wecomjsdk -S

由于wx变量重名问题 Object.assigon 也会导致jwxwork.api为undefined 所以这里讨巧解决
// 这里的引入顺序不能替换 否则会报错
// 不使用script标签引入的原因是 企微pc端和部分android机器会不识别jwxwork-1.0.0.js
import wx from 'wecomjsdk'; // 由于这个包的开发者使用的是module.exports导出的 
// 所以不能使用 xx as xx 去重命名如有需要可以使用CommonJS方法
// const wxx = require('wecomjsdk') 
import {default as jwx} from 'weixin-jweixin'  // 解构default 重命名为jwx

methods(){
  const share_url = encodeURIComponent(location.href.split('#')[0]) // 获取当前项目url
  //TODO: 调用企业和应用的相关接口获取签名、企业ID、应用ID等相关信息
  const res = '企业相关数据'
  const response = '应用相关数据'
  const {corpId,nonceStr,signature,timestamp} = res;
  jwx.config({
        beta: true, // 必须这么写,否则wx.invoke调用形式的jsapi会有问题
        debug: process.env.NODE_ENV === 'development', // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以    在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
        appId: corpId, // 必填,企微的corpID
        timestamp: timestamp, // 必填,生成签名的时间戳
        nonceStr: nonceStr, // 必填,生成签名的随机串
        signature: signature, // 必填,签名,见附录1
        jsApiList: [
          'selectExternalContact',
          'shareAppMessage'
        ], // 必填,需要使用的JS接口列表,
  });
  // 配置成功后在回调里处理企微agentConfig
  jwx.ready(()=>{
    wx.agentConfig({
        corpid: corpId,
        agentid: response.data.agentId,
        timestamp: response.data.timestamp, 
        nonceStr: response.data.nonceStr, 
        signature: response.data.signature,
        jsApiList: [
          'sendChatMessage', // https://developer.work.weixin.qq.com/document/path/94349
          'setShareAttr', // https://developer.work.weixin.qq.com/document/path/94486#setShareAttr
          'getContext', // https://developer.work.weixin.qq.com/document/path/94315#21950
        ],
        success: function(res) {
          console.log('应用成功',res)
        },
        fail: function(res) {
          console.log('应用失败',res)
          if(res.errMsg.indexOf('function not exist') > -1){
              alert('版本过低请升级')
          }
        }
    });
  })
}

后续页面可以通过jwx调用config---jsApiList的方法
wx调用agentConfig---jsApiList的方法

wx.invoke ....
jwx.scanQRCode...


6. 测试环境发布

由于微信和企微的相关api都需要在各自的环境使用 请注意使用userAgent判断wxwork字段
并且微信验证url白名单 导致必须盲写然后提交代码到测试环境才可以测试代码完整度
可以使用git rebase 合并提交记录 此文不做赘述


7.网页授权登录

网页授权的相关文档不在客户端API中... 在服务端API中....orz
找了好久没找到 还以为企业微信不支持登录呢
企业微信网页授权登录文档
需要注意的是 回调地址需要在 开发者接口--->网页授权及JS-SDK--->可作为应用OAuth2.0网页授权功能的回调域名中配置回调域名
并且只能填写一个域名.. 如何区分测试环境和产线环境目前不清楚 ...初步方案是建设2个应用


8.客户相关API调用的权限问题

之前为了兼容测试环境和产线环境开了两个应用
结果发布产线以后 客户相关的wx.api 都无法调用 后续排查下来是没有配置客户权限(一开始以为是apiList的权限相关接口配置出问题了)

Snipaste_2022-08-19_09-33-31.png

点击API后有个可调用应用 需要把相关应用勾选上.

未完待续...

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容