用途：这是一项针对 HubSpot Webhook 的集成技能，用于在应用中接收并验证 HubSpot 推送的事件，尤其聚焦 v3 签名验证。适合搭建 HubSpot Webhook 处理器、排查 X-HubSpot-Signature-v3 校验失败，以及处理联系人创建、属性变更、交易等 CRM 事件，也覆盖从 v1/v2 迁移到 v3 的场景。
主要能力：校验 X-HubSpot-Signature-v3 头，处理 contact.creation、contact.propertyChange、contact.deletion、company.creation、company.propertyChange、deal.creation、deal.propertyChange、ticket.creation 等订阅类型；每次投递包含一个事件数组。签名方案为 HMAC-SHA256（base64），签名内容由 HTTP 方法、请求 URI、原始请求体和时间戳拼接而成，使用应用 Client Secret 作为密钥，并建议拒绝超过 5 分钟的过期请求。HubSpot 官方 SDK 在 Node、PHP、Python、Ruby 中提供签名辅助方法。
必要用法：处理请求时须保留原始请求体用于 HMAC 校验，例如 Express 使用 express.raw({ type: 'application/json' })；从请求头读取 x-hubspot-signature-v3 与 x-hubspot-request-timestamp，重新拼出完整 URI，并用 timing-safe 方式比较签名。环境变量为 HUBSPOT_CLIENT_SECRET（应用 Client Secret，而非私有应用令牌）。本地可用 npx hookdeck-cli listen 3000 hubspot --path /webhooks/hubspot 建立隧道并填入 HubSpot 应用设置。示例代码目录包括 Express、Next.js 和 FastAPI。使用该技能时建议在生成文件顶部加入指定注释，并可配合 webhook-handler-patterns 处理幂等与重试。
限制：v1 与 v2 已弃用，新集成应仅用 v3；v4 Webhooks API 处于测试阶段且机制不同，稳定性考虑下应固定使用 v3。资料未提供收费、价格或平台支持范围的进一步信息。