企业微信API二次开发：扫码登录发第一条消息

企业微信 API 二次开发常见两条路官方应用要企业管理员授权、配 IP、申请权限凭证是corpid/secret/access_token账号 API扫码登录后程序直接控制这个账号收发消息如果目标是客服自动回复、外部群通知、私域 SOP第二条通常更快能看到效果。先别接群管理和 AI把「发出去一条」跑通。先说结论入门只验证一件事这个账号能不能被 HTTP 驱动。最短路径是 Token → 扫码拿到guid→/msg/sendText发给自己。自己的会话里出现测试文本再换roomId发群。最小闭环第 1 步拿到 Token进入控制台的应用凭证新建应用复制 Token。之后所有请求都放在 HeaderX-QIWEI-TOKEN: 你的Token Content-Type: application/json一个 Token 可以绑定多个企业微信节点。不同业务要隔离就建多个 Token。第 2 步扫码登录拿到 guid在实例管理里把企业微信登录成执行节点。成功后详情里能看到guid。后面发消息、管群、拉人都要带这个 ID。注意两点新建设备后尽快扫码超时会失效创建设备时的地区尽量和账号常用登录省份一致Token、设备登录和发消息的字段文档里可以对照着看快速查看 API 文档第 3 步确认自己的 userId先不要发给客户。调「获取个人信息」拿到当前登录账号的userId发给自己确认通道是通的。第 4 步发第一条消息统一地址POST http://manager.qiweapi.com/qiwe/api/qw/doApiQiWe API 用method区分动作入门只调/msg/sendText。importrequests rrequests.post(http://manager.qiweapi.com/qiwe/api/qw/doApi,headers{X-QIWEI-TOKEN:YOUR_API_KEY,Content-Type:application/json,},json{method:/msg/sendText,params:{guid:登录后的guid,toId:自己的userId,content:二次开发连通测试,isNoNeedRead:True,},},timeout30,)resultr.json()print(result)okresult.get(code)0andresult.get(data,{}).get(isSendSuccess)1print(发送成功ifokelse发送失败)code为 0并且手机/电脑上的企业微信收到这条入门就完成了。发给群时把toId换成roomId内部群、客户群都是这个写法。联调验收自己先收到再换测试群失败先看 Token、guid是否过期再查toId是人还是群登录地区和常用省份不一致时优先改设备地区再重扫再扩一步只发送只能做通知。做客服还要配 Webhook控制台填公网回调 → 收到好友/群事件 → 处理后仍走发送接口。逻辑是收消息 → 处理 → 再发送。通了之后可以接外部群推送、群管理、朋友圈。入口在 QiWe API 官网。总结企业微信 API 二次开发入门先追求账号能被接口驱动。Token、guid、发给自己一条文本这三步通了再加回调和群模块。