线报酷线报酷
文档首页 / 用户中心设置 / 企业微信应用/家校推送

企业微信应用/家校推送

2025-07-19 …
入口(2026-10 新版推送体系):登录 → 用户中心 → 信息推送设置 → 推送渠道 → 「新增推送渠道」→ 选择「企业微信」。渠道只管"发到哪",推什么内容到「推送规则」里配置;支持云端直发与浏览器挂机两种方式。整体架构见信息推送设置;同一类型可建多个渠道,用备注名区分。
\n

两种推送方式介绍

线报酷提供两种微信推送方式:

  1. 家校推送(注册选"教育")

    • 未认证可添加1000名微信推送

    • 注册时必需选择"教育->学前教育"行业

  2. 应用推送(通用场景)

    • 未认证可添加200名成员推送

    • 行业类型不限(建议选择"教育->学前教育") 

⚠️ 建议使用微信小号注册企业微信,避免主号因异常检测无法使用企业微信功能

⚠️ 建议注册选择教育行业,这样子两种推送都可以使用到。


准备工作

  1. 安装线报酷高级扩展油猴脚本

  2. 一台可以挂机的电脑浏览器/服务器

  3. 企业微信注册/登录:

线报酷微信家校推送配置流程 - 线报酷


基础配置步骤(通用)

1. 获取企业ID

访问:https://work.weixin.qq.com/wework_admin/frame#profile/enterprise

  • 在企业信息下方找到"企业ID"

  • 如未显示,请刷新页面或重新登录

2. 创建应用并获取AgentId和Secret

访问:https://work.weixin.qq.com/wework_admin/frame#/apps

  • 新建应用:名称/描述/图标可自定义

  • 应用可见范围选择最顶上的选项(这样子全部人可以收到)

  • 应用主页填写:

  • 记录AgentId(应用ID)

  • 点击查看Secret,通过发送到企业微信APP获取密钥

image.png


image.png


3. 设置可信域名和IP(2022年10月后注册必需)

  1. 在应用设置中找到"可信域名"选项

  2. 填写线报酷域名:new.xianbao.fun 或您自己的备案过的域名

  3. 如需协助认证,请联系微信xianbao_fun

  4. 设置可信IP:

    • 查询您的IP地址(可通过百度搜索"ip")

    • 将IP添加到可信IP列表

image.png

image.png


家校推送特有配置

1. 注册注意事项

  • 企业名称将成为推送显示名称(未认证仅可修改一次)

  • 注册时行业类型必须选择:教育->学前教育

2. 绑定应用到家校沟通

访问:https://work.weixin.qq.com/wework_admin/frame#/industry/edu/canUseApps

  • 添加您刚才创建的应用

  • 如不显示应用,请检查是否设置了应用主页

3. 获取家校沟通码

访问:https://work.weixin.qq.com/wework_admin/frame#industry/edu/contacts

  • 扫码订阅应用消息

image.png

4.修改家校推送头像

访问:https://work.weixin.qq.com/wework_admin/frame#industry/edu 

image.png


应用推送特有配置

微信绑定企业微信

访问:https://work.weixin.qq.com/wework_admin/frame#profile/wxPlugin

  • 获取二维码,使用普通微信扫码绑定

  • 可在该页面修改插件头像

image.png


最终设置

  1. 在线报酷用户中心填写:

    • 企业ID

    • AgentId(应用ID)

    • Secret(密钥)

  2. 保存设置并开启推送开关

  3. 保持浏览器标签页开启(需常驻浏览器运行)

image.png

image.png


常见问题与提示

  1. 推送频率限制:

    • 每天不超过账号上限×200人次

    • 同一成员每分钟不超过30条

  2. 成员数量限制:

    • 家校推送:未验证2000人,验证后更多

    • 应用推送:未验证200人,验证后更多

  3. 修改设置:

  4. API参考:


报错排查:301002「not allow operate another agent with this accesstoken」

报 errcode 301002 的含义是:当前 access_token 与你要操作的应用对不上(token 是 A 应用的,却拿它去操作 B 应用)。它不是频率限制、也不是 IP 白名单问题(那是 60020),常见成因只有两类:

  1. AgentId 与 Secret 不是同一个应用(最常见):一个应用的「Secret」只能操作它自己的「AgentId」。如果你把 A 应用的 Secret 和 B 应用的 AgentId 填在同一个渠道里,就会稳定报 301002。

  2. 选了「家校/外部联系人」模式,但该应用没绑定到家校沟通:家校通知走的是独立接口,企业微信要求先把应用添加到「家校沟通」里(见上文《家校推送特有配置 → 绑定应用到家校沟通》),未绑定的应用即使 Secret/AgentId 都对,也会返回 301002。

处理步骤:

  1. 到 企业微信管理后台 → 应用管理,打开你填的那个应用,核对页面上的 AgentId 与你渠道里填的是否一致;并确认渠道里的 Secret 是点这个应用里的「查看 Secret」拿到的(不是另一个应用、也不是「企业密钥/通讯录密钥」)。

  2. 如果是「家校/外部联系人」模式:到 管理后台 → 家校沟通(/wework_admin/frame#/industry/edu/canUseApps)把该应用添加进去;看不到应用时先给应用设置一个「应用主页」,保存后再回来添加。

  3. 以上任一改动后,回到渠道弹窗点一次「测试」。仍失败时点错误提示里的 devtool/query?e=301002 链接,企微会直接告诉你该 token 实际属于哪个应用,对照渠道里填的 AgentId 即可定位。

提示:云端与挂机可以同时使用同一个应用——两边都只是调用企微接口,不会互相顶掉 token。真正要避免的只有"AgentId 与 Secret 错配"和"家校模式未绑定应用"这两点。

其他常见报错

  • errcode 60020:推送来源 IP 不在应用的「企业可信IP」白名单。云端推送请添加本站服务器 IP 58.49.150.154;挂机推送请添加你本机出口 IP(家庭宽带 IP 会变)。

  • errcode 42001 / 40014:access_token 过期,稍后自动重试即可。

  • errcode 45009:接口调用超过频率限制。

如有问题,请检查推送页面报错提示,并确保所有开关已正确开启。


\n

最近更新

\n
    \n
  • 2026-10:对应渠道类型「企业微信」(应用/家校通知);配置入口迁至推送渠道弹窗。
  • \n
  • 2026-10-14:修复「家校/外部联系人」模式推送恒失败(发送体缺少必填的 agentid 字段,导致企微固定返回 301002);并补充 301002 的排查说明(AgentId 与 Secret 错配、家校模式未绑定应用)。
  • \n