企业微信简单版应用
企业微信简单版应用
1. 安装企业微信集成清单
需联系平台支持人员，人工授权获取企业微信集成清单；
本项目引入企业微信清单后，更新到执行系统，进行重启。
2. 企业微信新建应用
首先需要注册企业号，使用企业号登录之后，进行应用创建等操作。
企业微信登陆：https://work.weixin.qq.com/
申请校验域名：
OAuth2.0网页授权：
将下载好的txt文件，放到执行系统安装目录下
V-AppServer\V3Runtime\pages，然后访问提供的测试链接（域名/文件名或者域名/上下文/文件名），若成功访问，页面效果如下：验证不通过：
验证通过：则应用创建成功，前往配置中心填写配置信息。
3. 简单版应用配置
设置路径：配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信简单版 → 微信管理
（1）企业号管理
- 企业图标：自定义信息；
- 企业简称：自定义信息；
- 企业官网：自定义信息；
- 业务编码：自定义信息；
- CorpId：
企业ID，根据企业号实际信息获取（我的企业 → 企业信息 → 企业ID）； - 管理密钥：
Secret，根据企业号实际信息获取（管理工具 → 通信录同步 → Secret）。
企业ID：
Secret（管理密钥）：
（2）应用管理
基本资料及开发信息：
- 应用AgentId：在企业微信管理后台的自定义应用信息中，获取对应信息（应用管理 → 示例应用 → AgentId）；
- 应用Secret：在企业微信管理后台的自定义应用信息中，获取对应信息（应用管理 → 示例应用 → Secret）；
- 可信域名：根据系统设置中的域名自动生成；
- OAuth验证url：根据系统设置中的OAuth验证自动生成；
- OAuth验证回调url：根据系统设置中的OAuth验证回调自动生成；
- 指令回调URL：设置完业务编码，自动生成；
- Token：在企业号的自定义应用信息中，获取接收信息中信息（应用管理 → 示例应用 → 接收信息）；
- EncodingAESKey：在企业号的自定义应用信息中，获取接收信息中信息（应用管理 → 示例应用 → 接收信息）；
应用AgentId和Secret：
设置Token和EncodingAESKey:
Token和EncodingAESKey，可以在企业号中随机获取，也可以自定义；- 企业号中的
Token和EncodingAESKey，必须和配置中心中应用设置的Token和EncodingAESKey保持一致； - 先要在配置中心中保存，API接收消息设置的openapi回调地址请求才通过，才能保存。
设置路径：配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信简单版 → 应用菜单设置
也可以在企业号后台管理设置应用菜单。
（若没有菜单，跳过此步骤）
设置链接地址和预览链接：
设备显示PC端和移动端菜单分离，可以分别设置菜单地址：
菜单配置效果：
4. 发送应用消息
（1） 获取默认应用配置：
vbase_wx_qy_simple_yw_api.API_QuerySimpleConfig入参为空，返回值：
获取参数值【simpleAppBizCode】作为发送消息接口的入参。
（2） 调用发送链接消息接口：
vbase_wx_qy_simple_yw_api.API_SendTextcardMessageAction_Simple
必填参数如下：
（3） 链接OAuth认证参数获取：
&wxqyJHOAuthId=CorpId|AgentId参数示例：
&wxqyJHOAuthId=wwc17ac90c1eca8490|1000018
CorpId参数获取：vbase_wx_qy_simple_yw_api.API_QueryCorpInfoSimple入参为空，返回值：
AppProvider.ProviderCorpId
AgentId参数获取：vbase_wx_qy_simple_yw_api.API_QuerySimpleApp入参：应用编码
simpleAppBizCode出参：
simpleApp.AgentId
方法一：在配置中心中测试消息发送
设置路径：配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信简单版 → 系统设置
方法二：调用接口API实现消息发送
（1） 获取默认应用配置：
vbase_wx_qy_simple_yw_api.API_QuerySimpleConfig入参为空，返回值：
获取参数值【simpleAppBizCode】作为发送消息接口的入参。
（2） 调用发送纯文本消息接口：
vbase_wx_qy_simple_yw_api.API_SendTextMessage_Simple必填参数如下：
5. 开启JS-SDK
设置路径：配置中心 → 系统高级配置 → 移动端管理 → 微信管理
开启JS-SDK报错：
在企业微信管理后台 → 管理工具 → 通讯录同步 → 企业可信IP中配置：
