跳转至

企业微信第三方应用开发

第三方应用接口旨在方便企业微信管理员和成员通过简单的操作来使用第三方的云应用。 实现该目标的核心的机制是:服务商和开发者预先在第三方管理端注册登记应用信息。企业选择使用第三方应用时,通过授权流程来一键安装应用。

开始

第一步:第三方注册应用

企业微信支持服务商和个人开发者注册应用:

服务商 企业在具备以下条件后,可以在“第三方官网”注册成为第三方服务商。

  1. 拥有第三方服务商身份的企业微信。

  2. 具有互联网上部署及发布应用的能力。 注册成为第三方服务商之后,即可登录“第三方官网”创建第三方应用。具体的注册细节请参见“第三方服务商注册应用”。

个人开发者 个人用户在具备以下条件后,可以在“开发者中心”成为企业微信开发者。

  1. 已成为企业微信用户,即创建一个新企业或加入一个已有企业。

  2. 具有应用程序开发能力。 成为企业微信开发者之后,即可登录“开发者中心”创建第三方应用。具体的注册细节请参见“开发者注册应用”。

第二步:企业用户授权应用

企业用户可以从企业微信工作台的应用市场. 企业微信官网和服务商官网找到适用的第三方应用后,管理员和成员可发起一键授权。系统将展示第三方应用授权页面,管理员和成员可根据授权页面的引导,确认授权内容,完成授权操作。

第三步:第三方提供服务

完成授权后,第三方即可获取企业赋予的永久授权码。通过此授权码,第三方可以换取到企业的访问凭证,从而可以调用通讯录管理. 消息推送. 身份验证. 移动端 SDK. 素材. OA 数据接口. 企业支付. 电子发票等相关接口。

关于套件到单应用的调整

新注册的第三方服务商和开发者请忽略此小节

企业微信的第三方应用,最开始是以多个应用的组合方式(即以“套件”的方式),来提供给企业管理员进行安装的。现在取消了这种方式,每次授权只能安装一个第三方应用。这样的调整,主要是基于以下两方面的考虑:

应用对主页 url 的支持,用户可从企业微信的工作台直接进入第三方的 h5 页面,所以第三方可以将多项服务集成到同一个应用 h5 里。 现在企业管理员可以在手机 app 查找. 安装并管理第三方应用,以单应用的方式,更易于理解和操作。 所以,后续第三方服务商都需要尽量将同一类型的云服务整合到一个应用里。

关于调整点:

  1. 第三方接口不变,仅对单应用机制做出微调,因此原套件机制不受影响。
  2. 管理端不能新建套件,仅可维护。新的应用只能用单应用形式创建。
  3. 单应用的 oauth2 授权机制有所调整,支持同一链接在不同企业的授权。参见”网页授权登录第三方”。
  4. 单应用的“应用设置接口”和“菜单设置接口”不再支持。
  5. 单应用的 get_permanent_code 和 get_auth_info 接口,不返回 appid 字段。