AWS企业微信管理开发平台参考指南

新建AWS PaaS应用

要您的AWS PaaS本地应用支持以下能力，请阅读本章节。

• 处理企业微信某个应用的消息事件
• 为企业微信某个应用提供H5页面功能

您可以建立一个新应用完成测试过程，也可以在现有PaaS App上拓展这项支持。

设计微信应用菜单结构

企业微信的每个应用都可以拥有自己的菜单，菜单是成员访问应用的主要入口。企业微信要求菜单最多为两级，一级菜单最多为3个，二级菜单最多为5个。

如果您希望该PaaS应用向企业微信应用提供菜单入口的定义，只需在该应用的根目录下创建一个名称为wechat.json的文件

%AWS-HOME%/install/apps/your appId/wechat.json

结构可参照企业微信接口文档的说明。在本示例中，我们定义的菜单结构如下

{
    "button": [
        {
            "name": "扫码",
            "sub_button": [
                {
                    "type": "scancode_waitmsg",
                    "name": "扫码带提示",
                    "key": "aws-paas-wechat-menu-testcase-1"
                },
                {
                    "type": "scancode_push",
                    "name": "扫码推事件",
                    "key": "aws-paas-wechat-menu-testcase-2"
                }
            ]
        },
        {
            "name": "发图",
            "sub_button": [
                {
                    "type": "pic_sysphoto",
                    "name": "系统拍照发图",
                    "key": "aws-paas-wechat-menu-testcase-3"
                 },
                {
                    "type": "pic_photo_or_album",
                    "name": "拍照或者相册发图",
                    "key": "aws-paas-wechat-menu-testcase-4"
                },
                {
                    "type": "pic_weixin",
                    "name": "微信相册发图",
                    "key": "aws-paas-wechat-menu-testcase-5"
                }
            ]
        },
        {
            "name": "其他",
            "sub_button": [
                {
                    "type": "click",
                    "name": "URL菜单",
                    "key": "aws-paas-wechat-menu-testcase-6",
                    "url": "cmd=com.actionsoft.apps.wechat.demo_hello"
                 },
                {
                    "type": "location_select",
                    "name": "发送位置",
                    "key": "aws-paas-wechat-menu-testcase-7"
                }
            ]
        }
    ]
}

应用根目录下存在wechat.json文件的应用，可以在企业微信管理开发平台的应用菜单设置中，将这些应用的菜单关联到企业微信应用的菜单上。

wechat.json定义的菜单	关联到微信应用菜单

发布到微信后的实际菜单

接收和处理微信的消息和事件

这是一个AWS PaaS插件机制，开发者可以通过向企业微信事件处理器注册自己的监听处理代码，捕获微信消息和事件。

如何在您的应用中注册微信消息处理器，请移步这里