用 Python 调文本投递请求体并不复杂。生产事故多半出在超时策略和重试范围本机脚本一次通过迁到定时任务后出现双写或乱码。会写requests不够。进程模型和幂等键才决定这句会不会进会话两次。Flask 视图里同步等待发送页面一卡操作方连点就是多次提交。这个坑和字段名无关和你把投递放在哪一类线程有关。请求只表达一次投递统一入口为 POST请求头带X-QIWEI-TOKEN。文本method为/msg/sendText。guid、toId、content为文档字段。toId可以是userId或roomId调用方必须同时记录会话类型不能只留一个无类型字符串。示例代码里如果没有类型这示例不能进仓库。importosimportrequests APIhttp://manager.qiweapi.com/qiwe/api/qw/doApiTOKENos.environ[QIWEI_TOKEN]defsend_text(guid,to_id,content):headers{X-QIWEI-TOKEN:TOKEN,Content-Type:application/json,}body{method:/msg/sendText,params:{guid:guid,toId:to_id,content:content,},}rrequests.post(API,headersheaders,jsonbody,timeout20)r.raise_for_status()returnr.json()print(send_text(你的guid,你的userid,Python 连通测试))Token 从环境变量读取。示例脚本夹带生产凭证入库测试句会在次日出现在真实会话。缺配置应拒绝启动不要静默打默认号。timeout必须显式给出过短会把正常投递打成失败过长会拖死工作线程。代理解密 HTTPS 后证书不对表象像鉴权失败先核对运行环境再改签名。Web 线程同步投递会把连点变成多次提交请求阶段只写入任务由独立进程消费。字符编码须显式 UTF-8。Windows 计划任务默认代码页一变手机显示乱码而通道仍报成功。日志也用 UTF-8否则排障时中文变成问号看起来像接口返回异常。查询类接口可以有限重试。投递超时不能套同一装饰器。uuid4()每次不同不能充当幂等键键应来自业务单号。虚拟环境和依赖要锁死。本机 http 库一套、服务器另一套证书校验行为不同会表现为本机通、服务器鉴权失败。笔记本里重复执行同一单元格效果等于人工双发。独立脚本连续跑三次更有用一次成功把超时压到极短后会话仍一条错误会话类型能从回执中读出。换一台机器、换一个同事按同样顺序测试会话里只有该出现的那一句并且任务表能对上单号。这才叫示例过关不是print了成功。查看企业微信 API 文档https://doc.qiweapi.com/