企业微信运营助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-wecom-assistant。
技能介绍
要解决什么问题
团队把通知、告警、日报和客户运营都堆在企业微信上,但官方文档分散在「自建应用」「群机器人」「客户联系」「审批」几条线里。接入时常见卡点包括:access_token 只有 7200 秒却反复现取、message/send 报 secret 或接收人权限错误、webhook 与自建应用混用凭证,以及 SCRM、审批各自要用不同的 corpsecret。
技能如何工作
本技能按目标场景组织工作流:先确认你要的是应用消息、群机器人、客户联系还是审批,再核对 corpid / corpsecret / agentid 或 webhook key;未配置时指向 USAGE.md。
核心能力与官方接口骨架包括:
- 自建应用消息:
GET gettoken获取并缓存 token,再POST cgi-bin/message/send,需agentid与接收人(userid / 部门 / 标签)。 - 群机器人:
POST webhook/send?key=,无需 token,适合轻量告警。 - 客户联系 (SCRM):用客户联系专用 secret 换 token,涉及外部联系人、标签与会话存档(需成员同意)。
- 审批:通过审批应用 API 提交与查询(需后台开启权限)。
失败时会结合错误码提示排查方向:secret 错误、应用未加入可信、接收人无权限等。API 根域名为 https://qyapi.weixin.qq.com/cgi-bin/,以企业微信官方文档最新版为准。
边界与注意
仅针对本企业已授权的应用与数据;corpsecret 只存本地配置,不泄露、不回传。群发与日报需遵守企微频控与防骚扰规则。客户联系涉及外部个人信息,须符合《个人信息保护法》与企微外部联系人规范。技能提供方法指引与调用骨架,不代替用户持凭证调用真实接口;企业微信无官方 MCP,需自行基于官方 API 实现。
使用场景
- 运维需在故障发生时通过群机器人 webhook 把告警推到指定企微群,且不想维护 access_token
- HR 或行政要用自建应用给指定部门 userid 推送制度变更通知,需核对 agentid 与接收人权限
- 销售运营要对接客户联系 API 维护外部联系人标签,并了解会话存档所需的成员同意与 secret 类型
- 内控或 IT 要把 OA 审批结果通过审批应用 API 查询回写,或在每晚自动把日报发到企微应用消息
适合人员
- 负责企微自建应用与 corpid/corpsecret 保管,需要写 message/send 调用骨架的 IT 或集成工程师
- 值班运维,要把监控告警接到企微群机器人并区分 webhook 与自建应用两种接入方式
- 销售或客户成功负责人,要在企微侧管理外部联系人与 SCRM 相关 API,并遵守外部联系人合规要求
- 流程数字化负责人,要把内部审批流与企微审批 API 对接,或把业务日报固定推送到员工企微