企业微信应用第三方模式配置
简介
如果企业采用企业微信办公,团队成员可以无需额外注册平台账号,管理员无需额外创建组织架构,直接使用企业微信的组织架构,简化操作步骤。
平台的企业微信应用绑定采用了企业微信【第三方应用】的模式对接,使用该模式对接,可以获取更多的能力。
前置准备
1、在企业微信申请成为ISV服务商:点此申请此过程请自行申请
2、私有云后台【购买私有云后自行进入】
对接步骤
1. 登陆私有云管理后台
依次进入【第三方管理】->【企业微信应用配置】->切换到【企业微信第三方配置】

2. 登陆企业微信服务商后台
点击【服务商信息】,如果这里提示需要认证主体信息,则需要企业先对企业进行认证,认证后方可进入下一步操作

3. CPORP_ID获取
登陆企业微信服务商后台,复制这里的CorpID到后台CPORP_ID中


4. 创建应用
在【工具】页面点击【应用开发】->【应用开发】->【网页应用开发】->【创建应用】

5. 应用信息配置
填写应用的基本信息、应用权限和配置开发信息
-
基础信息部分较为简单,只要输入自己企业的相关信息即可,这里不做过多介绍。

-
应用权限部分需留意最下方成员敏感信息处,需勾选
头像选项;其他权限请企业根据实际情况选择。

留意最下方头像需勾选
申请理由可填,成员头像用于设置为用户头像

- 配置开发信息部分需要注意
Token和EncodingAESKey的设置
这两项可以指定或随机获取,但是获取到的这两个值需要先保存下来,下一步操作需要填写。

上方链接参考:【表格中abc.xyz.com替换为自己的实际域名】
| 配置项: | 链接 |
|---|---|
| 应用主页: | https://abc.xyz.com/index.php?corp/qywx_come |
| 可信域名: | abc.xyz.com |
| 安装完成回调域名: | abc.xyz.com |
| 业务设置URL: | https://abc.xyz.com/index.php?qyweixin/callback |
| 数据回调URL: | https://abc.xyz.com/index.php?qyweixin/index |
| 指令回调URL: | https://abc.xyz.com/index.php?qyweixin/auth |
注:abc.xyz.com 替换成自己的域名即可,其他信息无需修改
6. 可信域名校验
1、打开新创建的应用,找到使用配置,点击后面的编辑

2、点击校验可信域名

3、下载域名校验文件发给官方工作人员上传到私有云站点网站根目录

4、域名所有权验证点击确认按钮
7. SUITE_ID、 SUITE_SECRET获取
打开新创建的应用,找到SuiteID和Secret将这两项粘贴到对应的SUITE_ID和SUITE_SECRET位置。

填写位置如图所示

8. 应用截图添加
拖动页面至最下方,添加应用截图

注意:这里的截图格式需按企业微信官方需求认真处理
手机端需上传企业微信内打开的应用界面截图。建议上传5张能体现完整应用功能的截图
桌面端需上传电脑版企业微信客户端打开的应用界面截图,截图要能看出是从企业微信客户端进的。建议上传5张能体现完整应用功能的截图
9. Token 、EncodeingAESKey获取
返回并点击通用开发参数,将第5步中的Token 和 EncodeingAESKey填写到相应的输入框内。
如图所示
系统事件接收URL和第5步的
数据回调URL一致
Token和EncodeingAESKey和第5步填写的保持一致

将上图内容复制到后台对应的位置并保存

最后点击企业微信通用开发参数里的确认按钮
10. 应用回调配置校验
回到【应用开发】->【网页应用开发】当中,进入新添加的应用,找到回调配置,点击后面的编辑

点击申请校验,通过后点击确定

点击确定后,回调配置旁边有个刷新Ticket点击进行刷新Ticket
11. 定价配置
【应用开发】->【网页应用开发】,进入新添加的应用,找到功能及定价表,进行设置(可直接下载企业微信提供的模板进行修改)

【应用开发】->【网页应用开发】,进入新添加的应用,找到定价策略,进行设置(可添加设置为免费版、会员版等,具体按自己公司收费标准进行调整)

12. 应用适配设置
【应用开发】->【网页应用开发】,进入新添加的应用,找到应用适配,进行设置

13. 服务商隐私政策上传
【应用开发】->【网页应用开发】,进入新添加的应用,找到服务商隐私政策,点击上传

选择模板生成

根据要求进行填写

完成后点击确定
14. 第三方服务协议上传
【应用开发】->【网页应用开发】,进入新添加的应用,找到第三方服务协议,点击上传(协议可下载企业微信提供的模板进行修改)
协议文件要命名为:XXX服务协议.docx,XXX指应用名称

15. 配置客服
选择应用客服,进行配置

关联微信客服账号并添加客服人员

16. 域名设置
从下方地址进入,【登录授权】中填写对应的站点域名
https://open.work.weixin.qq.com/wwopen/developers/tools#/sass/power/login/old 进入

17. IP添加白名单
进入【服务商信息】页面,添加网站IP到白名单当中,网站ip可用站长工具输入网站域名进行查询获取

18. 提交上线申请
进入【工具】->【应用开发】->【应用开发】->【应用和模板上线】,点击提交上线按钮,耐心等待审核。 提交成功后,等待企业微信审核(约1~2天)。

审核成功后,找到待上线应用,点进入。

点击提交上线

19. 企业微信收费配置
进入【收银台】->【收银台API密钥】页面获取收银台Secret

进入【企业后台管理】->【通讯录】->【企业微信成员列表】页面获取成员账号(如果账号字段没有显示出来可点击进入成员详情获取)


将获取内容复制到后台对应的位置并保存

20. 推广二维码设置
此部分内容选填,如需进行设置,请按照如下流程操作,并将推广包ID填写到后台设置中。


企业微信应用自定义菜单配置
企业微信应用菜单可配置系统的链接,实现点击菜单跳转指定页面。
注意:系统链接后方加入参数 qywxCorpId=$CORPID$,可实现自动登录。
如:将我的待办链接配置在菜单下,可实现点击菜单直接跳转我的待办。
https://abc.com/team/todo?qywxCorpId=$CORPID$
| 设置入口:企业微信应用开发-应用详情-自定义菜单 | 效果 |
|---|---|
![]() |
![]() |
如果在企微代开发应用 或 企业微信自建应用中配置菜单,qywxCorpId需要填入团队ID
如:https://abc.com/team/todo?qywxCorpId=wpacI8DQAAdBx6WK3ocQxlG23SgNAu
团队ID获取方式:可登录系统-通讯录-外部联系人-添加外部联系人-公开链接邀请,从公开链接中获取,如下图:



