企业微信开放能力知识库

问题

企业微信 API 多、凭证体系分层，常见错误不是不会写 HTTP，而是把 access_token 当成可随意重复获取、忽略 WelcomeCode 20 秒失效、混淆 follow_user 与 follow_info，或在服务商场景误用自建应用凭证。AI 生成代码时若只凭模型记忆，容易造出不存在的参数或漏掉限频、回调、幂等约束。

工作方式

本技能把企业微信开放能力拆成入口导航与多个子技能文档。收到需求后，先根据关键词判断属于自建应用、服务商代开发还是第三方应用，再定位对应子技能，例如通讯录、消息、客户联系、审批、微信客服、JS-SDK、ISV 凭证等。生成代码前会读取对应 .md 文件，按其中定义的参数、响应、频率限制和 Gotcha Guide 输出实现，而不是直接凭记忆拼接口。文档还强调 wecom-core 或 wecom-isv-core 是前置依赖，要求处理 access_token 缓存、errcode=-1 重试、42001/40014 刷新、HTTP 超时、corpid/corpsecret 环境变量隔离和日志脱敏。

适用边界

它适合企业微信服务端开发、CRM 对接、办公应用、微信客服、ISV/第三方应用等场景，尤其是需要减少 API 参数幻觉和补齐边界条件的工程实现。它不替代官方文档，也不应被视为运行时 SDK；涉及具体业务字段、安全审计、生产部署策略时，仍需以官方说明和实际环境验证为准。