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

配置本地微信应用

几乎所有的开发和配置工作都围绕着某个应用展开。

  1. 登录您的AWS PaaS实例控制台
  2. 访问“工具附加”页面
  3. 点击“企业微信管理开发平台”
  4. 点击左侧的“应用中心”菜单
  5. 在本地应用列表,点击某个应用

应用基本信息

支持的操作

  • 设置应用图标(建议上传图片尺寸为640x640,实色背景)
  • 修改应用配置
  • 设置应用菜单
  • 删除应用(不会删除微信端,下次同步时会再次创建)
  • 发布本地修改

1. 修改应用配置

可信域名

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

在设置可信域名框中点击申请校验域名,按照提示下载文件放在平台\webserver\webapps\ROOT中,如没有ROOT在portal同级目录手动创建ROOT文件夹,在勾选已上传域名归属校验文件,并按提示在浏览器地址栏中输入URL校验访问正常

如果AWS PaaS的Web URL服务有端口号,那可信域名也必须加上端口号。如果为正式环境,可信域名必须是一个通过ICP备案验证的互联网域名,如应用页面需要使用微信JS-SDK,需完成域名归属验证。

//例子1
b2b.awspaas.com

//例子2
b2b.awspaas.com:8088

密钥设置

将企业微信后台该应用的回调模式>回调URL及密钥TokenEncodingAESKey项复制到本地应用的回调TokenEncodingAESKey该项握手配对过程,只需设置一次。

微信应用配置 本地应用配置

本地应用的回调TokenEncodingAESKey配置完毕后,请先点击确定,使之生效。这样可以在微信后台为接下来的回调URL设置,提供OAuth验证的自动化检查。

回调URL设置

第一次配置时,本地应用会自动生成回调URL,将其复制到微信后台该应用的回调模式>回调URL及密钥URL项即可。该项握手配对过程,只需设置一次。

注意:

  1. 该URL支持HTTP/HTTPS,其host部分必须与可信域名一致,如果URL服务有端口号,那可信域名也必须加上端口号。
  2. 如果本地URL显示为http://localhost,说明您的AWS PaaS本地开发环境未设置用域名可访问的地址(见bin/conf/aws-portal.xml配置的portal>url项),需要改为用域名可访问的地址
本地应用配置 微信应用配置

如果本地应用尚未配置回调TokenEncodingAESKey,在企业微信后台保存回调URL时,可能会抛出echostr校验失败,请您检查是否正确解密并输出明文echostr错误

接收变更通知

见企业微信后台该应用的接收消息>已启用API接收>回调URL及密钥相关项

上报进入事件

见企业微信后台该应用的接收消息>已启用API接收>接收的消息事件类型相关项

2. 设置应用菜单

企业微信要求菜单最多为两级,一级菜单最多为3个,二级菜单最多为5个。菜单类型说明可参照企业微信接口文档

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

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

点击左下角的图标,弹出当前AWS PaaS平台支持微信应用部署的App,完成关联操作。

这是一个重要操作,只有通过菜单关联,该企业微信应用所推送的消息、事件才能分发给被关联的本地AWS PaaS应用。

这里采用了复制而不是关联,当本地某个AWS PaaS应用的微信菜单结构发生变化后,需要重新部署。



Seven
 010-62962343-690
 liujx@actionsoft.com.cn
感谢您对该文档的关注!如果您对当前页面内容有疑问或好的建议,请与我联系。如果您需要解答相关技术问题请登录AWS客户成功社区