企业号如何接入第三方云服务

【前言】

微信企业号作为企业移动应用的入口和平台，非常欢迎和第三方厂家一起携手向企业客户提供服务。

第三方厂家大致为两类：定制化服务厂商和标准化云服务厂商。本文着重描述了第三方云服务如何与企业号进行对接，以降低客户管理员进行相关配置的难度，提升对接效率。本文所述的方法，同样也适用于同定制化厂商的对接。

 

【对接前的准备】

1.         选择合适的第三方云服务厂商，了解清楚所提供的云服务的能力符合你的需求。

2.         对接前要了解几个基本概念。

第三方应用调用企业号接口时，需要用到三个重要参数：

应用ID：需创建应用后获得。

CorpID和Secret：第三方应用调用企业号接口的必要参数之一。需创建管理组后才能获得。

 

而企业号回调第三方应用服务时，也需要用到几个参数：

回调URL、Token、EncodingAesKey。这三个参数由第三方服务商提供，需要在企业号后台配置好。

 

因此，对接前要做的三项工作是：

 

 

【操作指南】

企业号的消息都是以“应用”来推送的，用户也必须通过“应用”与企业后台服务交互。因此，第三方云服务也应以“应用”的形态存在，来对用户推送消息。

下面将以“某财务系统”为例，详细说明接入第三方云服务，在企业号侧的配置方法及注意事项。

 

第一步：建立应用，获取应用ID

1）首先登录企业号管理后台，进入“应用中心”创建一个应用，用来与第三方服务进行对接。

 

2）选择该应用的可见范围。请注意：可见范围决定了，企业中哪些成员可以见到这个应用，同时也意味着应用可以给哪些成员发消息。请根据实际需要选择即可。

 

3）创建完成后，查看该应用，可以获得该应用ID。这个ID将作为第三方调用企业号接口的参数。

 

第二步：创建管理组，获取接口能力

使用企业号接口，必须用到CorpID和Secret两个参数。而这两个参数，需要创建管理组来获取。

1）在“设置”中，进入“权限管理”。

 

2）如下图所示，配置好管理组的各项权限。这里的设置项将决定第三方应用可以做哪些操作，请务必谨慎设置。

 

应用权限：这里选择需要接入的应用即可。“发消息”指的是只能使用该应用推送消息，“配置应用”指的是除了推送消息，还可以修改应用的配置项。

 

通讯录权限：指定该管理组可以对通讯录中哪些成员进行查看或管理。除非第三方应用需要修改企业通讯录，否则，这里建议设置为“查看”权限即可。

 

敏感接口权限：指定该管理组可以使用哪些敏感接口。这些接口的作用，及可能带来的后果分别如下。

获取部门成员：获取指定部门下的成员列表。

获取部门列表：获取通讯录下的部门列表。该接口与“获取部门成员”接口结合使用，将可获取到企业通讯录中的所有成员列表。

获取成员信息：获取对应成员的详细信息，包括成员的头像、手机、邮箱、职务及其他自定义的字段。通常来说，第三方应用未必需要使用到这些详细信息，该接口建议谨慎授权。

获取标签成员：获取某标签下的成员列表。与获取部门成员接口类似。

维护通讯录：修改通讯录内容的接口。建议谨慎授权，若第三方应用无需维护通讯录，则请勿开启该权限。否则若企业通过其他方式同时维护通讯录时，可能会造成通讯录数据相互覆盖。

3）配置完成后，在该管理组的下方，可以得到CorpID和Secret两个参数。将这两个参数提

供给第三方即可。

 

 

第三步：在应用中配置回调参数

如需要企业号将某些用户事件通知给第三方应用，还需要将应用设置为“回调模式”

1）在“应用中心”里面找到“回调模式”，开启“回调模式”。

2）在弹出的页面中填写回调第三方所需要的必要参数，这几个参数需要由第三方服务商提供。

配置好这三步，就可以使用该应用与第三方进行连接了。