企业微信自建应用开发初探

<p>企业微信是腾讯推出的一个新的办公协作平台，通过与微信一致的沟通体验，为企业员工提供最基础和最实用的办公服务。同时企业微信作为一个开发平台，企业可以根据需要开发定制自己的企业应用集成到企业微信上。ABC WeChat是我们公司为ABC开发的基于企业微信的一款应用（因保密需要，这里用ABC代替公司名称）。</p>
<p>本文以该项目为例对在企业微信平台开发企业应用的特点进行了总结，重点分析了企业微信开发平台对应用开发提供的支持，并指出了实际开发中存在的一些挑战。</p>
<h2>1.ABC WeChat项目介绍</h2>
<p>从2018年5月份讨论需求开始，ABC WeChat项目主体开发共分两个阶段，总历时约六个月。这个应用主要是为一个现有劳动力管理产品提供了一个基于微信的客户端，使得用户可以通过企业微信，使用该产品的部分功能，如打卡，查看排版信息等，满足用户的移动办公需求。主要实现的功能有：</p>
<ul><li><p>实现现有产品的登录入口，并且提供一定时间内的免登录</p></li><li><p>根据位置不同展示不同的打卡二维码</p></li><li><p>扫描二维码实现自动打卡</p></li><li><p>展示用户的排班信息</p></li><li><p>提供打卡提醒及异常提醒</p></li><li><p>工时和异常信息的统计</p></li><li><p>请假及审批</p></li></ul>
<h2>2.企业微信开发应用集成方式</h2>
<p>企业微信提供多种应用集成方式。其中，按提供方来分有三种：</p>
<ul><li><p>基础应用：由微信提供；</p></li><li><p>第三方应用：开放体系下的第三方服务商提供；</p></li><li><p>自建应用：我们自己新建的，一般我们也都是需要自建应用进行开发。</p></li></ul>
<p>按交互方式来分有两种：</p>
<ul><li><p>主页型应用：用户点击应用后直接打开一个链接；</p></li><li><p>消息型应用：可以像公众号一样设置多个菜单，每个菜单可以配置不同的响应方式。</p></li></ul>
<p>ABC WeChat项目属于自建应用中的主页型应用。这种应用是完全由企业自主开发定制，相对于基础应用和第三方应用更加灵活，功能上也更加符合企业自身需求。而相对于用有限几个菜单来提供响应的消息型应用来说，主页型应用的功能更加强大。</p>
<p>本文主要讨论自建的主页型应用。其基本结构如下图所示。</p>
<p><img alt="\"\"" src="https://beijingoptbbs.oss-cn-beijing.aliyuncs.com/cs/5606289-4dd18da8736f147c40e8883b2a0e9a6b.png"></p>
<h2>3.企业微信平台对应用开发的支持</h2>
<p>作为开发平台来说，企业微信对其上自建的企业应用提供了简单灵活的集成方式，并通过API提供了对手机硬件和微信本身功能的调用，可以帮助企业比较快速地构建出一个企业微信应用供企业用户使用。</p>
<h3>简单的集成方式</h3>
<p>对于自建的主页型应用，企业微信提供的集成方式是极其简单的，只需要企业管理员在管理端配置一个要访问应用的主页地址即可。当用户点击对应图标访问该应用时，企业微信就会打开内嵌浏览器并访问配置的主页地址。从而实现用户通过企业微信访问企业应用的目的。当然，企业现有应用的web页面未必适合直接放到企业微信中使用。一般都需要针对性的开发一套针对企业微信的web页面。</p>
<h3>网页开发，跨平台</h3>
<p>自建主页型应用是指向一个链接地址，后台企业应用服务器对该链接进行响应并下发网页代码。企业微信打开内嵌浏览器来解析网页代码并展示给用户。这个过程和普通网站类似，只是不需要用户打开浏览器而是企业微信打开并维护一个内嵌浏览器。因此对这种应用来说，其和普通web应用基本类似，也是基于网页开发的，原则上可以跨平台，只要有浏览器就可以运行。相比于Native的应用来说，提供了更多的灵活性。</p>
<h3>通过一套标准API，提供对手机硬件的调用</h3>
<p>由于浏览器本身限制，网页上运行的代码难以调用手机本身的一些功能，如扫描，拍照，获取地理位置等。因此企业微信提供了一套JS-SDK, 第三方可以通过JS调用该SDK实现对手机部分功能的调用。这种方式本身也屏蔽了不同手机不同操作系统本身的差异性和复杂性，使得开发过程更为简单。但同时也受限于企业微信SDK暴露出来的API，对于其没有暴露的功能，实现起来就会非常困难。</p>
<h3>提供消息推送接口</h3>
<p>企业微信开放了消息发送接口，企业可以使用这些接口让自建应用与企业微信后台或用户间进行双向通信。消息接口总体上分为主动发送单聊消息、接收单聊消