挑战

Administrate 需要在没有手动导出、重复记录或脱节的销售和交付团队的情况下，使 CRM 数据与 HubSpot 保持一致。该集成需要支持多种对象类型、增量更新，以及在 API 请求失败时的可靠恢复。

解决方案

我们在经过验证的 Administrate 集成平台上扩展了 HubSpot 作为源适配器，使用了与 Salesforce 集成相同的共享编排、规范化转换和运行最终化模式。

• HubSpot → Administrate：公司、联系人、交易和订单项从 HubSpot 的 CRM API 拉取，规范化为规范模型并发送到 Administrate。
• Administrate → HubSpot：联系人资料批量 upsert 到 HubSpot，按电子邮件匹配，并用 Administrate 外部 ID 丰富。
• 编排器分派增量作业，分页 HubSpot API 响应，将结果拆分为可配置批次，并为每种对象类型保留 watermark。
• 共享数据表保存集成路由、映射、队列状态、同步状态、运行历史和错误。
• 失败会重试并通过中央错误通知器呈现，附带 Slack 和 Telegram 通知。

结果

• 一个可复用的双向 CRM 适配器，在不复制集成平台的情况下添加 HubSpot。
• 公司、联系人、交易和订单项可在受控的 200 条记录批次中同步。
• 增量 watermark 和批量 upsert 减少不必要的 API 工作并防止重复联系人。