数据补全（通用连接器）
指向您选择的数据补全服务商（Clearbit、Apollo、Hunter、People Data Labs，任选其一），自动填写公司和联系人的空白字段。
数据补全是一个通用、中立的连接器：您使用自己偏好的数据补全服务商账户（Clearbit、Apollo、Hunter、People Data Labs 等）。您提供服务商的地址、认证方式和字段映射；CRM 会查询该服务商，并只填写记录中的空白字段。我们这边不产生任何费用，账户和账单归属于您选择的服务商。
该连接器默认处于静默状态：在您完成配置之前不会发生任何操作。您提供的 API 密钥会加密存储，且不会再次显示。
前提条件
- 拥有一个数据补全服务商（Clearbit、Apollo、Hunter、People Data Labs 或其他）的账户，具有有效的 API 密钥以及足够的额度/套餐。
- 手边有该服务商的 API 文档：端点、认证请求头（例如 Authorization: Bearer，或 X-Api-Key）以及响应 JSON 的结构（用于构建映射）。
- 在 Sellio 中，拥有管理员权限，以便在“设置 → 集成”中保存该连接器。
在服务商处的操作步骤
- 登录您的数据补全服务商仪表盘，找到 API/开发者区域。
- 生成（或复制）一个 API 密钥。
- 记下按域名和/或邮箱查询的端点，以及所需认证请求头的确切格式。每个服务商都各不相同。
如何配置
- 打开“设置 → 集成”，进入“数据补全”卡片。
- 端点（URL）：粘贴服务商的地址，使用 {domain} 和/或 {email} 占位符。CRM 会用记录的域名（来自网站/域名或邮箱域名）替换 {domain}，用记录的邮箱替换 {email}。
- 认证请求头和前缀：输入请求头名称（例如 Authorization）和值前缀（例如带空格的“Bearer ”）。有些服务商使用自己专属的请求头，例如 X-Api-Key，且没有前缀。
- API 密钥：粘贴您的服务商密钥。它会被加密存储。
- 字段映射：每一行将服务商响应中的一个路径（左侧）关联到一个 CRM 字段（右侧）。您可以根据需要添加任意数量的行。
- 保存该连接器。然后，在公司或联系人详情页上，使用“补全”按钮。
如何构建映射
左侧是服务商 JSON 响应中该值所在的路径，使用点号逐级深入（列表位置用数字表示）。右侧是接收该值的 CRM 字段的 api_name。系统只会填写空白字段：记录中已存在的数据永远不会被覆盖。
Example: 端点：https://api.provider.com/v1/company?domain={domain} • 请求头：Authorization • 前缀：“Bearer ” • 映射：company.name → name，company.metrics.employees → employee_count，company.location.country → country
💡 如果响应返回一个列表，请使用索引：contacts.0.email 会取第一项的邮箱。整个对象或列表类型的值会被忽略；只有简单值（文本、数字）才能填入字段。
要进行补全，记录必须至少具有网站/域名或邮箱，因为查询中的 {domain}/{email} 正是来自这些字段。公司通常有网站；联系人和潜在客户通常有邮箱。
没有自己的服务商：系统模式和模拟模式
如果您未配置自己的服务商，“补全”按钮仍然可用。当 Sellio 启用了系统级服务商时，每次补全都会填写标准的企业信息字段（员工人数、营收、行业、技术栈、LinkedIn、国家），每条记录使用 1 个额度，费用会透明地计入您的账单。如果完全没有服务商，CRM 会使用模拟示例数据（免费），方便您体验该流程。集成卡片会显示当前启用的模式。
批量补全和自动补全
- 批量补全：在公司、联系人或潜在客户列表中选中多条记录，点击操作栏中的“补全”。CRM 会一次性补全所有记录，只填写空白字段。
- 创建时自动补全：在“设置 → 集成”中启用“创建记录时自动补全”。每个新建的公司、联系人或潜在客户，在创建后会立即填写其空白字段。
- 每日追补：一项自动例行任务会审查已启用该选项租户的近期记录，并在每日限额内补全尚待处理的部分。重复处理同一条记录不会重复扣费。
如何测试
- 打开一家有网站/域名（或有邮箱的联系人）且部分字段为空的公司记录。
- 点击“补全”。
- 检查空白字段是否已按照您的映射被填写。将结果与服务商预期的响应进行比较，以验证 JSON 路径是否正确。
故障排查
- 服务商返回 401/403：API 密钥错误/过期，或认证请求头不正确。请检查请求头名称和前缀（例如带空格的“Bearer ”）并重新粘贴密钥。
- 没有任何字段被填写：请检查映射路径是否与服务商实际的 JSON 一致（使用点号逐级深入，列表用索引，例如 contacts.0.email）。只有简单值（文本/数字）才能填入字段；整个对象/列表会被忽略。
- 即使服务商返回了数据，部分字段仍未更新：数据补全只会写入空白字段。如果字段已有值，按设计会被保留。
- “补全”按钮没有反应：请确认记录具有网站/域名或邮箱（查询使用 {domain}/{email}），并且端点中使用了这些占位符。
- 404/无效端点：请检查端点 URL，以及服务商在查询中期望的是域名还是邮箱。