Zalo筛号结果可以进入CRM，但爱普筛当前流程应准确描述为文件式衔接：从已有业务名单生成TXT，完成所选任务后导出Excel，再经过字段映射和验收导入CRM。不能把它写成已经提供Webhook、API连接器或一键自动化。
快速判断：先保留CRM内部ID和原手机号，在工作副本中规范号码并生成一行一个手机号的TXT；导出Excel后按手机号回连内部ID，通过测试环境核对行数、空值和重复，再导入生产CRM。
文件式流程的完整数据链
| 阶段 | 文件或系统 | 关键控制 |
|---|---|---|
| 来源 | CRM主表 | 内部ID、来源、许可、原手机号 |
| 准备 | 规范化工作表 | 保留原值、国家代码、去重 |
| 上传 | UTF-8 TXT | 一行一个手机号 |
| 结果 | 爱普筛导出Excel | 任务字段与检测日期 |
| 回填 | CRM测试区再到生产 | 字段映射、冲突和审计 |
Zalo三个任务分别返回什么？
| 任务 | 当前确认字段 | 适合的问题 |
|---|---|---|
| Zalo筛开通 | 手机号、是否开通 | 是否返回Zalo开通信号 |
| Zalo筛活跃 | 手机号、用户ID、活跃时间、昵称、活跃天数 | 活动相关名单分层 |
| Zalo性别年龄 | 手机号、用户ID、活动、昵称、性别、年龄、头像及图像字段 | 确实需要并能治理这些字段 |
字段以实际所选任务导出的Excel为准。不要把WhatsApp映射手机号、Telegram用户名或未提供的机器人识别字段写进Zalo结果。
从CRM导出时保留哪些列？
主表至少保留内部ID、原手机号、国家、号码来源、许可状态和最后更新时间。生成TXT时只输出规范手机号，但不能删除主表中的连接键。
如果同一个号码对应多个客户记录，应在导出前定义合并、主记录和冲突规则；不要等Excel返回后才临时决定。
号码规范与TXT制作
- 按确认的国家字段添加正确国际代码；
- 删除显示分隔符，按各国规则处理国内前缀；
- 保留原手机号和规范手机号两列；
- 规范后去重并输出异常表；
- 生成UTF-8 TXT，一行一个号码，无表头；
- 重新打开TXT抽查，防止Excel科学计数法或加号丢失。
Excel结果怎样映射回CRM？
| CRM字段 | Excel来源 | 导入规则 |
|---|---|---|
| zalo_registration_status | 是否开通 | 只由筛开通任务更新 |
| zalo_user_id | 用户ID | 作为平台字段，不覆盖内部ID |
| zalo_activity_time | 活跃时间 | 同时写入检测日期 |
| zalo_active_days | 活跃天数 | 保留任务口径 |
| zalo_nickname | 昵称 | 不得当作实名 |
| zalo_profile_checked_at | 任务完成时间 | 用于判断时效 |
性别年龄或图像字段如果没有明确用途、访问权限和保留周期，不应默认进入CRM。
为什么必须先导入测试区？
测试区可以发现手机号匹配失败、一个号码多条记录、空值覆盖旧值、日期格式错误和枚举不兼容。先生成“将新增、将更新、将跳过、冲突”四类报告，再批准生产导入。
默认规则应是空值不覆盖已有值，平台用户ID不覆盖CRM内部ID，原始Excel不可被运营人员直接修改后当作唯一证据。
自动化应该从哪里开始？
即使未来要自动化，也应先把文件流程跑通。字段字典、异常队列、幂等键、权限、回滚和审计没有定义时，Webhook只会更快地传播错误。
当前可将文件生成、格式检查和CRM测试导入做成内部自动化，但对外表述仍是TXT输入、Excel输出。确有任务需求时访问爱普筛Zalo号码筛选页。
上线后的验收与回滚
- 输入唯一号码数是否与TXT有效行一致？
- Excel结果是否全部可回到内部ID？
- 每个字段是否来自正确Zalo任务？
- 空值、重复和冲突是否单独报告？
- 是否保存原始TXT、Excel和导入日志？
- 发生误导入时能否按批次回滚？
一套稳定的Zalo CRM衔接，不靠“一键”宣传，而靠清晰的字段契约和可恢复的数据链。
建议先建立一页字段字典
| 字典项目 | 示例 | 作用 |
|---|---|---|
| 业务字段名 | zalo_activity_time | 统一CRM命名 |
| 来源任务 | Zalo筛活跃 | 防止跨任务误写 |
| 数据类型 | 日期时间/整数/文本 | 避免导入失败 |
| 空值策略 | 不覆盖已有值 | 保护已知信息 |
| 更新时间 | 本次检测日期 | 支持时效判断 |
| 负责人 | 数据运营 | 明确异常处理 |
字段字典应与导入模板一起版本化。任务字段变化时先更新测试映射，不直接在生产CRM中增加临时列。
出现一对多匹配时怎么办？
同一规范手机号可能关联多个历史客户或线索。系统不应把一条Zalo结果无条件覆盖所有记录。可以指定主客户记录、保留关系表，或把冲突交给人工处理，但规则必须在导入前确定。
回滚也应按批次ID执行：保留本批更新前值、导入人、导入时间和源文件哈希。这样即使映射错误，也能恢复受影响字段，而不必回滚整个CRM。
