将 CarrierLookup CSV 与原始联系人行进行关联
本指南介绍了如何将 CarrierLookup CSV 结果与原始联系人记录进行关联，并提供了数据团队应遵循的请求边界和审核步骤。
若要将 CarrierLookup CSV 结果关联回联系人记录，请在上传前创建一个本地辅助文件（sidecar）：将每个准备好的带国家代码的号码映射到提供该号码的所有原始联系人行 ID。
若要将 CarrierLookup CSV 结果关联回联系人记录，请在上传前创建一个本地辅助文件：将每个准备好的带国家代码的号码映射到提供该号码的所有原始联系人行 ID。仅提交针对所选国家/地区准备好的标识符，然后通过标识符而非文件行位置来核对返回的 CSV。这样做可以保留重复的联系人，同时避免假设批量服务会为每一条源记录返回一行结果。
在创建批量文件前准备辅助文件
CarrierLookup 的实时原始归属运营商查询（Original Carrier Lookup）返回号码最初分配的运营商、底层运营商、号码类型以及分配地理位置。其独立的全球运营商查询产品负责处理异步文件任务。全球运营商查询页面是相关的产品路径。批量处理接受单列 TXT 或 CSV 文件，每行包含一个带国家代码的号码，并指定一个 ISO 国家/地区。准备好的文件应主要针对该选定国家/地区。请勿假设该产品接受 XLSX、混合模式或包含 CRM 行 ID 的文件。
源 CRM 导出数据可能包含重复号码、不同的显示格式、空值以及超出目标国家/地区的号码。在提交之前，请创建一个从规范化国家代码号码到源行 ID 列表的本地映射。保留每行旁边的原始文本和规范化决策以供审计。例如，两个联系人可能共享同一个企业总机号码；即使提交的列表中只包含该号码一次，辅助文件也应保留这两个行 ID。这是客户拥有的数据结构，而非批量产品返回的列。
将拒绝的源行与排除的准备标识符分开。某一行可能因缺乏足够的上下文进行规范化而在上传前无法使用，而批量预处理可能会在稍后排除重复项或所选国家/地区之外的号码。请清晰记录每个阶段。
使用标识符含义而非行位置作为关联键
成功的批量任务会返回一个包含标识符和原始分配字段的 CSV。批量标识符是不带加号或空格的带国家代码数字。源 CRM 可能存储带有前导加号、国家格式或标点符号的 E.164 号码。在关联之前，将双方规范化为相同的客户自有比较格式，同时分别保留每种原始表示形式。请勿假设 CSV 行的顺序与联系人行的顺序一致；预处理可能会排除无效或重复的条目。
关联关系为多对一：多个联系人行可以指向同一个准备好的号码和一个返回的查询行。仅在验证键值后，才将结果扩展回这些源行。反之，如果返回的标识符在提交的清单中不存在，请将其隔离以供审查，而不是将其附加到最近的行。这是一种核对规则，而非暗示意外行是正常的系统行为。
紧凑的清单可以包含源行 ID、原始电话文本、规范化比较值、所选国家/地区、准备好的文件名和提交批次引用。这些是本地元数据字段。不得将其宣传为 CarrierLookup CSV 列。API 文档应作为当前任务提交和结果详情的参考。
在更新记录前检查排除项和重复项
批量预处理会排除无效行、重复项、不带国家代码的号码以及所选国家/地区之外的号码。被排除的行不收费。这就是上传行数、准备好的有效行数和结果行数可能不同的原因。请将它们作为三个独立的数量进行核对。请勿从相邻的输出行填充被排除行的运营商信息。如果重复的源联系人共享一个规范化号码，应用程序可以将一个已完成的结果映射回两者，并保留相同的观察时间和来源。
如果估计的有效手机号码过少或不满足其他接受条件，任务可能会在准备阶段失败。在这种情况下，请勿根据输入文件创建虚构的结果行。保留清单以供诊断，并查阅产品文档以了解当前各产品的限制。本文特意未说明具体的任务最小值、最大值或正常完成时间。批量任务是异步的，因此请在 CSV 可用之前等待任务成功。
CSV 字段描述的是原始分配情况，而非号码携号转网后的当前运营商。地区和城市是号码分配的地理位置，而非联系人的当前位置。带有空分配字段的已完成行应保持为带有不可用值的已完成行，而不应作为无效关联被丢弃。
在 CRM 写入前生成核对报告
最终的客户自有报告应列出：提交的唯一标识符、返回的标识符、未匹配的提交键、意外返回的键、在上传前被拒绝的源行，以及将接收相同结果的重复源行。在开始写入之前，审核员应批准针对未匹配情况的关联策略。请将原始 CSV 和辅助文件保留在组织自己的访问和保留策略下，以便后续审计可以重现映射。
对于每次 CRM 更新，请检查联系人是否仍保留相同的规范化号码。如果号码在任务运行期间发生了变化，请标记冲突，而不是用陈旧的运营商上下文覆盖当前记录。可选的记录版本检查可以帮助客户的集成强制执行该规则；这不是 CarrierLookup 的功能。请将查询来源和观察时间与原始分配字段一起存储。
在试运行后，抽取一个重复号码、一个在准备期间被排除的号码、一个已完成但字段为空的结果以及一个在任务期间被编辑的联系人进行检查。预期的结果分别是：有意的多对一扩展、不产生虚构的运营商结果、保留空值以及延迟冲突处理。此验证旨在解决文件工作流的实际风险：将技术上正确的查询映射到错误的联系人上。
如果一个源行包含多个电话字段，请记录每个字段生成了哪个准备好的标识符。主要联系号码和备用号码不应接收可互换的运营商值。辅助文件随后可以解释为什么已完成的 CSV 行更新了一个字段，而未触及另一个字段，即使这两个值属于同一个人或公司记录。
常见问题解答
团队应该按位置关联批量 CSV 行吗？
不应该。请使用返回的带国家代码标识符和本地辅助文件映射到源行 ID；预处理可能会移除行。
如何处理拥有同一个电话号码的重复联系人？
在辅助文件中保留每个源行 ID，在适当的情况下提交一次准备好的标识符，并有意识地将已完成的结果映射回每个匹配的行。
在准备期间被排除的号码会怎样？
将其保留在排除报告中，不要为该源行虚构运营商结果。
CSV 能显示联系人的当前网络或位置吗？
不能。它报告的是原始运营商和号码段分配地理位置，这些不是当前网络或个人位置的事实。
了解更多
选择适合您工作流下一步的产品信息。