WhatsApp CSV筛号：上传前6处文件准备要点

WhatsApp CSV筛号的文件准备只有一个标准：号码列按纯文本 E.164 存、文件用 UTF-8 编码、逗号分隔、保留原始ID主键，结果按已注册/未注册/未知三档落库。上传后大批号码被判无效或被网关拒绝，问题多数不在号码本身，而出在文件保存这一层。核心做法是：号码列按纯文本 E.164 格式存、文件用 UTF-8 编码、逗号分隔、保留原始 ID 主键，结果按三档（已注册/未注册/未知）落库。

先看结论：一份能直接进检测队列的 WhatsApp CSV筛号文件长什么样

一份能直接进检测队列的 WhatsApp CSV筛号文件，列头稳定、类型明确、主键清晰。当前主流批量筛号 API 普遍采用异步任务 + Webhook 回调 + 三档状态输出的架构，例如 Whapi.Cloud 与 CheckNumber.AI 在 2026 年文档中均采用这一设计。这意味着上传的文件必须像接口契约一样严格。最小可用表结构如下：

核对点1 号码列：纯文本、E.164 写法与15位上限

根据 ITU-T E.164 规范，全球统一号码格式为 +国家码，纯数字且总长不超过15位，且国家代码均不以0开头。号码列应设置为文本格式，避免 Excel 转换。注意格式合规不等于平台已注册，E.164 只保证号码可被国际路由，不保证该号码开通了 WhatsApp。号码本身的清洗规则见海外号码筛选前的 E.164 归一化。

核对点2 前导0与国家码：表格软件在哪一步把号码改坏了

Excel 打开 CSV 时会把 08xxxxxxx 的前导0吃掉，把超过11位的号码转成科学计数法，甚至把以+开头的单元格当公式。恢复思路：不要双击打开，用导入向导指定文本列；先补国家码再删本地长途0。判断依据：国家代码不以0开头，因此本地号码前的0属于长途冠字，需去除。

核对点3 编码与分隔符：筛号CSV文件用什么编码不会乱码

筛号 CSV 文件推荐使用 UTF-8 编码，避免乱码。带 BOM 的 UTF-8 在 Windows 记事本和 Excel 中识别更好，但在某些 API 中可能把 BOM 当成列名的一部分，需要与接口文档确认。分隔符通常为逗号，若字段内含逗号，需用双引号转义；部分欧洲地区使用分号，需检查。自检方法：用文本编辑器打开文件，查看首行是否正常显示列名，数一数列数是否与表头一致。

核对点4 列头与主键：为什么必须带原始ID、批次号与时间戳

列头命名要稳定，避免中文和空格。必须保留 CRM 原始记录ID 作为回写主键，因为号码本身可能有重号或换号，不能当唯一键。加批次号和提交时间戳，便于异步回调落库时对齐任务，也便于后续按时间判断结果是否需要复检。

核对点5 一个CSV文件最多能放多少个号码：按队列吞吐切批

文件条数不应由名单总量决定，而由检测队列吞吐、重试成本和结果回收节奏决定。大文件失败时整批重传代价高，建议按可单跑重跑的粒度切分，并预留失败批次重提交位。各平台对单文件条数上限多为动态限流，不公开固定数值，需以实际返回为准。例如 LINE Messaging API 对不同端点设置了从60次/小时到2000次/秒不等的限流梯队，超限返回 HTTP 429，批量提交需配套重试与退避。分批策略可参考WhatsApp号码批量检测怎么分批。

核对点6 结果文件读法：三档状态列，不能压成布尔值

结果必须区分已注册/未注册/未知三档。未知档包括隐私设置、限流、超时等情况，如果把未知合并进未注册，会造成名单持续缩水和误判。Telegram 官方接口文档中，未注册与用户隐私限制会返回相同的 PHONE_NOT_OCCUPIED，因此二者无法仅凭单次反查区分。三档结果的判读与抽检方法可参考社交账号注册检测的三档结果与抽检复核。

上传前一页核对表：输入、输出与验收标准

下表可直接打印，作为 WhatsApp CSV筛号的上传前验收标准。

上传前抽样10条，在文本编辑器中肉眼核对号码列是否为纯文本 E.164、列数与表头是否一致、主键有无重复。注意这一步只验证格式，不能替代平台注册状态检测。

跑完之后：抽检复核、回写 CRM 与未知档复检排期

WhatsApp CSV筛号跑完后的结果落地流程如下：按批次抽检，以原始ID回写状态与检测时间，未知档排期复检，历史结果随时间衰减需增量重跑。同一份名单在文件批量与 API 批量之间反复转格式，是回写环节最常见的返工点。为此，NexCheck 同时提供网页端批量筛选与 RESTful API（支持批量提交、实时查询与 webhook 回调），归一化后的号码列表可以一次准备、两条入口复用。建议结果按三档落库，以原始ID为主键回写，未知档单独排期复检。可参考批量号码检测API怎么接。

常见问题

CSV 和 TXT 号码文件有什么区别？

CSV是逗号分隔的表格格式，可带列头，适合结构化数据；TXT是纯文本，通常每行一个号码，无列头。筛号工具一般两者都支持，但带列头和三档结果输出时CSV更合适。

为什么我用 Google Sheets 导出 CSV，号码还是变了？

Google Sheets 导出时默认使用 UTF-8 编码，但号码列如果被识别为数字，同样可能丢失前导0或变成科学计数法。导出前应把单元格格式设为纯文本，或手动调整导出选项。

筛号结果文件能直接覆盖原表吗？

不建议直接覆盖。筛号结果包含三档状态，应在原表基础上新增状态列和检测时间列，保留原始数据，以便后续复检和审计。

我格式全对，为什么还有大批未知结果？

未知档可能来自用户隐私设置、平台限流或网络超时。部分平台接口对未注册与隐私限制返回同一错误码，技术上无法凭单次反查绝对区分。需按批次排期复检，或调整提交频率。