Viber筛号怎么对接CRM？TXT上传、Excel字段与导入流程

Viber筛号对接CRM时，最重要的设计不是“把Excel导进去”，而是建立可逆的观察层。任务结果有日期、可能为空，也可能与历史不同；它不应直接覆盖客户自报号码、昵称或许可。contact_id映射、staging和冲突队列必须先存在。

从内部主键开始，而不是从手机号开始

CRM先生成contact_id，并保存phone_raw、phone_normalized、country_evidence、source和permission。手机号可能重复、共享、重新分配或改变格式，不能单独承担永久主键。

层	主要字段	写入方式
客户主表	contact_id、客户自报资料	人工/业务流程
号码关系	phone_raw、normalized、valid_from	有历史版本
任务观察	task、batch、checked_at、返回值	只追加
许可	channel、scope、opt_out	独立否决

爱普筛只接受一行一个号码的TXT。上传文件不含contact_id、姓名或订单，因此在内部保存export_row、phone_normalized与contact_id的crosswalk，同时记录TXT哈希、行数和清洗规则。

任务	实际字段	适用
Viber筛开通	手机号、是否开通	平台开通状态
Viber筛活跃	手机号、活跃天数、mid、用户离线时间	带时效的账号观察
Viber筛性别年龄	手机号、肤色、性别、昵称、活跃天数、mid、离线时间、头像人数/类型、年龄、头像	经批准的宽字段研究

不修改列名、不填补空值，原样保存返回，再追加ingested_at、batch_id、task_name和source_file_hash。之后在标准化视图中转换类型；这样导入规则出错时仍能回到原始证据。

未返回、未知、不可观察、格式错误与明确否定分别编码。特别是是否开通字段，空字符串不能自动变成false；用户离线时间为空也不表示“永远在线”。

mid可能帮助同一任务域内回连，但不能未经治理取代contact_id。一个手机号对应多个mid、多个联系人共享mid或历史mid变化时，进入identity_conflict并保留全部观察。

肤色、性别、年龄、头像和昵称不能复制到所有客服视图。它们可能缺失、不准确或不代表账户持有人，不得用于身份核验、信用、雇佣或敏感定向。

活跃天数与用户离线时间都附checked_at和refresh_after。过期后显示stale，停止作为排序依据，而不是自动重跑整个CRM。只有仍有合法用途的小集合才复测。

Viber已开通、近期活动或存在mid都不产生营销许可。进入触达队列前仍查询来源、Viber渠道范围和退出表；退出状态不会因新Excel而恢复。

用小批次测试行数、重复、无法连接、一对多、空值和编码。确认删除本批观察即可恢复原CRM视图，而不会丢失客户主表。可回滚的集成才适合扩大。