做 SCRM，最后都要解决一件事：业务系统能不能驱动企业微信完成客户运营。
官方接口能覆盖一部分，但客服经常会遇到：
- 客户群发不了实时消息
- 群机器人进不了外部群
- 加好友、拉群、发圈要员工反复点
这时就需要一套更贴近账号操作的 API。QiWe API 按 REST 方式提供登录、联系人、群、消息、朋友圈、会话、标签等模块，适合接到已有 SCRM 或自己做轻量私域系统。
下面这些能力都能在文档里找到对应 method：QiWe API 文档
先对上私域主链路
大多数团队真正要用的不是 100 个接口，而是这条链：
- 账号在线
- 客户加过来
- 打标签、分群
- 私聊/群聊触达
- 自动回复和转人工
- 朋友圈维持活跃
接口也按这个顺序接，返工最少。
常用接口清单
1. 登录和设备
- 用途：把企业微信变成可调用节点
- 关键字段：Token、
guid - 注意：登录地区和扫码时限
2. 联系人 / 好友
- 用途：识别新客户、查好友关系
- 典型动作：获取联系人、配合标签做分组
3. 标签
- 用途：意向客户、成交客户、售后客户分流
- 建议：标签由 SCRM 定义，企微侧同步，不要两边各打一套
4. 群管理
- 用途：客户群运营
- 典型动作：建群、邀请成员、群信息维护
- 这是外部群能力的基础
5. 消息收发
- 用途：私聊和群聊触达
- 最常用：
/msg/sendText toId：人用 userId，群用 roomId
6. Webhook / 会话
- 用途：自动回复、AI 客服、会话存档到 SCRM
- 没有回调，SCRM 只能单向群发，不像客服系统
7. 朋友圈
- 用途：内容沉淀、定时问候
- 支持文本搭配图片、视频、链接等（每次选一种素材类型）
SCRM 对接时的最小字段表
| 业务对象 | 建议保存的 ID | 用来做什么 |
|---|---|---|
| 坐席/机器人账号 | guid | 所有调用都要带 |
| 客户 | userId | 私聊、拉群、打标签 |
| 客户群 | roomId | 群发消息、群管理 |
| 消息 | msgServerId 等 | 撤回、引用回复 |
ID 一旦入库，就不要靠昵称、群名去对。
建议的接入顺序
- 发通一条私聊
- 发通一条客户群消息
- 接 Webhook，做关键词回复
- 接拉群和标签
- 最后再接朋友圈和复杂素材
每一步都能单独验收，避免一上来做大而全。
产品模块总览也可以先看 QiWe API 官网。
总结
企业微信 SCRM 对接 API，先接主链路，再补周边能力。
QiWe API 把私域自动化常用动作收成统一 POST 接口，适合做客服系统和运营中台的企微通道。