Appearance
企业微信
平台集成企业微信
,可以实现:企微单点登录、组织信息同步、企微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
特别说明
这里必须将Token
和EncodingAESKey
配置到管理后台/系统配置/企业微信
,并重启服务
后才能验证通过
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)直接设置账户密码
