Skip to content

企业微信

平台集成企业微信,可以实现:企微单点登录、组织信息同步、企微API调用,等诸多能力

注意

平台集成企业微信的方式为:服务商代开发模式

点击查看服务商代开发模式

1.配置IP白名单

注意

一个服务商账号可以创建多个应用模板,每个私有化平台需要对应一个应用模板。即:只需要创建一个服务商账号即可

登录服务商管理后台,并配置IP白名单

只有IP白名单中的IP才允许调用企微接口,将服务器的IP地址设置到白名单中

特别说明

必须使用企微管理员账号登录,否则无法配置IP白名单

2.创建代开发应用模板

服务商后台选择:应用管理/应用代开发,点击:+创建代开发应用模板

2.1 配置基础信息

填写应用模板的基础资料,并点击下一步

2.2 配置开发信息

注意

代开发模板回调URL的格式为:根域名/api/cw/msg_callback

例如:

假设根域名为:https://apaas.0codepaas.com
则回调URL为:https://apaas.0codepaas.com/api/cw/msg_callback

特别说明

这里必须将TokenEncodingAESKey配置到管理后台/系统配置/企业微信,并重启服务后才能验证通过


Token 配置到:代开发应用消息校验Token

EncodingAESKey 配置到:代开发应用消息解密Key


配置示例

重启服务后点击保存,如果以上参数均配置正确,则创建代开发应用完成(注意:一定要重启服务后配置才能生效)

特别说明

模板创建完成后,点击查看模板信息,并将模板ID模板Secret配置到管理后台/系统配置/企业微信,并重启服务后生效


模板ID 配置到:代开发应用模板ID

模板Secret 配置到:代开发应用模板秘钥


配置示例(重启服务后配置才能生效)

3.应用模板上线

应用模板创建完成后,需要先配置模板的客服人员

点击应用模板上线

选择新创建的应用模板进行上线,然后等待审核通过即可

审核通过后,下载授权二维码,并上传到管理后台/系统配置/企业微信/代开发应用授权二维码

提示

至此代开发应用模板创建完成,接下来可以对平台下的组织进行企业微信绑定授权了


二维码上传示例

4.绑定企业微信

以上步骤设置完成后,便可以对平台下的组织进行企业微信绑定授权


点击绑定

提示

查看企业简称: 我的企业/企业信息/企业简称


扫码授权

注意

必须使用企微管理员账号进行扫码授权,授权完成后点击完成即可


授权完成

授权完成后,应用将是开发中状态

取消授权

需要先到企微管理后台的 应用管理 中找到想要取消授权的应用 -> 点击 取消授权

5.上线应用

当应用是开发中状态时是无法使用的,需要配置应用的相关参数后,再正式上线应用

5.1 配置开发参数

登录服务商账号,并进入代开发应用模板详情,找到新授权的代开发应用,点击开始代开发应用


配置开发信息

注意

这里只需要设置以下两个字段:


应用主页:配置为专属登录链接(例如:https://apaas.0codepaas.com/apaas/cw_sign_in?cwCorpId=xxxxxxxx)

可信域名:配置为专属登录链接中的域名(例如:apaas.0codepaas.com)


注意:需要校验可信域名归属后,才能上线应用(代开发应用详情/使用配置/编辑)
可以通过https插件进行域名校验

5.2 配置应用权限

配置开发信息后,需要配置应用的权限

具体权限配置如下

确认以后,应用关联的企业的管理员会收到一条确认消息,打开消息并同意授权

客户授权后,可以点击查看企业已确认权限确认客户是否正确授权

5.3 配置试用策略

企微要求:上线应用必须设置试用策略

6.代开发应用上线

所有配置信息都确认没有问题后,需要将代开发应用提交上线


审核上线应用

注意

这里需要选择开发应用上线,不是选择开发模板上线


提交应用上线

提交上线后等待审核通过,审核通过后将应用修改为上线状态即可

点击提交上线


设置可见范围

提交上线后,应用关联的企业的管理员会收到以下确认消息

点击查看详情,并设置查看范围

特别说明

这里需要告知客户,一定要设置查看范围为,才可以获取到企微下所有的部门

设置完查看范围后,企微的状态将变为已启用

提示

自此企微绑定完成,可以正常使用企微相关的功能了

7.购买接口需求

企微要求需要购买接口许可后才可以调用其接口,可以在服务商管理后台为客户购买许可

注意

后续接口的续费和管理均可在服务商管理后台进行维护,详细参考:定价方案使用流程

8.特别说明

以下为绑定企业微信的特别说明事项,了解之后可以更好的使用企业微信

8.1 默认密码

组织绑定企微后,默认只能在企微中使用系统。如果需要在网页浏览器中使用,可以采用以下方式


方式1:默认密码

后台配置了默认密码并重启服务后,所有后续加入组织的企微用户都可以使用此密码登录

提示

鼠标移入成员头像即可查看成员的账号


方式2:修改密码

如果没有配置默认密码,那么可以使用超管账号(admin)直接设置账户密码