企业微信三方应用上线指南

三方应用的授权链路：

• 企微服务商账号：用思店科技的企业微信登录 open.work.weixin.qq.com，首次需完成服务商信息登记（营业执照、联系方式）。
• 域名：三方应用所有回调、主页都必须挂在 www.sidianscrm.com 下（已备案、HTTPS 证书有效期至 2027-04）。
• 域名验证文件：企微域名归属验证要求站点根目录放置验证文件。生产环境已就位并验证可达：

若企微后台重新生成了新的验证文件名，把文件内容上传到服务器 /var/www/scrm/public/ 即可（找开发处理）。

1. 填写应用名称（对外展示给授权企业，如「思店智粉 SCRM」）、Logo、应用简介。
2. 创建完成后记录 SuiteID（wxe295… 开头）和 Secret——这两项下一步要登记进 SCRM。
3. 在「开发配置」中可看到回调配置项，先留着，第 4 步回来填。

1. 填入上一步拿到的 SuiteID、Secret。
2. 回调 Token / EncodingAESKey：可以由后台生成（保存后请完整复制，第 4 步要抄到企微后台）。
3. 保存后状态默认启用。

SCRM 侧的登记决定了回调验签密钥——企微后台和这里填的值必须完全一致，否则回调验签失败。

两条回调都按下面格式填（注意把 {suite_id} 替换成你的真实 SuiteID，企微只在这两个 URL 上做验签，路径参数错了收不到事件）：

Token / EncodingAESKey 抄 SCRM 后台登记的值。保存时企微会立即发 GET 验证请求（echostr），通过才算配置成功。

• 指令回调接收：suite_ticket（每 10 分钟推送一次）、create_auth / change_auth / cancel_auth / reset_secret。
• 数据回调接收：授权企业内部的通讯录变更、客户联系等事件。

验证回调是否通：SCRM 后台 →「套件管理」Tab →「回调事件」Tab，能看到 suite_ticket 事件持续进入且状态=完成，即链路健康。

权限配置：按业务需要勾选接口权限——客户联系（客户、群、朋友圈、聊天侧边栏）、通讯录只读、消息推送。权限范围决定了授权企业安装时看到的应用可见范围提示。

1. 企微会为每个套件提供测试企业（服务商后台「开发配置」页可查看测试企业的 CorpID 和登录方式）。用测试企业管理员登录企微。
2. 在 SCRM 后台点「安装链接」——系统自动申请 pre_auth_code 并拼出安装地址，复制后发给测试企业管理员，在企微中打开。
3. 管理员在授权页确认可见范围 → 授权完成会跳转到 auth-done 确认页。
4. 回到 SCRM「授权企业」Tab 验收：
   • 测试企业出现在列表中（名称 / corpid / agentid / 成员数 / 客户数）
   • 「回调事件」Tab 中 create_auth 事件状态 = 完成
5. 在测试企业的企微客户端验证：工作台能看到应用、打开主页正常（不报 domain_err）、能收到应用消息。

1. 服务商后台「版本管理与审核」→ 提交审核。审核重点：应用简介与实际功能一致、主页可正常访问、隐私条款（涉及客户数据的要写清用途）、权限最小化。
2. 审核通过后选择全网发布（也可先定向发布给指定企业）。
3. 发布后每个新客户的接入 = 运营在 SCRM 后台点「安装链接」发给客户管理员，授权完成即接入，无需任何技术配置。

审核常见被拒原因