号码文件导入
新建文件导入使用 COS 上传会话，支持 CSV/TXT。该入口属于客户控制台 API，使用客户 JWT，不使用 OpenAPI 签名。
推荐使用控制台导入
登录控制台，在发送页选择 CSV/TXT，按当前模板准备号码与变量。上传完成后等待解析，查看有效、重复、无效号码与报价，再确认发送。
客户 API 流程
| 步骤 | 接口或动作 |
|---|---|
| 创建会话 | POST /api/customer/import-uploads/sessions/ |
| 上传文件 | 使用会话返回的临时 URL 与 required_headers 上传到 COS |
| 完成上传 | POST /api/customer/import-uploads/sessions/{session_no}/complete/ |
| 查询解析结果 | GET /api/customer/messages/imports/{job_no}/ |
| 确认发送 | POST /api/customer/messages/imports/{job_no}/confirm-send/ |
源文件与解析结果
会话包含文件名、大小和可选 SHA。完成上传固定对象身份，原始字节校验在解析时完成。解析还检查号码和模板变量，并区分无效、重复以及变量冲突。
格式与接入边界
新文件仅使用 CSV/TXT。旧 OpenAPI multipart 导入路由虽然仍存在，但新建请求会要求 COS 上传流程，不能将其作为新的文件上传集成方案。批量集成前请申请联调。
确认与后续处理
确认后固定计费和号码证据，按当前规则冻结并渐进生成发送批次。完成解析不等于已经发送；存在不支持的扣量策略时会拒绝确认。