Viber筛号结果回填CRM，不是把导出的Excel整表复制进去。真正可靠的做法，是先确定业务问题和任务类型，再用稳定键匹配原记录，把检测字段写入专用列，并保留可回滚的导入批次。这样即使号码重复、格式变化或任务出现空值，也不会破坏客户来源、许可和历史互动。
本文面向运营、销售支持和CRM管理员，假设当前流程是上传TXT、任务完成后导出Excel，而不是直接调用Viber筛号API。文章给出文件型集成的完整操作方法。
直接答案：用原始CRM ID加规范化手机号建立映射表；Viber结果只写入新的服务字段，不覆盖许可、来源或销售阶段；导入前后都保存行数、哈希或版本号和回滚文件。
先定义回填目标：注册、活跃还是画像字段？
Viber筛开通、筛活跃和筛性别年龄是三个不同任务。筛开通返回手机号与是否开通；筛活跃返回手机号、活跃天数、mid和用户离线时间；筛性别年龄才可能增加肤色、性别、昵称、头像相关字段和年龄。
CRM集成必须从业务问题出发。如果客服只想知道是否可在Viber找到注册信号，就不该为了“以后可能有用”选择更广的字段。
| 业务问题 | 所需证据 | 本流程的作用 |
|---|---|---|
| 号码是否注册Viber | 筛开通结果和检测日期 | 更新渠道状态 |
| 活动信号怎样记录 | 筛活跃字段和统一口径 | 形成时点快照 |
| 是否允许联系 | 表单、订单、会话与退订 | 本流程不生成许可 |
| 客户优先级 | 询盘、订单和真实互动 | 检测字段只能辅助 |
建立三张表，而不是直接修改客户主表
| 检查对象 | 合格状态 | 异常动作 |
|---|---|---|
| 来源表 | 含CRM ID、原手机号、来源和许可 | 缺ID或来源进入异常表 |
| 映射表 | 原手机号与规范号一一可追溯 | 一对多或多对一人工确认 |
| 导入表 | 只含匹配键和允许回填的Viber列 | 移除无关个人字段 |
| 回滚表 | 记录旧值、新值和导入批次 | 未生成则禁止批量覆盖 |
映射表是整个流程的核心。仅按手机号匹配时，同一联系人多号码、同一号码多记录和号码换主都会造成歧义；CRM ID让导入动作可以回到原对象。
从Viber TXT到CRM的八步流程
- 第1步：冻结来源快照
导出只读名单并登记查询条件、日期和负责人。 - 第2步：规范号码
核对国家代码、去重并生成规范化手机号，但保留原始值。 - 第3步：生成TXT
每行一个号码，不带表头和其他列。 - 第4步：先跑小样本
验证输入接受率、Excel列名和空值。 - 第5步：运行正式任务
登记任务ID、服务名称、操作人和检测日期。 - 第6步：建立字段映射
将Excel列映射到CRM专用字段，不使用模糊自动匹配。 - 第7步：预览导入
统计新增、更新、跳过、冲突与空值记录。 - 第8步：提交并复核
抽样比较CRM、Excel和原始来源，保存回滚文件。
爱普筛任务的上传格式是UTF-8 TXT，一行一个手机号；Excel是任务完成后的导出结果。不要把姓名、邮箱、公司、备注或表头一起放入TXT，也不要把CSV、XLSX误作上传文件。
Viber字段映射示例
| 导出字段 | 字段含义 | 建议回填位置 | 不能代表 |
|---|---|---|---|
| 手机号 | 任务输入/结果主键 | viber_checked_phone | 联系人姓名 |
| 是否开通 | 筛开通状态 | viber_registered | 营销许可 |
| 活跃天数 | 筛活跃支持字段 | viber_active_days | 实时在线 |
| mid | Viber任务标识字段 | viber_mid | CRM客户ID |
| 用户离线时间 | 筛活跃支持字段 | viber_offline_at | 最后回复时间 |
筛性别年龄任务的字段必须进入单独治理评估，不能默认并入普通销售画像。字段名应包含平台和检测含义，避免用含糊的“状态”“活跃”覆盖其他渠道。
五类导入异常怎样排查
| 失败表现 | 常见原因 | 排查顺序 |
|---|---|---|
| Excel行数少于TXT唯一号码数 | 格式拒绝、空行或任务异常 | 先看接受行和异常报告 |
| 一个号码匹配多条CRM记录 | 共享号码或重复客户 | 按CRM ID和来源人工拆分 |
| mid为空 | 任务未返回或字段不适用 | 保留未知，不生成假值 |
| 日期变成文本/时区漂移 | 导入类型错误 | 固定ISO格式和时区 |
| 旧结果被新空值覆盖 | 更新规则过宽 | 只在明确返回时更新 |
任何无法解释的空值或缺行都应先标为“未知/待复核”，不能为了让报表完整而自动填成“否”“未开通”或0。原始TXT、导出Excel和异常表应使用同一个任务编号关联。
怎样验收一次CRM回填
| 验收指标 | 计算或检查方法 | 用途 |
|---|---|---|
| 匹配覆盖率 | 成功匹配记录÷有效结果记录 | 发现键值问题 |
| 冲突数 | 一个键对应多记录的数量 | 评估人工工作量 |
| 空值保留率 | 空值未被转换为否/0的比例 | 保护语义 |
| 可回滚率 | 有旧值与批次记录的更新÷全部更新 | 控制变更风险 |
| 抽样一致性 | 抽样逐列对照Excel | 发现映射错误 |
这些指标评估的是数据流程质量，不是营销成功率。回复、合格询盘、退订和投诉应在后续沟通环节单独统计。
权限、保留与回滚如何设计
原始TXT和Excel可能包含可识别号码，应限制访问并设置保留期限。操作日志至少记录谁在何时因何目的运行了哪项任务。若业务目的结束，应按组织规则删除不再需要的中间文件。
| 数据层 | 负责人 | 必须保留 | 禁止覆盖 |
|---|---|---|---|
| 来源名单 | 业务负责人 | 来源、用途、许可、CRM ID | 检测结果 |
| 规范化文件 | 数据人员 | 原号码、规范号、异常原因 | 来源记录 |
| 任务快照 | 操作人员 | 任务ID、日期、服务、输入输出数 | 历史结果 |
| CRM回填 | 系统管理员 | 字段字典、导入批次、回滚文件 | 许可与客户阶段 |
上线前最后检查
- 任务类型与业务问题一致；
- TXT一行一个号码且不含其他列；
- Excel列与官网当前字段逐项核对；
- CRM使用专用Viber字段；
- 冲突和空值进入异常队列；
- 回滚文件已生成并经过抽样恢复测试。
需要执行Viber任务时，可先在爱普筛Viber Number Checker核对当前服务字段。文件回填看似没有实时API炫目，却更容易审计、重放和回滚；对于需要控制数据边界的团队，这往往正是优势。
常见问题
可以直接把Excel覆盖到CRM手机号列吗？
不建议。手机号是匹配键和来源信息，全表覆盖会丢失原始写法并放大错误。应使用映射表和专用Viber字段增量导入。
筛活跃结果可以当作最后一次客户互动吗？
不可以。筛活跃是任务支持的活动信号；客户互动应来自客服或销售会话，两者需要分列并各带日期。
没有API还能自动化吗？
可以在内部使用受控的文件导入模板、字段映射和批次日志自动化，但不能把这种内部流程描述成爱普筛提供了未公开的Viber筛号API。
