用途:本技能用于将 LeadGenius 富集线索导入、同步、迁移或导出到 HubSpot,覆盖联系人、公司与两者之间的主关联。
主要能力:通过 HubSpot 私有应用令牌(Bearer)直连 API;使用 LeadGenius 的 X-Admin-Key 绕过常规限流;自动在 HubSpot 创建 leadgenius_data 属性组及 lg_* 自定义属性;解析 LeadGenius 深层嵌套 JSON(AI 评分、公司描述、冷邮件内容、推荐语、LinkedIn 等)映射到联系人属性;通过 crm/v3/objects/contacts/batch/upsert 以 email 为 idProperty 批量写入;创建公司并按 domain 去重(lg_company_key = "domain:<domain>"),设置正确的主关联(associationTypeId 1),且可重复执行。
使用方式:环境变量放在 .env,包含 LGP_API_KEY、LGP_MASTER_KEY、HUBSPOT_ACCESS_TOKEN;HubSpot 私有应用需联系人、公司及关联读写作用域。执行:python3 scripts/lg_to_hs.py <file.csv> 导入联系人;python3 scripts/lg_companies_associations.py <file.csv> 创建公司并设主关联;python3 scripts/hs_audit_primary.py <file.csv> --limit 100 审计。保存视图需手动在 HubSpot 界面创建。
限制:必须按 API 回显键(email、公司域名)做映射,不能按列表下标配对联系人与公司,否则会造成错误归属;公司去重以域名而非邮箱域名为准,子公司/本地实体域名可能合法不同;若门户已被污染,应先按修复手册处理而非直接重导。