爱普筛当前的Viber筛号与CRM衔接，是一个清晰的TXT上传—任务处理—Excel导出—CRM导入流程，结果不会自动推送到CRM。做好字段映射和历史保留后，这种文件流程同样可以稳定复用，并且更容易在导入前人工验收。
下面以“企业想确认已有客户的Viber渠道状态”为例，说明怎样从源数据到CRM完成一次可回滚的导入。不同CRM按钮名称会不同，但数据设计原则相同。
先确定要导入哪一种Viber结果
Viber任务并不是一套固定的万能字段。选择服务前，先写下CRM要回答的问题：
| Viber任务 | 当前支持字段 | 适合的CRM问题 |
|---|---|---|
| Viber筛开通 | 手机号、是否开通 | 客户是否具有Viber开通支持信号 |
| Viber筛活跃 | 手机号、活跃天数、mid、用户离线时间 | 已有服务关系中是否需要时间相关字段 |
| Viber筛性别年龄 | 手机号、肤色、性别、昵称、活跃天数、mid、离线时间、头像人数、头像类型、年龄、头像 | 确有必要且已完成敏感数据评估的特定流程 |
如果CRM只需要渠道状态，筛开通已经足够。选择更多字段会增加匹配、权限和保留成本，并不自动提高销售价值。
第一步：从CRM导出待处理名单
先在CRM中筛出来源清晰、仍有当前业务目的且未退订的记录。导出的工作表可以包含内部客户ID、原手机号、国家、来源和许可字段，但这些内容不应全部进入上传文件。
在工作表中新增“规范化手机号”列，根据原始国家信息加入国际区号，清除空格、括号和短横线，并标记无法确定国家或位数异常的记录。不要仅凭号码长度猜国家。
第二步：制作只含手机号的TXT
把通过格式检查的规范化手机号复制到纯文本文件，一行一个号码，去重并保存为UTF-8。爱普筛当前只接受TXT上传，Excel和CSV不能直接上传；姓名、客户ID、来源、邮箱和备注都不放进TXT。
+447911123456
4915123456789
84901234567工作表中的内部ID映射不要删除。它是稍后把Excel结果安全连接回CRM的桥梁。
第三步：在爱普筛运行对应任务
进入爱普筛Viber筛号，根据目标选择筛开通、筛活跃或性别年龄任务。第一次运行时先用小样本，确认TXT能够读取、国际区号正确、导出字段与CRM设计一致，再扩大到剩余记录。
记录任务名称、创建时间、操作人、输入文件版本和业务目的。这些信息以后能解释CRM中的结果来自哪里。
第四步：验收导出的Excel
下载后先保留一份未编辑原件，再复制工作版本。对比有效输入行数和输出行数，检查重复、异常、空值以及手机号能否回连。手机号列应设置为文本，避免科学计数法、截断或加号丢失。
字段含义要按任务读取。Viber筛开通的“是否开通”不是营销同意；筛活跃的离线时间不是实时在线；性别、年龄、肤色和头像字段可能为空，也不是实名认证。
第五步：设计CRM字段映射
不要把所有结果塞进一个“Viber状态”文本框。建议采用可追溯字段：
- viber_check_service：本次服务类型；
- viber_registration_status：开通状态；
- viber_active_days、viber_offline_time、viber_mid：仅在筛活跃时使用；
- viber_checked_at：检测日期；
- viber_result_version：导出文件或任务编号；
- viber_result_note：异常与空值说明。
许可、来源和退订继续使用CRM原字段，不被检测结果覆盖。
第六步：先模拟导入，再正式更新
优先通过内部客户ID匹配；如果只能用手机号，就确保CRM与Excel采用同一规范化规则。先在测试环境或复制的数据视图中导入，统计成功匹配、未匹配、一对多冲突和将被修改的字段。
确认结果后再更新正式记录，并保留导入批次号。不要因为Excel某列为空就清除CRM已有值，除非业务规则明确要求且经过审批。
一个小型字段映射示例
| Excel列 | CRM目标字段 | 更新规则 |
|---|---|---|
| 手机号 | phone_normalized | 只用于匹配，不覆盖原始号码 |
| 是否开通 | viber_registration_status | 写入本次结果 |
| 活跃天数 | viber_active_days | 仅筛活跃任务写入 |
| 用户离线时间 | viber_offline_time | 连同检测日期保存 |
| 任务日期 | viber_checked_at | 每次导入必须填写 |
如何回滚和维护历史？
正式导入前导出CRM相关记录作为备份，保存批次号和变更字段列表。如果出现错误，按批次恢复受影响字段，而不是整库覆盖。对于周期性检测，可以建立结果历史表，让同一客户拥有多次带日期的观察值。
重测不应按照固定日历机械执行。只有业务关系仍有效、旧结果不再适合当前决策，而且用户没有退出时，才创建下一次任务。
上线前检查清单
- 名单来源、许可和当前目的已经确认；
- 上传文件是真正的UTF-8 TXT，一行一个号码；
- Excel或CSV没有被直接上传；
- 服务类型与CRM字段一致；
- 导出Excel原件保持只读；
- 匹配率、冲突和空值经过模拟导入检查；
- 检测日期、任务版本和批次号均已保存；
- 回滚备份已经生成。
完成这些步骤后，Viber筛号结果才会成为CRM中可解释的数据，而不是一批无法追溯来源的新标签。
