Skip to main content

企业微信授权版应用

1. 概述

微信企业号模块是指系统对微信接口作了封装,便于用户使用,并提供常用界面功能。

安装了微信企业号授权版模块后,可对企业号的自建应用或者第三方应用进行操作,使用配置简单。

2. 功能说明

2.1 企业应用菜单管理

img

(1)企业应用菜单管理:新增、修改、删除、查询、对菜单进行升级、降级等操作

img

(2)菜单的两种类型:目录和链接url

img

注:一级菜单名称不能超过4个汉字或8个字母,二级菜单名称不能超过8个汉字或16个字母,如果超过规定的字数限制会有相应的提示,如下:

img

(3)当菜单类型选择目录时,可以新增下级菜单

注意

自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单

一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替

(4)当菜单类型选择链接url时,可直接填写链接地址或选择vbase窗体

img

(5)手动输入链接地址

在链接地址编辑框输入链接地址,根据需要判断是否需要勾选开启OAuth认证以及登录统一认证。

img

开启OAuth认证:勾选给后即访问后会获取微信成员信息,如输入的链接地址需要获取登录信息,那么需要开启OAuth认证,勾选点击确定后发布预览地址会自动加上“&wxqyJHOAuthId=企业编码CorpId |应用编码 ”参数。

登录统一认证:如果服务有接入到统一门户且需要获取登录信息,需要勾选登录统一认证,勾选点击确定后发布预览地址会自动加上“&loginTo=vuc”参数。注:如果开启统一认证,所有的菜单需勾选统一认证。

如果url是打开V服务的窗体,传参需要用下列格式,注意,红色框住的地方需要使用2次EncodeURIComponent函数处理,再拼接到&token=后面。

img

多个参数形式,如:

{"data":{"inputParam":{"variable":{"窗体输入编码1":"值1","窗体输入编码2":"值2",.........}}}}

(6)选择窗体

单击“选择窗体”,在列表左侧输入构件编号查找需要的构件以及构件下的窗体,点击确定,然后根据需要填写“传递vbase窗体参数”和“传递url链接参数”。选择窗体的形式是默认访问后会获取微信成员信息。

img

img

img

(7)设置显示

设置设备显示后可实现企业微信pc端和移动端打开的应用菜单为不同的地址,在pc端打开菜单的时候也可以用本机的默认浏览器打开。

img

勾选pc端移动端分开显示,分别在pc端菜单地址编辑框和移动端菜单地址编辑框输入地址后点击确定即可;如需要在pc端打开菜单的时候用默认浏览器打开,则需要勾选pc端打开默认浏览器。

注意
  1. 只有当勾选pc端移动端分开显示的时候,pc端打开默认浏览器才生效。
  2. 当勾选了pc端打开默认浏览器,因为有调用到微信的接口,所以需要开启企业微信jdk,即到配置中心“移动端管理-微信管理”菜单下开启企业号授权版。

效果:

在pc端点击菜单打开的窗体:

img

移动端点击同一个菜单打开的窗体:

img

(3)保存应用菜单

注意

创建完菜单后点击“保存”,然后将生成的应用菜单url填写到微信企业后台-自定义菜单,微信的应用菜单大概要2至15分钟后才会看到效果,开发期可以取消关注该企业号再重新关注,即可马上看到效果。(若微信企业后台-自定义菜单内容有改动,需要重新授权应用才可生效)

img

img

注意

如果公众号,企业号简单版和企业号授权版中,同时开启了多个如果服务即开启了企业微信简单版也开启了企业微信授权版,那么需要到微信后台的应用菜单地址后添加上参数&platformWxKey=qyAuth

2.2 微信关注企业号

在企业微信管理页面中,打开我的企业-微工作台,关注二维码即可,如下:

img

img

2.3 发送消息

(1)选择接收人员:可根据部门、人员来选择

img

(2)选择应用:在应用管理列表中选择应用

img

(3)消息类型:文字、图片、语音、视频、文件、图文、新闻、文本卡片

注意:可根据自身业务情况判断是否需要以安全消息的形式发送。

img

2.4 通信录管理

通讯录管理:增量更新成员、全量覆盖成员

注意:该应用类型必须是通讯录类型。

img

2.5 回复消息定义

  1. 基本信息填写:填写规则名、规则编码

  2. 匹配规则:可添加一条或者多条匹配规则

    注意:当勾选全词匹配时,用户只能输入“关键字”来达到消息回复的功能;当不勾选全词匹配时,用户可以输入“*关键字*”来实现消息回复的功能。
  3. 响应内容:文字、新闻消息、图片、语音、视频、第三方扩展

img

img

2.6 流程发送微信提醒配置

(1)首先配置一条流程定义,详情请见《Vbase流程管理》使用手册

http://www.myvdev.com/document/yewuyingyong/7-show-article.html

注意:关联维度业务窗体配置时,需要手动添加一个维度编号“mobile”,并且关联业务窗体。

img

(2)流程发送微信提醒配置:新增、修改、删除

img

(3)新增流程发送微信提醒配置:首先选择接收消息的应用,然后根据业务自行设计微信提醒配置

img

注意事项:

img

2.7 查看已接收的消息

img

3. 业务系统分离管理

其功能与“独立管理”一致,只需将是否远程调用api勾上,并且在配置中心 → 系统高级配置 → 配置管理 → 微信企业号授权版的配置中将“是否强制进行远程调用”设置为 Y

img

img

4. API文档

平台还提供其他封装好的接口,详情看 vbase_wx_qy__yw_api_API 接口说明。