用途:为 HubSpot CRM 事件搭建 Webhook 订阅与处理端点,覆盖联系人、公司、交易、工单的创建、更新、删除、合并、关联变更及隐私删除等事件。
主要能力:支持 v3 签名验证(以 v2 作为回退),通过时间戳校验实现重放保护;以 eventId 跟踪实现幂等处理,避免重复事件被重复消费;提供事件处理示例,如联系人生命周期阶段变化、交易阶段变化、删除事件等;支持通过 API 注册订阅。
使用方式:需先创建 HubSpot 公开应用(Webhook 不支持私有应用),获取客户端密钥,准备可公网访问的 HTTPS 端点,可选 Redis 或数据库用于幂等。端点须使用原始请求体进行签名验证,收到事件后立即返回 200(HubSpot 期望 5 秒内响应),再异步处理事件。本地测试可用 ngrok http 3000 暴露本地服务,并在应用设置中更新 Webhook URL。
适用场景:需要将 HubSpot CRM 变更实时同步到自有系统、触发工作流、通知销售团队或满足 GDPR 删除要求时。
限制:资料未提供具体收费、价格或性能数据;幂等示例使用内存 Set,生产环境建议改用 Redis 或数据库;签名验证依赖正确的客户端密钥与时间戳窗口(5 分钟)。