自定义号段 CSV 导入指南：格式规范、步骤详解与最佳实践

在出海获客场景中，批量生成并筛选特定国家、特定号段的手机号码是一项高频需求。无论是针对美国 +1 号码做 Telegram 筛号，还是聚焦中国 138/139 号段做 WhatsApp 验证，手动逐个输入号段不仅耗时，还容易出错。KK-DATA 的 自定义号段 CSV 导入 功能允许你上传一个包含国家代码、前缀、长度等字段的 CSV 文件，系统自动按规则生成号码，并与后续的筛号任务无缝衔接。本文将从格式规范、操作步骤到最佳实践，完整拆解这一能力，助你高效完成「生成 → 筛选 → 导出」流水线。

什么是自定义号段 CSV 导入？它解决什么场景问题？

简单来说，自定义号段 CSV 导入是指用户通过上传一个结构化的 CSV 文件，向平台指定需要生成的号码范围。文件中的每一行代表一个号段规则（例如：国家代码 1，前缀 2，总长度 10 位），系统会基于该规则批量生成该号段下的所有或指定数量的号码。

这一功能解决的核心场景包括：

• 按区域定向获客：需要在某个国家集中推广，比如印度 +91，可以只上传该国常用号段（如 98、99 开头），避免生成无效号码。
• 运营商或活动定向：有些活动只针对特定号段用户（例如中国移动 138、139 号段），CSV 导入可精准限定。
• 大批量、多条件组合：需要同时生成多个国家、多种前缀、不同长度的号码时，CSV 文件比手动输入高效百倍。
• 与后续筛号任务衔接：生成完成后，可直接将这些号码提交到 Telegram/WhatsApp 筛号任务，利用去重仓库避免重复检测。

CSV 导入 是号码生成模块的核心能力，与「自定义前缀」功能互补，更适合复杂、大批量的场景。

自定义号段 CSV 文件的标准格式与字段说明

一个标准的 CSV 文件需要包含以下列（表头严格区分大小写，建议从 KK-DATA 文档下载官方模板）：

必填字段详解

字段名	说明	数据类型	示例
country_code	国际区号（不含 +）	数字	1（美国）、86（中国）、44（英国）
prefix	号码前缀（不含区号）	数字	138、2、7
length	号码总位数（含区号？注意：不含国际前缀，即国家代码+号码总长，通常指去除国家代码后的号码位数？需要准确定义。根据 KK-DATA 文档，length 指手机号码的总位数，不含国际区号。例如中国手机号 13812345678，去掉区号 86 后为 11 位，则 length=11；美国号码 +1 234567890 去掉区号 1 后为 10 位，则 length=10。）	数字	11（中国）、10（美国）

说明：prefix 的长度不能超过 length。例如中国，prefix=138（3位），length=11，剩余 8 位由系统随机生成。

可选字段与高级用法

字段名	说明	数据类型	示例
start_range	指定前缀后可变数字的起始范围（可选）	数字	0
end_range	指定前缀后可变数字的结束范围（可选）	数字	9999
quantity	限定该号段生成的号码总数（可选）	数字	5000

高级用法：若同时填写 start_range 和 end_range，系统会生成该区间内的所有号码（数量 = end_range - start_range + 1），此时 quantity 字段无效。如果只填 quantity，系统会从完整范围中随机抽取指定数量。

例如：英国 +44，前缀 7，length=11，start_range=3000，end_range=4000，将生成号码后四位 3000～4000 共 1001 个号码。

常见字段错误及避免方法

• 列名大小写错误：必须为小写（如 country_code 而非 CountryCode）。建议直接从官方模板复制。
• 字段缺失：必填列不可缺少；可选列留空即可，不要填 null。
• 长度冲突：prefix 长度超过 length → 无法生成，系统提示错误。
• 非法字符：只允许数字、逗号、换行；不要添加空格、引号（除非按 CSV 标准转义）。
• 编码问题：必须为 UTF-8 无 BOM，避免中文乱码（虽然字段无中文，但编码错误会导致解析失败）。

三步完成自定义号段 CSV 导入与号码生成

第一步：准备并校验 CSV 文件

使用 Excel 或任何文本编辑器制作 CSV。

• 推荐工具：Excel 编辑后另存为 CSV（逗号分隔）（*.csv），然后用记事本打开确认列间分隔符为逗号，且无 BOM 头。
• 行数限制：单次上传最多 20 万行（号段规则），每个号段生成数量不限，但单次任务生成的总号码数建议不超过 100 万条（超出可分多次）。
• 校验示例：建立一个仅包含一行 country_code,prefix,length 头，然后 1,2,10，保存后上传测试。

第二步：上传 CSV 至 KK-DATA 生成模块

登录 KK-DATA 控制台，进入「号码生成」页面。

1. 选择导入模式「CSV 导入」。
2. 点击「选择文件」或拖拽 CSV 文件。
3. 系统自动解析并预览前 10 行数据，检查字段是否正确映射。如出现「列名不识别」错误，回到第一步核对表头。
4. 确认后点击「开始生成」。

第三步：设置筛选条件并提交任务

号码生成成功后，页面会自动跳转到「号码列表」或提供「继续筛选」按钮。

• 选择后续筛号平台：Telegram / WhatsApp / iMessage / RCS。
• 设置检测类型：例如「有效」或「活跃」（可指定 7/15/30 天活跃窗口）。
• 可选利用数据去重仓库：系统会自动过滤已在仓库中的号码，避免重复扣费。
• 确认预估费用（见控制台实时价格），余额充足则提交任务。

自定义前缀与自定义号段 CSV 导入的区别与选择

KK-DATA 提供两种号码生成方式：自定义前缀（在界面中输入一个前缀、选择国家、设置数量，快速生成）和 CSV 导入。两者的选择决策如下：

维度	自定义前缀	CSV 导入
适用场景	少量、固定前缀（比如仅生成一个号段）	大批量、多号段、多国家、含范围限制
操作复杂度	低，界面填写	中等，需准备文件
号段数量	一次最多 10 个前缀	一次最多 20 万行号段
范围控制	不支持 start_range/end_range	支持精确范围或随机数量
适合团队	个人临时测试	运营团队批量生产

建议：当需要生成超过 10 个号段，或涉及多个国家、需控制范围时，直接使用 CSV 导入。如果只是快速生成 1～10 个固定前缀号码，自定义前缀更快捷。

实用示例：三个真实场景的 CSV 文件模板

场景一：仅生成美国（+1）2 开头的 10 位号码

文件内容：

country_code,prefix,length
1,2,10

生成规则：美国号码去掉区号后是 10 位，前缀 2 是 1 位，系统随机填充后 9 位。生成数量不限（若不指定 quantity 和 range，系统默认生成所有组合，数量极大。建议结合 quantity 字段限制数量，如加 quantity,10000）。

场景二：生成中国（+86）多个号段（139、138、137）的 11 位号码

文件内容：

country_code,prefix,length
86,139,11
86,138,11
86,137,11

每行对应一个号段，系统会为每个号段分别生成号码。如果希望限制每个号段的数量，可添加 quantity 列。

场景三：限定生成数量与范围（英国 +44 7 开头，只生成后四位 3000-4000）

文件内容：

country_code,prefix,length,start_range,end_range
44,7,11,3000,4000

此例中，prefix=7（1位），length=11，系统会在号码后 10 位中仅从 3000～4000 范围生成，即生成 7xxxxx3000 至 7xxxxx4000 共 1001 个号码，其中前 6 位（7xxxxx）随机填充，后四位固定范围。注意：当填写 start_range/end_range 时，生成数量完全由范围决定，无需再写 quantity。

常见错误与排查指南

错误一：上传后提示“列名不识别”

• 原因：表头名称大小写或拼写错误，或包含不可见字符（如 BOM、空格）。
• 解决：从官方模板复制表头；用记事本打开 CSV 检查首行是否仅含 country_code,prefix,length（不含空格）。如果模板中有其他可选字段，请严格保持列名一致。

错误二：生成数量为 0

• 原因：prefix 长度 + 预设范围超出 length 限制。例如中国 11 位号码，prefix=13812345678（11位），系统无法生成剩余位数。
• 或缺少 country_code 字段，或字段值为空。
• 解决：确保 prefix 长度 < length；检查 CSV 文件每行是否有完整数据。

错误三：上传后系统解析超时

• 原因：文件过大（超过 20 万行），或单行字段过多。
• 解决：分割成多个文件上传；检查每行字段数是否一致。

从 CSV 导入到多平台筛号：完整流水线操作

CSV 导入只是起点。最佳流程如下：

1. 生成号码：上传 CSV → 系统生成号码列表。
2. 提交筛号任务：选择 Telegram / WhatsApp 等平台 → 设置检测类型（建议优先用“活跃”检测以获得更高价值的号码） → 绑定数据去重仓库 → 提交。
3. 等待任务完成：可通过 Telegram 接收通知（在控制台设置）。
4. 导出结果：任务完成后，导出 CSV 或 TXT 文件，包含筛选状态（有效/活跃/性别等）及平台 ID（如 tgid、wsid）。
5. 数据归档：将结果号码导入 CRM 或下一步营销工具。

数据去重仓库在此过程中自动工作：每次筛号完成后，检测过的号码会自动进入仓库，后续任务中相同号码不再重复检测，节省费用。

最佳实践：如何规划 CSV 文件以提升筛号效率与降低费用

• 分国家、分平台生成：不同国家的筛号单价可能不同（具体见控制台），且不同平台的活跃度分布不同。建议一个 CSV 文件只覆盖一个国家的号段，便于后续为不同平台单独提交任务。
• 优先使用“活跃”检测而非“有效”：活跃号码的获客价值远高于仅有效但长期不活跃的号码。虽然活跃检测通常单价略高（以控制台为准），但转化率提升后整体 ROI 更优。
• 利用去重仓库减少重复扣费：同一批号码如果多平台筛号，可先做一次通用检测（如有效），再分平台提交活跃检测；去重仓库会帮你过滤重复号码。
• 控制单次任务数量：单次任务生成号码建议不超过 100 万条，超过此数量可分批上传。大量号码集中筛选可能延长任务等待时间，分次提交可提高灵活性。
• 保留原始 CSV 文件：标记每次生成的任务 ID，方便后续回查或与筛号结果关联。

常见问题

问：CSV 文件最大支持多少行？
答：单次上传最多支持 20 万行号段，每个号段可生成复数号码。建议单次任务生成号码总数不超过 100 万条，超出部分可分多次上传。

问：如果 prefix 列填写的号码长度与 length 列不一致怎么办？
答：系统会提示错误并拒绝提交。请确保 prefix 长度 + 预留可变位数 ≤ length 总数。例如中国 11 位号码，prefix 若填写“138”，则 length 必须为 11，剩余 8 位由系统随机填充。

问：CSV 中的号码会与之前任务重复吗？
答：KK-DATA 提供数据去重仓库，在筛选阶段会自动过滤已在仓库中的号码。但生成阶段不支持去重，建议生成后直接提交筛选任务，利用去重仓库避免重复扣费。

问：是否支持导出 CSV 导入时使用的原始号段列表？
答：支持。在“号码生成”历史记录中，可下载包含原始号段及生成号码的 CSV 文件，方便二次分析与归档。

问：自定义前缀功能和 CSV 导入能否混用？
答：暂不支持在一次任务中混用。但你可以先生成自定义前缀号码，导出 CSV 后，再作为号段 CSV 导入新任务进行二次扩展。

---

立即体验：登录 KK-DATA 控制台 尝试自定义号段 CSV 导入功能，或查阅 使用文档 获取最新格式模板。如有任何问题，欢迎联系客服 Telegram @kkdata_cc 获取一对一指导。