用途:把源 CRM 数据迁移进 HubSpot,涵盖数据清点与字段映射、API 批量导入、校验与回滚思路。适用于从 Salesforce、Pipedrive 或电子表格批量迁入联系人、交易等对象。
主要能力:用 FieldMapping 定义源字段到 HubSpot 属性的映射,可对生命周期阶段等值做转换;导入前用 ensureCustomProperties 创建 HubSpot 中不存在的自定义属性(如 source_crm_id、migration_date);联系人按 100 条一批调用 POST /crm/v3/objects/contacts/batch/upsert 批量写入并跟踪进度;交易(deals)迁移支持按联系人邮箱映射建立关联;迁移后用搜索接口做记录数与必填字段校验,通过率阈值示例为 95%。
使用方式:先导出源 CRM 数据并准备具有所需 scopes 的 HubSpot 账号;按需创建自定义属性;再配置映射并分批导入,批失败时回退为单条创建,冲突时改为更新;最后校验。限速示例为每秒最多 10 次请求,批间等待 200ms。
限制:资料未提供具体价格、套餐要求或托管环境说明;示例速率、批量大小、95% 阈值均为代码中的取值,实际需按账号权限调整;需要 Node.js 环境与 @hubspot/api-client 依赖。