quickstart.md

快速开始

把企业微信接进你的系统,核心三步:登录托管账号 → 调接口 → 收回调。

1. 拿到 Token 与 guid

1. 在控制台注册并创建 Token;
2. 扫码登录一个企业微信账号(登录托管),每个账号对应一个 guid,后续所有接口都带上它。

2. 第一条请求

所有能力都走统一网关 POST /api/qw/doApi:鉴权放请求头,业务用请求体里的 method 区分。

curl -X POST https://<网关地址>/api/qw/doApi \
  -H "Content-Type: application/json" \
  -H "<鉴权Token头>: <Token>" \
  -d '{"method":"/msg/sendText","params":{"guid":"<guid>","toId":"<接收人或群ID>","content":"hello"}}'

返回 {"code":0,"data":{"isSendSuccess":1,...}} 即成功。给外部群发消息时,toId 填群 ID。

3. 配回调收消息

在控制台给 Token 配一个 HTTPS 回调地址,企业微信侧的消息与事件会 POST 过来。要点:3 秒内回 200、按 seq 幂等去重。结构见回调文档。

下一步

• 接口模块总览
• 外部群 · 消息 · 回调 Webhook
• 完整接口、字段、边界以在线文档为准。