本文将指导企业微信服务商如何通过微搭企业微信集成 - 服务商代开发的方式来上线企业微信应用。
操作步骤
步骤1:初始化服务商信息
1. 进入 企业微信集成 页面,单击顶部服务商管理后台链接或服务商代开发开始设置,进入服务商信息填写页。
![](https://qcloudimg.tencent-cloud.cn/image/document/8eb659de31a408c8ddb1c56e80b603ba.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/8eb659de31a408c8ddb1c56e80b603ba.png)
2. 填写服务商信息。
![](https://qcloudimg.tencent-cloud.cn/image/document/91a87fecbb36a31511ef76d039527907.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/91a87fecbb36a31511ef76d039527907.png)
再前往企业微信服务商后台 > 服务商信息,将可信 IP 设置为 IP 白名单中:
![](https://qcloudimg.tencent-cloud.cn/image/document/ed78cbbf2dd7a629fc43833788ab58cc.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/ed78cbbf2dd7a629fc43833788ab58cc.png)
步骤2:创建代开发模板
完成设置企业微信服务商信息后,进入创建代开发应用模板步骤:
![](https://qcloudimg.tencent-cloud.cn/image/document/28f27f7b2964c7507790e3ceb628096e.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/28f27f7b2964c7507790e3ceb628096e.png)
1. 前往 企业微信服务商后台 创建代开发应用模板:
![](https://qcloudimg.tencent-cloud.cn/image/document/e43bf07bac2a6c701cac0d6c6b438388.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/e43bf07bac2a6c701cac0d6c6b438388.png)
2. 填写模板基础信息:
![](https://qcloudimg.tencent-cloud.cn/image/document/6645400faa2cd0a175daf74b654d2be7.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/6645400faa2cd0a175daf74b654d2be7.png)
3. 使用创建代开发应用模板步骤提供的代开发模板信息,填入配置开发信息:
![](https://qcloudimg.tencent-cloud.cn/image/document/d6c47fd32f338b49b591e57b35ab5ea5.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/d6c47fd32f338b49b591e57b35ab5ea5.png)
4. 将创建的代开发应用模板的信息填入创建代开发应用模板步骤表单:
4.1 单击查看模板信息。
![](https://qcloudimg.tencent-cloud.cn/image/document/ada2f20d484f39e4d8b957101686e74d.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/ada2f20d484f39e4d8b957101686e74d.png)
4.2 找到模板名称、模板 ID 和模板 Secret 信息:
![](https://qcloudimg.tencent-cloud.cn/image/document/24c03623dabfb0eca3b250f3b9958af9.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/24c03623dabfb0eca3b250f3b9958af9.png)
4.3 将上面获取到的信息填入代开发模板信息表单中:
![](https://qcloudimg.tencent-cloud.cn/image/document/718134205e74240810949dc483c79325.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/718134205e74240810949dc483c79325.png)
5. 刷新 Ticket:
![](https://qcloudimg.tencent-cloud.cn/image/document/0263f85c4e1dac950af393ed0cabbec9.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/0263f85c4e1dac950af393ed0cabbec9.png)
6. 单击完成设置,成功进入代开发应用管理列表:
![](https://qcloudimg.tencent-cloud.cn/image/document/3e7bd174596288a4cdf3305a8f41bb19.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/3e7bd174596288a4cdf3305a8f41bb19.png)
7. 在企微服务商后台进行代开发应用上线(查看指引),并等待审核通过:
![](https://qcloudimg.tencent-cloud.cn/image/document/19fa2c6106eb01a1d821f8bdd29391f0.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/19fa2c6106eb01a1d821f8bdd29391f0.png)
步骤3:企业授权代开发
代开发应用模板上线后,会得到授权二维码,可以给待授权企业的企微管理员进行扫码授权:
![](https://qcloudimg.tencent-cloud.cn/image/document/e4d549c7c858decf837080a754ddb247.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/e4d549c7c858decf837080a754ddb247.png)
1. 进入微搭的代开发应用详情页,对已授权企业进行环境关联:
![](https://qcloudimg.tencent-cloud.cn/image/document/bdc642ac96b952d5b270414cf81195bf.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/bdc642ac96b952d5b270414cf81195bf.png)
2. 选择任意一个可用环境进行关联:
![](https://qcloudimg.tencent-cloud.cn/image/document/a223930c0d0c55416bf54f89bfd91f77.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a223930c0d0c55416bf54f89bfd91f77.png)
3. 单击环境 ID。
![](https://qcloudimg.tencent-cloud.cn/image/document/6c57f576fb792e27058d3fa48c15d58b.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/6c57f576fb792e27058d3fa48c15d58b.png)
进入关联环境,查看企业微信集成信息。
![](https://qcloudimg.tencent-cloud.cn/image/document/00329c4d9847f742d7b7ac63e8f6e12a.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/00329c4d9847f742d7b7ac63e8f6e12a.png)
步骤4:开始应用代开发
1. 进入企微服务商管理后台代开发应用模板详情,对已授权企业进行开始代开发应用:
![](https://qcloudimg.tencent-cloud.cn/image/document/68afbb9d7a98ea5e974d06d99ec96372.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/68afbb9d7a98ea5e974d06d99ec96372.png)
2. 确认应用基础信息:
![](https://qcloudimg.tencent-cloud.cn/image/document/602d886e908d1d50494efad1b1f12494.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/602d886e908d1d50494efad1b1f12494.png)
3. 根据企业微信集成详情页的信息,配置开发信息:
![](https://qcloudimg.tencent-cloud.cn/image/document/f62783e2927a6bfa83b47154e3ecbd5b.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/f62783e2927a6bfa83b47154e3ecbd5b.png)
应用主页地址可以填写企业工作台地址或指定明确的模型应用地址:
![](https://qcloudimg.tencent-cloud.cn/image/document/56c35a6fc30c3412b8bc9f90975a05bc.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/56c35a6fc30c3412b8bc9f90975a05bc.png)
4. 修改权限设置:
![](https://qcloudimg.tencent-cloud.cn/image/document/31d1bfbfdb4795610c3667b38a995e12.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/31d1bfbfdb4795610c3667b38a995e12.png)
根据应用所需要权限选择,并且等待企业微信管理员同意授权。
5. 校验可信域名归属:
在代开发模板单击编辑:
![](https://qcloudimg.tencent-cloud.cn/image/document/a781c7877518f605b2d6f74272329188.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a781c7877518f605b2d6f74272329188.png)
复制可信域名:
![](https://qcloudimg.tencent-cloud.cn/image/document/4e65cc4122e2ffe1328127878ecbbbc4.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/4e65cc4122e2ffe1328127878ecbbbc4.png)
下载校验文件,并上传:
![](https://qcloudimg.tencent-cloud.cn/image/document/62ae2e6af332af094c690df52624abf6.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/62ae2e6af332af094c690df52624abf6.png)
在企业微信集成信息页面,单击编辑。
![](https://qcloudimg.tencent-cloud.cn/image/document/a7529fb7e6f06905886dc9d196706e9b.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a7529fb7e6f06905886dc9d196706e9b.png)
在域名归属验证选项上传。
![](https://qcloudimg.tencent-cloud.cn/image/document/220e0f241e3ee22dfddce16b5147daf4.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/220e0f241e3ee22dfddce16b5147daf4.png)
上传后单击保存,即可完成域名校验。
![](https://qcloudimg.tencent-cloud.cn/image/document/fd4a40b6e463a54b858264f2d7cfc606.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/fd4a40b6e463a54b858264f2d7cfc606.png)
完成全部设置后,可以在此环境进行应用开发。
步骤5:代开发应用上线
完成应用开发后,可以开始代开发应用上线。
1. 前往企业微信服务商后台 > 代开发应用上线 页面,单击提交上线。
![](https://qcloudimg.tencent-cloud.cn/image/document/01a5fdcb19fb7bcff79bf16e77a6055b.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/01a5fdcb19fb7bcff79bf16e77a6055b.png)
2. 选择对应的代开发应用模板及需要上线的代开发应用。
![](https://qcloudimg.tencent-cloud.cn/image/document/dfab2bc2b40bc5093e1a8e261a630891.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/dfab2bc2b40bc5093e1a8e261a630891.png)
3. 等待审核通过后(状态变为待上线),进入审核详情,单击提交上线,完成应用上线。
![](https://qcloudimg.tencent-cloud.cn/image/document/f54e402b30c87f2a559ab8eb47217247.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/f54e402b30c87f2a559ab8eb47217247.png)
4. 已授权企业的企微管理员前往管理后台,修改应用可见范围。
![](https://qcloudimg.tencent-cloud.cn/image/document/27b6454899f5939b48e4753486109086.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/27b6454899f5939b48e4753486109086.png)
此时,微搭会自动同步可见范围至用户部门。
![](https://qcloudimg.tencent-cloud.cn/image/document/94c3fb0bb941355d79413df88fdf6fc6.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/94c3fb0bb941355d79413df88fdf6fc6.png)
5. 管理员前往企业工作台 > 系统设置 > 工作台设置 > 登录配置,设置企业工作台登录方式为企业微信登录(企业微信主体名称)。
![](https://qcloudimg.tencent-cloud.cn/image/document/652fa8c3c357af6ae79da6148d8a38e5.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/652fa8c3c357af6ae79da6148d8a38e5.png)
6. 在企业微信工作台访问应用即可。
![](https://qcloudimg.tencent-cloud.cn/image/document/a6a38a8478856ea7619634cf31ec8ff5.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a6a38a8478856ea7619634cf31ec8ff5.png)
FAQ
在企业工作台应用中,用户名显示为加密的 userid,如何显示用户昵称?
![](https://qcloudimg.tencent-cloud.cn/image/document/a77b24f67560b8b09dc8142010077e00.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a77b24f67560b8b09dc8142010077e00.png)
解决方法:
在数据模型 > 用户中,设置用户昵称为主列字段即可。
![](https://qcloudimg.tencent-cloud.cn/image/document/3392703ff79eca5a47fc98d5890ea225.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/3392703ff79eca5a47fc98d5890ea225.png)
展示如下:
![](https://qcloudimg.tencent-cloud.cn/image/document/02188075b02fd9873cc6f0b96deb116e.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/02188075b02fd9873cc6f0b96deb116e.png)