企业微信助理接入教程：在群里 @机器人 就能下发团队协作任务
教你在企业微信里创建 API 模式机器人并与 WorkBuddy 绑定，实现 @机器人 下达任务、自动执行并把结果回传到群。含管理员与成员两条路径、长连接配置与常见问题。
很多公司的企业微信群每天在干的事：@某个人"把这个表发我"、"进度到哪了"、"这批单子对一下"。人不多的时候可以扛，人一多就变成消息队列——消息刷得比处理得快。
企业微信助理的思路是把队列里的那个人换成 WorkBuddy：你在群里 @机器人 说一句话，电脑上的 WorkBuddy 接单、执行、把结果甩回群里。可以是专属任务群、发布通知、任务提醒，甚至是某些需要"批准"的操作。
先确认三件事 #
- WorkBuddy 版本 ≥ 4.6.4。
- 有一个企业微信账号。没有公司组织也能用——官网可以免费注册企业，几人小团队也建得起来。
- 那台电脑保持开机运行。企微助理是"电脑端执行、群里收发"，电脑一关，群里@谁都没用。
两条路径：管理员建 vs 成员建 #
企业微信里机器人有两个创建入口，二选一即可，但权限范围不同。
| 对比项 | 管理员路径 | 普通成员路径 |
|---|---|---|
| 入口 | 企微管理后台（work.weixin.qq.com） | 企微客户端 |
| 菜单层级 | 安全与管理 → 管理工具 → 智能机器人 | 工作台 → 智能机器人应用 |
| 创建方式 | 创建机器人 → 点左下角「手动创建」→「API 模式创建」 | 创建机器人 → 手动创建 → API 模式创建 |
| 填写项 | 机器人名称、可见范围 | 机器人名称、可见范围 |
| 关键动作 | 先保存，再在右侧「API 配置」选「使用长连接」 | 创建后选择「使用长连接」 |
| 适用 | 有后台权限的 IT/行政 | 成员自助，管理员需预先开通应用权限 |
无论哪条路径，都必须走到「API 模式创建」，并明确选择「使用长连接」。选错模式后面会白忙半天。
绑定 WorkBuddy 与机器人 #
固定位置：WorkBuddy 左下角头像 → 设置 → 助理设置 → 集成(BETA) → 企微助理集成 → 配置。
进入配置后有两条填法：
方式 A：快捷绑定接入（推荐）
点「快捷绑定接入」，用企业微信扫码授权，机器人自动关联。步骤最少，不容易填错。
方式 B：手动填写 Bot ID + Secret
在配置里选择「WebSocket 长连接」，把企微后台拿到的 Bot ID 与 Secret 分别粘进去，填完点「注册」，状态变为「已连接」即成功。
为什么优先选长连接
| 对比项 | WebSocket 长连接（推荐） | 传统回调模式 |
|---|---|---|
| 需要公网服务器吗 | 不需要 | 需要 |
| 要填 URL、Token、EncodingAESKey 吗 | 不需要 | 全部要填 |
| 端口/防火墙配置 | 无 | 要放行、要备案 |
| 私有化部署企微 | 需额外填自定义 WebSocket 地址 | 基本走不通 |
| 上手指数 | 填两个字段点注册 | 需开发者介入 |
长连接的本质是 WorkBuddy 主动向外建立一条持续连接的通道，平台推消息过来就有人接——你不用给自己的电脑准备一个能被互联网访问的地址。对绝大多数中小企业，这就是唯一省事的选择。
私有化部署的企业微信
如果你的企微是内部私有化部署（自建网关、不连公网服务），在长连接配置里还需要额外填写一个自定义 WebSocket 地址，形如：
ws://<网关地址>:<端口>/im_...ws:// 是明文协议，公司网络校验通常只放行 80/443；能否放行请直接问你们的 IT 或企微厂商，不要自己猜端口能不能过防火墙。地址填对，状态才会显示「已连接」。
一份可复制的配置核对清单 #
填完先别急着关窗口，照着这份清单逐项打勾：
{
"integration": "wework-assistant",
"mode": "websocket",
"botId": "粘贴企微后台的 Bot ID",
"secret": "粘贴企微后台的 Secret",
"publicDeployment": false,
"customWebSocketUrl": "",
"status": "已连接"
}四项必过：mode 是 websocket、botId 非空、secret 非空、status 为「已连接」。任一项不满足，群里就@不到东西。
验证是否打通 #
- 回到企微，找到刚创建的机器人所在群，或直接私聊机器人。
- 发送一条纯文字指令，例如"用一句话介绍你自己"。
- 观察：是群/会话里有人回，还是电脑上 WorkBuddy 窗口在跑。
- 再发一条涉及本地文件的指令（读一个你电脑上的文件），能读到才算本地环境打通。
第 4 步最关键。只回一句"我是机器人"说明通道是通的；能读本地文件才说明它真在替你的电脑干活。
落地玩法 #
- 专属任务群：建一个只有项目相关人的群，机器人常驻，@它派单。
- 发布通知：把公告、变更说明交给它排版后推到全员群。
- 任务提醒：设定条件（如某个文件没更新、某个表没填）自动在群里提醒责任人。
- 批准操作：需要人工拍板的动作，先在群里@负责人，确认后再执行。
常见坑与 FAQ #
Q1：管理后台里找不到「智能机器人」。
先确认登录的是管理员账号；再看企业是否已完成开通；小团队可先用官网免费注册的企业账号体验。
Q2：选了「API 模式」但不知道 Bot ID 在哪。
管理员路径下，机器人必须先保存，保存后右侧「API 配置」才有完整信息；没保存就关页面，ID 是拿不到的。
Q3：配置里一直显示「未连接」。
检查三点：WorkBuddy 是否在运行并已完成配置填写、Secret 是否复制完整（企微后台复制经常带空格）、企微机器人的可见范围是否包含当前账号。
Q4：长连接到底需不需要服务器？
不需要。 长连接由 WorkBuddy 这边主动发起，只要电脑能上网就行。只有"URL 回调"模式才需要一台公网可访问的服务器。
Q5：私有化部署的地址怎么填？
按 ws://<网关地址>:<端口>/im_... 的格式向企微厂商索要，WorkBuddy 不会替你猜。
Q6：群里@了机器人没反应。
先确认该群是否真的添加了这个机器人（群设置里查）；再确认 WorkBuddy 电脑端在运行；最后看绑定状态是否为「已连接」。
Q7：一个企业能绑多个机器人吗？
可以。不同机器人对应不同可见范围与群，适合按部门拆分任务。但绑定哪台电脑上的 WorkBuddy，要看那台机器的配置指向哪个机器人。
Q8：同事在别的群 @ 机器人，机器人不理怎么办？
回到企微后台看该机器人的可见范围是否包含那个部门/群。可见范围是企微侧的开关，不是 WorkBuddy 能覆盖的，改范围后要重新保存并生效，必要时发一次版本。
Q9：群里机器人回复的内容太长，刷屏了怎么办？
这正是"配角色"没做到位的症状。在助理的角色提示词里写死输出约束：几段、每段几句、要不要带 @、要不要附文件。给 AI 一条硬规则，比事后在群里喊" verbose 一点"有用得多。
小结 #
企业微信助理的价值不在"群里多个会回话的玩意儿"，而在把重复性的指派、催办、通知动作从人身上卸下来。路径上先选长连接，公网服务器都可以省掉。
本系列属于「专家与连接器」模块。团队要批量开通、统一命名与可见范围、配好角色提示词，本站提供 1v1 部署陪跑，一次把权限、机器人、绑定验收做完整。
相关阅读：微信助理绑定教程 · WorkBuddy 自动化定时任务 · 用 WorkBuddy 接单变现