菜单

订阅

快速上手：微信企业号管理开发平台

标签：技术文档

本文将介绍如何使用微信企业号管理开发平台来管理你的微信企业号中的应用。主要包含两大部分：

微信企业号后台

  • 成员如何关注微信企业号
  • 新建应用
  • 创建管理组、获取CorpID和Secret
  • 展示微信效果

微信企业号管理开发平台

  • 为何使用这个App
  • 新建微信企业号
  • 从微信同步应用
  • 配置本地微信应用
  • 设置应用菜单
  • 发布应用到微信
  • 展示微信效果
  • 项目案例展示

微信企业号后台介绍

访问地址：https://qy.weixin.qq.com/
前提：公司已申请了微信企业号

1.成员如何关注微信企业号

公司申请微信企业号后，企业员工怎样关注微信企业号呢？步骤如下：

第1步.添加通讯录成员

管理员登录微信企业号后台后，进入"通讯录"，单个或批量添加成员信息。 单个添加： alt 批量导入： alt

成员的账号必须和AWS PaaS平台中的人员保持账号一致

第2步.管理员邀请通讯录成员关注微信

企业可有多种方式来邀请员工关注，如：
1）二维码关注：通过访问"微信企业号后台--》设置--》基本信息"找到二维码之后，下发给成员关注
alt 2）转发名片关注：管理员登录微信企业号后台，设置企业名片后，成员收到企业号的文章内的头像之后，找到企业名片，将企业名片转发给其他同事，其他人即可通过企业名片关注，详见下图：
alt 3）搜索企业号名称关注："企业号--》设置--》功能设置--》企业号搜索"开启搜索之后，成员可在微信上通过搜索“企业号+企业号全称”找到该企业号。
alt

第3步.用户在微信中关注企业号

用户选择关注企业号后，会提示关注成功。此时企业号后台开始验证用户的身份。若身份验证未通过，用户除企业小助手外，看不到其它的应用，也无法收到这些应用发送的消息。在微信企业号平台的后台该用户显示为未验证的状态。

a）匹配微信号/手机号：若用户微信号与通讯录中某成员的微信号相同，或该微信号所绑定的手机与通讯录成员的手机一致，则系统把该用户与通讯录成员绑定，身份验证成功，否则进入步骤b；

b）提示输入登记手机号/邮箱：企业小助手向则用户发消息提示用户输入在企业号下登记的手机号/邮箱；

c）发送验证码：若用户输入的手机号/邮箱存在于通讯录中，则企业号会向该手机号/邮箱发送验证码；

d）验证码完成验证：用户在微信侧回复正确的验证码即可完成身份验证；若验证不通过,用户将会收到管理员预先设定的失败提醒信息。若输入验证码达当日上限，系统当日将不再处理用户的验证请求。

可详见腾讯客服：
http://kf.qq.com/faq/140806zARbmm1408073umMrE.html

  • 用户关注成功后，只能看到可见范围中有权限的应用

alt

移动端显示信息： alt

2.新建应用

创建新的应用是由系统管理员来完成的，步骤如下：

1.登陆微信企业号后台
2.点击左侧的"应用中心"
3.点击"+"，选择应用类型，添加新应用信息
4.点击"提交"，新应用创建成功
alt

添加可信域名

alt

  • 如果AWS PaaS的Web URL服务有端口号，那可信域名也必须加上端口号，即：ip：端口号
  • 如果为正式环境，可信域名必须是一个通过ICP备案验证的互联网域名，如果为临时开发环境，可信域名可以是一个公网IP地址，访问时可能会出现风险安全提示框。

3.创建管理组、获取CorpID和Secret

详细步骤如下：

步骤1：访问管理组

单击"微信企业号后台--》设置--》tab页"功能设置"--》"权限管理"属性项"

步骤2：新建管理组

单击"设置->权限管理->新建管理组"，新建管理组并保存，获得该管理组下的CorpID和Secret alt

  • 若接入企业微信号，必须先用CorpID和其所在管理组的Secret来换取Access_Token，之后才能调用企业号相关接口
  • 一个企业号的CorpID只能在微信企业号管理开发平台注册一次

注意：

1）设置该管理组可管理的组织范围-通讯录权限
2）设置该管理组可管理的应用范围-应用权限
3）获得CorpID和Secret值注意安全性，存在泄露隐患时可重置Secret，并重新配置到AWS PaaS

4.展示微信效果

alt

微信企业号管理开发平台

企业号是微信为企业用户提供的移动应用入口，帮助企业建立员工、上下游供应链与企业IT系统间的连接，开发者可以通过微信企业号提供的API为微信企业用户开发专有的微信应用。

1.为何使用这个App

  • 免集成开发。直接打通微信企业号和AWS MVC的OAuth授权访问机制
  • 免回调开发。企业号应用的回调消息和事件直接推送给开发者
  • 学习曲线低。无需了解微信企业号XML消息结构，直接提供Java封装对象
  • 开放H5框架。既可以使用AWS PaaS推荐的MUI、JQuery Mobile框架，也可使用自己熟悉的前端框架
  • 企业大后端。通过AWS PaaS的强大流程、集成等原生服务，让企业号应用更丰富、更个性、更智能
  • 分发更简单。如果您是ISV，可以将开发的微信企业号应用订阅/分发给其他PaaS用户

可详细查看文档AWS微信企业号管理开发平台参考指南

2.新建微信企业号

步骤如下：

1)登录您的AWS PaaS实例控制台
2)访问"工具附加"页面
3)点击"微信企业号管理开发平台"
4)点击"新建企业号"按钮

alt

  • CorpID和Secret值是获取的管理组对应的值。
  • 支持注册多个企业号

3.从微信同步应用

将微信企业号后台的应用配置同步到AWS微信企业号管理开发平台。操作步骤如下：

1)点击左侧的"应用中心"菜单
2)在已注册的微信企业号右侧，点击"从微信同步应用"

alt

注意：

同步的应用范围与管理组权限有关。参见微信后台管理组设置：

alt

4.配置本地微信应用

配置操作仅针对于某个已存在的应用。

访问应用入口：

1.点击您的AWS PaaS实例控制台左侧的"应用中心"菜单
2.在本地应用列表，点击某个应用

关于应用主要有以下操作：

  • 设置应用图标
  • 修改应用配置
设置应用图标

步骤如下：

步骤1.点击左侧的"应用中心"菜单
步骤2.在本地应用列表，点击某个应用
步骤3.点击应用头像后面的图标，设置新的图标

alt

建议上传图片尺寸为640x640，实色背景

修改应用配置

步骤如下：

步骤1.点击左侧的"应用中心"菜单
步骤2.在本地应用列表，点击某个应用
步骤3.点击"编辑"按钮进行编辑

alt

编辑页面

alt

可信域名

此项在本地只读，应在微信企业号后台事先配置好。

alt

  • 如果AWS PaaS的Web URL服务有端口号，那可信域名也必须加上端口号
  • 如果为正式环境，可信域名必须是一个通过ICP备案验证的互联网域名，如果为临时开发环境，可信域名可以是一个公网IP地址，访问时可能会出现风险安全提示框

alt

秘钥配置

将微信企业号后台该应用"回调模式-->>回调URL及密钥的Token、EncodingAESKey项"复制到本地应用的回调Token和EncodingAESKey。该项只需设置一次。

alt

微信企业号管理开发平台本地应用的回调Token和EncodingAESKey配置完毕后请先点击"确定"，使之生效。这样可以在微信后台为接下来的回调URL设置，提供OAuth验证的自动化检查。

回调URL设置

第一次配置时，AWS微信企业号管理开发平台应用会自动生成回调URL，将其复制到微信企业号后台该应用的"回调模式-->>回调URL及密钥"的URL项即可。该项只需设置一次。

alt 即下图所示：

alt 注意：

  • 该URL支持HTTP/HTTPS，其host部分必须与可信域名一致，如果URL服务有端口号，那可信域名也必须加上端口号。
  • 如果本地URL显示为http://localcost， 说明您的AWS PaaS本地开发环境未设置公网访问地址（见bin/conf/aws-portal.xml配置的portal>url项）

5.设置应用菜单

企业号要求菜单最多为两级，一级菜单最多为3个，二级菜单最多为5个。

alt

步骤如下：

步骤1：打开某个应用，点击"设置菜单"按钮
步骤2：点击"添加一级菜单"，填写菜单信息
步骤3：在一级菜单下点击"添加二级菜单"

如果菜单类型是跳转网页，且URL请求来自AWS PaaS的原生URL服务，请简写成cmd=xxx&参数...。在发布到微信时，系统会自动按企业号规范补齐完整的调用地址。菜单类型说明可参照企业号接口文档

将AWS应用的微信菜单部署到该企业号应用

将AWS应用的微信菜单部署到该企业号应用是一个重要操作，只有通过菜单关联，该企业号应用所推送的消息、事件才能分发给被关联的本地AWS PaaS应用。步骤如下：

步骤1：打开某个应用
步骤2：点击"AWS应用菜单"按钮，选择对应的AWS应用，例如选择"我的工作台"

alt

我的工作台属于AWS PaaS应用，在我的工作台的App下需要先配置一个wechat.json文件，内容如下：

{ "button": [ { "type": "view", "name": "待办", "url":"cmd=com.actionsoft.apps.workbench_mobile_list_page" }, { "type": "view", "name": "已办", "url":"cmd=com.actionsoft.apps.workbench_mobile_havetodo_list_page" }, { "type": "view", "name": "发起", "url":"cmd=com.actionsoft.apps.workbench_mobile_start_list_page" } ] }

当本地某个AWS PaaS应用的微信菜单结构发生变化后，需要重新部署。

6.发布应用到微信

当微信企业号管理开发平台的应用配置在被修改后，并不会时时同步到微信企业号，需要发布本地修改到微信企业号平台。步骤如下：

步骤1：在微信企业号管理开发平台打开某个应用
步骤2：修改当前应用信息，点击"发布本地修改"，将本地修改更新到微信企业号

alt

根据腾讯的企业号应用发布策略，应用信息或菜单结构更新发布后，会在24小时内生效。通常，可以取消关注微信号并重新关注来加速应用更新的效果。

如果想取消本地的修改，点击"从微信同步应用"，本地的修改将被覆盖。

7.展示微信效果

部署后的菜单在微信移动端显示如下图：

alt

打开菜单，如：打开"待办"菜单 alt

8.项目案例展示

微信企业号管理开发平台在某些项目已经使用，下面是来源于项目的图例展示图：

1.移动端请假发起页面：

alt

2.办理发送页面：

alt

3.待办页面：

alt

4.领导审批页面：
alt

AWS PaaS#QA

继续阅读此作者的更多文章。