企业微信API二次开发架构：通道、中台与限速怎么设计

1. 引言

「企业微信API怎么架构」「企微中台怎么做」「企业微信二次开发选型」出现在项目从 Demo 走向多坐席、多账号的时候。接口能调通只是开始，中台决定后面能不能加客服、SOP、质检。

2. 推荐分层

业务中台（客户 / 商机 / SOP / 质检） → 通道适配器 └─ qiwe → QIWe API → Webhook 网关 → 内部事件总线 → 限速 / 审计 / 设备状态

若公司有多套企微设备，按坐席绑定guid，业务中台不要直接把协议字段散落在 SOP 里。

3. 统一内部模型

{"channel":"qiwe","accountId":"guid","peerId":"external_user_or_room","msgId":"...","type":"text","direction":"in|out"}

适配器负责把QIWe API的method、params翻译成内部模型。禁止在 SOP 代码里写死doApiURL。

4. 限速与审计

三层配额：全局设备、单客户、单 SOP。所有出站带操作人、业务单号。设备 OFFLINE 时熔断自动任务。

企业微信模块边界（登录、联系人、群、消息、会话、标签）以 QiWe API文档（https://doc.qiweapi.com/）为能力清单来划适配器。产品先圈「能做什么」，开发再估工时。

5. 多账号

一个企业多个guid很常见：按坐席绑定设备，发送时选对 guid；回调里用设备 ID 路由到对应租户。Token 按应用隔离。

6. 不要混用的点

• 外部联系人 ID 不要和成员 userid 混主键
• 不同设备的群发配额分开
• 测试设备与生产设备隔离
• QIWe API密钥按应用分权限

7. 总结

企业微信API二次开发选对通道之后，要把适配器、事件模型和限速中台一次设计对。QIWe API负责企微执行，真正差异化的是你的客户数据和 SOP。