做 SCRM，最后都要解决一件事：业务系统能不能驱动企业微信完成客户运营。
官方接口能覆盖一部分，但客服经常会遇到：客户群发不了实时消息、群机器人进不了外部群、加好友拉群发圈要员工反复点。
先说结论
大多数团队真正要用的不是 100 个接口，而是这条链：
- 账号在线
- 客户加过来
- 打标签、分群
- 私聊 / 群聊触达
- 自动回复和转人工
- 朋友圈维持活跃
接口也按这个顺序接，返工最少。先发通一条私聊，再发通一条客户群，再接 Webhook。
下面这些能力都能在文档里找到对应 method：API文档
最小闭环
QiWe API 按 REST 提供登录、联系人、群、消息、朋友圈、会话、标签等模块，适合接到已有 SCRM。
常用模块
1. 登录和设备
关键字段：Token、guid。注意登录地区和扫码时限。
2. 联系人 / 好友
识别新客户、查好友关系。
3. 标签
意向、成交、售后分流。标签由 SCRM 定义，企微侧同步，不要两边各打一套。
4. 群管理
建群、邀请成员、群信息维护。这是外部群能力的基础。
5. 消息收发
最常用/msg/sendText。toId：人用userId，群用roomId。
6. Webhook / 会话
没有回调，SCRM 只能单向群发，不像客服系统。
7. 朋友圈
文本搭配图片、视频、链接（每次选一种素材类型）。
最小字段表
| 业务对象 | 建议保存的 ID | 用来做什么 |
|---|---|---|
| 坐席/机器人账号 | guid | 所有调用都要带 |
| 客户 | userId | 私聊、拉群、打标签 |
| 客户群 | roomId | 群发消息、群管理 |
| 消息 | msgServerId 等 | 撤回、引用回复 |
ID 一旦入库，就不要靠昵称、群名去对。
importrequests API="http://manager.qiweapi.com/qiwe/api/qw/doApi"HEADERS={"X-QIWEI-TOKEN":"YOUR_API_KEY","Content-Type":"application/json",}defsend_text(guid,to_id,content):returnrequests.post(API,headers=HEADERS,json={"method":"/msg/sendText","params":{"guid":guid,"toId":to_id,"content":content,"isNoNeedRead":True,},},timeout=30,).json()联调验收
- 发通一条私聊，
code == 0且自己能收到 - 发通一条客户群消息，消息出现在该
roomId - 接 Webhook，做关键词回复
- 接拉群和标签
- 最后再接朋友圈和复杂素材
每一步单独验收，避免一上来做大而全。
再扩一步
主链路通了，再把工单、AI 客服接到同一套guid。产品模块总览也可以先看 QiWe API 官网。
总结
企业微信 SCRM 对接 API，先接加好友、拉群、发消息，再补周边。统一 POST、按模块换method即可。
