到畅移首页

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

打印

【对接前的准备】

  1. 选择合适的第三方云服务厂商,了解清楚所提供的云服务的能力符合你的需求。
  2. 对接前要了解几个基本概念。

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

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

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


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

回调URLTokenEncodingAesKey。这三个参数由第三方服务商提供,需要在企业号后台配置好。


因此,对接前要做的三项工作是:


【操作指南】

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

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


第一步:建立应用,获取应用ID

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


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


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



第二步:创建管理组,获取接口能力

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


1)在“设置”中,进入“权限管理”。

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


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


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


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

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

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

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

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

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


3)配置完成后,在该管理组的下方,可以得到CorpID和Secret两个参数。将这两个参数提供给第三方即可。


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

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

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

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


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