企业微信开通向导

开通进度

加载中…

1注册并认证企业微信

1. 打开 企业微信管理后台，用管理员微信登录。
2. 「我的企业」→「企业信息」，完成企业认证（已认证的企业，接口年费可为 0 元）。
3. 同一页复制 企业 ID（CorpId），贴到下面保存。

企业 ID（CorpId） 已经完成企业认证（管理后台企业名称旁有认证标）

2创建自建应用（拿 AgentId 和 Secret）

1. 「应用管理」→「应用」→「创建应用」。
2. 名称填「瑞辰研学」；可见范围勾选以后要加客户的员工（兼职销售、运营）。
3. 创建后进入应用详情，复制 AgentId 和 Secret。2023-12-01 后请用自建应用 Secret，不要用系统「客户联系」那套旧 Secret。

AgentId 自建应用 Secret 已经创建自建应用，并且可见范围包含要加客户的同事

3填企业可信 IP（否则 gettoken 会失败）

1. 打开「应用管理」→「应用」→ 点进 瑞辰研学（不要点「瑞辰教育」或「瑞辰卓越少年研学」）。
2. 在应用详情页往下滚，找到 企业可信 IP（有的版本在「开发者接口」下面）。点配置 / 添加。
3. 填入下面这台服务器的公网 IP（复制即可，不要改），保存。
4. 保存后再回本页点「测一下凭证」。成功就说明 CorpId + Secret + IP 已走通。
5. 若客户联系「可调用接口的应用」里该应用仍显示红色「未配置可信IP」：说明 IP 还没落到这个应用上。刷新企微后台，或退出重新登录后再看。没消掉之前，这一项勾不上。

已经把这台服务器 IP 加进企业可信 IP

4打开客户联系权限

1. 先做完第 3 步。列表里如果应用名旁边是红色「未配置可信IP」，现在还勾不了，必须先给「瑞辰研学」配可信 IP，刷新后再勾。
2. 三个应用只勾 瑞辰研学。「瑞辰教育」「瑞辰卓越少年研学」不要勾，研学对接用的不是它们。
3. 「使用范围」在客户联系 → 数据统计 → 权限配置，选实际加好友的员工；和「可调用接口的应用」是两回事。
4. 配好 IP 后，回到「设置可调用接口的应用」，红色提示消失，勾上「瑞辰研学」并保存。

官方说明： 客户联系概述 联系我 客户列表

客户联系使用范围已包含兼职销售 / 运营 「可调用应用」已勾选本自建应用

5配置接收事件服务器（加好友 / 删微回调）

正确入口（按顺序试）

1. 最常见：左侧菜单点「客户与上下游」（有的版本仍叫「客户联系」）→ 再点「客户」→ 页面上方或右侧有「API」或「设置」→ 里面才是「接收事件服务器」。
2. 还是没有左侧菜单：「应用管理」→「应用」→ 往下滚到系统应用（不是自建的「瑞辰研学」）→ 点开蓝色图标的「客户联系」→ 启用后，页面里有「接收事件服务器」。启用后左侧才会出现客户菜单。
3. 先把下面 Token、EncodingAESKey 已经保存在本页的值，原样粘到企微（不要再点「随机获取」，否则对不上）。URL 填下面这一行。
4. 保存时企微会访问我们的地址做校验。本页 Token / AESKey 没保存成功，企微那边保存会失败。

回调 URL（原样粘贴，不要加斜杠或参数）

Token EncodingAESKey（必须 43 位） 已经在企微后台保存接收事件服务器，保存成功没有报错

客户回调 回调配置

6绑定小程序（以后要对家长微信号）

1. 「我的企业」→「微信插件 / 小程序」把研学小程序绑到本企业。
2. 绑好后，客户详情接口才能返回 unionid，才能和家长账号对上。

已经绑定研学小程序（可后补，不影响先发联系我二维码）