Viber号码整理的目标，不是简单删除符号，而是把每条记录转换成能够追溯到原值、国家依据明确、适合匹配的国际号码。一个稳妥的流程应保留原始号码，单独生成规范化号码，并把无法确认国家或长度的记录送入异常队列。
爱普筛当前只接受TXT上传，每行一个手机号；任务完成后导出Excel。因此，Excel可以用于内部清洗和核对，但最终上传文件必须从已验收的规范化列生成。
什么是完整国际号码格式？
国际号码通常由“+”、国家代码和国内有效号码组成。ITU-T E.164规定国际E.164号码最多15位数字；“+”是书写时表示国际格式的符号，不计入数字位数。不同国家的国内前缀、区域码和移动号规则并不相同。
不要仅用“长度在15位以内”就判断号码有效。长度只是第一层校验，号码还需要符合相应国家当前的编号规则。旧系统中的拨号前缀、分机号或特殊服务号码也不能直接当作手机号码。
第一步：永远保留原始号码
在工作表中创建raw_phone、country_source、normalized_phone、validation_status和validation_note等列。raw_phone原样保留，不能在上面直接替换字符；所有清洗结果写入normalized_phone。
country_source记录国家判断依据，例如客户在表单中选择的国家、订单配送国家或已经验证的账户地区。只看到“07”或“09”等本地前缀时，不足以确定国家，因为多个编号计划可能出现相同开头。
第二步：移除展示字符，不要误删号码信息
可以移除空格、括号、短横线和常见的非号码展示符号，同时把全角数字转换为半角数字。若字段包含“ext”“分机”或多个号码，应先拆分并人工确认，不能把所有数字直接拼接。
表格软件可能把“+”当作公式，或把长号码显示成科学计数法。导入前将原始和规范化号码列设置为文本，并随机检查开头、结尾和总位数。
第三步：根据已知国家处理国家代码
如果原号码已经以“+国家代码”开始，先验证该国家代码与客户资料一致；如果是本地格式，按该国编号计划移除仅用于国内拨号的前导符，再添加国家代码。规则必须按国家维护，不能全局删除所有前导0。
例如同一串本地号码在不同国家可能代表完全不同的用户。没有可靠国家依据时，标记country_unknown并暂停，而不是用访问IP、姓名语言或团队猜测补齐。
第四步：进行结构校验和去重
校验至少包括：只含允许字符、国家代码存在、总位数不超过15、长度符合该国范围、不是明显占位值、没有分机号。通过后再按normalized_phone去重，同时保留重复记录对应的所有内部客户ID。
去重不等于删除业务记录。一个号码可能出现在多个订单或联系人记录中，上传时只需要检测一次，但回填时必须把同一结果安全映射回相关记录，并单独处理归属冲突。
第五步：从规范化列生成UTF-8 TXT
只导出validation_status为pass的normalized_phone，一行一个号码，不带表头、姓名、国家名、逗号或备注。保存为UTF-8 TXT后，用纯文本编辑器重新打开，检查是否出现引号、制表符、空行或乱码。
建议先生成20至100条小样本，在爱普筛Viber筛号中运行所需任务。样本能够正确返回并与原记录匹配后，再生成完整TXT。不要直接上传Excel或CSV。
Viber任务该怎样选择？
如果只需要确认渠道是否开通，选择Viber筛开通，Excel字段为手机号和是否开通。如果当前业务确实需要时间相关支持字段，可选择Viber筛活跃，其字段包括手机号、活跃天数、mid和用户离线时间。
Viber筛性别年龄是另一项任务，字段更多，不应因为“看起来完整”就默认选择。任务应由业务问题决定；任何检测结果都不证明实名身份、营销许可或购买意向。
第六步：验收Excel并回填CRM
核对输入输出数量、异常行和字段标题，用normalized_phone与Excel手机号匹配。新增viber_check_type、viber_status、viber_checked_at等列，不要覆盖raw_phone、country_source和许可记录。
先进行模拟导入，检查加号是否丢失、号码是否变成科学计数法、日期格式是否一致，以及一个号码是否匹配多个客户。无法唯一匹配的结果进入人工队列。
常见错误如何定位？
- 大量号码无结果：先查国家代码、国内前导符和文件编码。
- Excel号码被截断：检查表格列是否被当作数值或科学计数法。
- 同一号码多次上传：确认是在规范化之后去重，而不是对展示格式去重。
- 结果回填错人：检查内部ID映射和一对多异常。
- 国家无法判断：回到客户来源补证据，不用号码外观猜测。
最终应能从Excel中的每个号码回到规范化记录，再回到原始号码和客户来源。可追溯性比“尽量多让号码通过格式检查”更重要。
