最近做的企微二开机器人要能处理文件——客户发来订单 Excel机器人解析后回一份汇总报告销售让机器人发产品资料 PDF 给客户。和之前聊的文件自动处理不同那篇重点是接收客户文件做业务解析这篇重点是机器人自己上传、解析、发送文件的完整闭环——机器人怎么调 CDN 接口上传文件、怎么解析文件内容、怎么把文件发给客户。把调了哪些接口记下来。Eyun 平台开放的企微 API统一 POSTJSON鉴权用 App Token 加 appidAuthorization: Bearer eyk_xxxx路径{BASE_URL}/wx-api/api/模块/动作响应封套{code, data, detail, message, time}code 为 0 成功。文件上传调 CDN 接口机器人生成文件后比如解析完 Excel 生成汇总报告要上传到 CDN 拿 fileId再用 fileId 发送。上传调 CDN 模块import requests BASE https://api.eyun.com HEADERS {Authorization: Bearer eyk_xxxx, Content-Type: application/json} def upload_file(appid, file_path, file_name): with open(file_path, rb) as f: resp requests.post( f{BASE}/wx-api/api/cdn/upload, headers{Authorization: HEADERS[Authorization]}, # 上传不带Content-Type files{file: (file_name, f)}, data{appid: appid} ) body resp.json() if body[code] 0: return body[data][fileId] # 拿到fileId用于发送 raise Exception(body[message])上传是 multipart/form-data不是 JSON所以 Content-Type 要去掉让 requests 自动设。返回的 fileId 是文件在 CDN 的唯一标识后续发送文件用。文件下载调 CDN 接口客户发来文件机器人要下载解析。下载调 CDN 模块def download_file(appid, file_id, save_path): resp requests.post( f{BASE}/wx-api/api/cdn/download, headersHEADERS, json{appid: appid, fileId: file_id}, streamTrue ) if resp.json().get(code) 0: with open(save_path, wb) as f: for chunk in resp.iter_content(8192): f.write(chunk) return save_path raise Exception(resp.json()[message])下载是流式的大文件不会爆内存。fileId 从客户发文件消息的回调里拿。下载完存本地或 OSS解析完删本地文件。文件解析按类型处理下载完按扩展名识别类型分别解析import openpyxl import PyPDF2 def parse_file(file_path, file_name): ext file_name.rsplit(., 1)[-1].lower() if ext in [xlsx, xls]: return parse_excel(file_path) elif ext pdf: return parse_pdf(file_path) elif ext csv: return parse_csv(file_path) else: return {type: unknown, content: } def parse_excel(file_path): wb openpyxl.load_workbook(file_path) ws wb.active headers [c.value for c in ws[1]] rows [] for row in ws.iter_rows(min_row2, values_onlyTrue): rows.append(dict(zip(headers, row))) return {type: excel, headers: headers, rows: rows}解析返回结构化数据机器人基于数据生成回复或报告。表头别名匹配订单号/订单编号适应不同客户格式。发送文件调消息接口机器人解析完生成报告文件上传 CDN 拿 fileId 后调消息接口发文件给客户def send_file(appid, to_uin, file_id, file_name): resp requests.post( f{BASE}/wx-api/api/message/sendFile, headersHEADERS, json{ appid: appid, to: to_uin, fileId: file_id, fileName: file_name } ) return resp.json()[code] 0fileId是上传时拿到的fileName是客户看到的文件名。发送文件接口和发送文本接口走不同路径——sendFile 而不是 sendText。完整闭环接收→解析→生成→发送客户发 Excel机器人解析后生成汇总报告发回去完整流程def handle_file_and_reply(appid, from_uin, file_id, file_name): # 1. 下载文件 local_path f/tmp/{file_id}_{file_name} download_file(appid, file_id, local_path) # 2. 解析文件 parsed parse_file(local_path, file_name) if parsed[type] excel: # 3. 生成汇总报告 report_path generate_report(parsed[rows]) report_name f汇总报告_{file_name} # 4. 上传报告到CDN report_file_id upload_file(appid, report_path, report_name) # 5. 发送报告文件给客户 send_file(appid, from_uin, report_file_id, report_name) # 6. 发文字说明 requests.post( f{BASE}/wx-api/api/message/sendText, headersHEADERS, json{appid: appid, to: from_uin, content: f已解析 {len(parsed[rows])} 条数据汇总报告见文件} ) # 清理本地文件 import os os.remove(local_path) if report_path in locals(): os.remove(report_path)整个闭环涉及五个接口调用cdn/download 下载、解析本地、cdn/upload 上传、message/sendFile 发文件、message/sendText 发文字说明。关于文件处理相关接口在Eyun 企业微信 API 平台有完整说明。文件处理的几个坑上传是 multipart不是 JSONContent-Type 不能带fileId 有有效期几天过期的要重新上传大文件上传超时要设长timeout120解析 Excel 大文件要分批读不然内存爆发送文件后客户可能看不到预览企微客户端限制要配文字说明写在最后机器人文件处理这套东西本质是把企微的 CDN 接口和消息接口串起来——cdn/download 下载客户文件、本地解析、cdn/upload 上传处理结果、message/sendFile 发文件给客户。把上传下载做对、解析做扎实、闭环跑通机器人真正能处理文件——而不是只会发文字的半成品。