企业微信开发者介绍

什么是应用？

应用是消息的通道和开放能力的载体，服务商可以通过企业微信工作台或消息列表进入应用，也可以对应用进行可见范围配置。应用有丰富的消息类型：文本、图片、语音、视频、地理位置、红包等；有3种交互方式：收发消息，点击事件回调，进入网页或小程序。

应用的需求场景分类

从应用的需求场景进行分类，可以分成以下3类：

1、企业内部应用：

由企业内部的开发者自己开发部署，相当于是企业自己的资产，调用接口基本没有任何限制。

2、第三方应用

由SaaS服务商的开发者开发并部署在服务商侧，面向所有企业。需要企业授权使用，服务商仅可获取企业授权部分的权限，相当于白名单控制。

3、代开发自建应用

由服务商的开发者开发，但部署在企业内部。一般是线下签约采购方式，因此权限几乎与自建应用无异，企业管理员只需要配置不对服务商开放的敏感权限，相当于黑名单控制。

这3类应用的特征总结如下表所示：

应用的技术框架分类

从应用所使用的技术框架进行分类，可以分成以下2类：

1、小程序

在企业微信或微信中渲染，优点是速度更快，更接近原生体验，能力更丰富。缺点是开发周期更长，开发者需要使用微信小程序开发工具调试模拟体验，发布需要经过公众平台审核。

2、网页应用

几乎等同于在浏览器打开，优点是开发周期较短，只需要接入oauth2能力获取企业微信员工身份即可使用，如果企业已有网页系统，只需要少量修改即可完成接入。缺点是渲染速度较慢，且功能较少。

这2类应用的特征总结如下表所示：

账号体系

1. 部门

• 企业微信账号创建后，系统随即生成根部门；
• 部门可以嵌套部门（如下图所示，部门4嵌套在部门3中）；
• 部门下存在子部门或者成员时不可以被删除；
• 部门可以移动，移动后，部门下所有子部门和成员均随之移动到新节点下。（如下图所示）
  
  

2. 成员

• 成员在企业内的唯一标识是userid，成员的userid可以由企业指定或者企业微信生成；
• 成员在企业中必须属于一个部门；
• 成员可以属于多个部门，但在不同部门下，成员的userid仍保持一致（如下图所示）；
• 当一个成员从该企业的所有所属部门被删除后，他的userid被释放。
  
  
  

3. 标签

标签是一个跨组织架构的概念，可以包含任意数量的没有任何上下级关系的部门和成员，经常在公司文体协会，虚拟架构组等场景下被使用（如下图所示）。

• 标签数据变更不影响组织架构，如下图所示，删除标签不会删除对应的部门和成员。
  
  
  
• 组织架构数据变更会影响标签，主要有两种情况。

情况一 新成员入职且加入带标签的部门，该新成员会被自动打上相应标签（如下图所示）。



情况二 成员从带标签的部门离职，则自动从该标签中被删除（如下图所示）。

权限体系

1. 应用可见范围

企业可配置应用的可见范围权限。可见范围内的员工可以在工作台中看到该应用，可以接收该应用消息，可以被该应用通过接口所获取。

以下图为例，若将应用的可见范围设置为子部门1和成员4，则相当于成员1~4都在应用的可见范围内，他们的工作台中就会出现该应用，其他成员则不会出现。此外还有2点注意事项：

• 因为设置子部门1在应用的可见范围中，所以后续子部门1新入职成员的工作台中均会自动出现该应用。
• 若将某部门或成员设置在应用可见范围中，则第三方应用调用接口也可获取其相应的权限，反之则不能获取。在下图案例中，成员5、6未在应用可见范围中，因此服务商不可通过接口获取到他们的信息，也不可以对其发送消息。
  
  

2. 应用调用 OpenApi 权限

企业微信 OpenApi 指的是服务端Api开放的能力接口，开发者可以借助接口能力，实现企业服务及企业微信的集成。支持如通讯录管理、消息推送等。

所有接口都需使用HTTPS协议、JSON数据格式、UTF8编码。接口说明格式如下：

企业微信几乎所有接口调用都必须带入access_token参数。access_token可通过企业corpid和应用的secret获取，代表了应用的身份。

大致的调用流程如下图所示：