用途：把后端产生的产品事件推送到 HubSpot 联系人与公司的自定义属性，直接调用 HubSpot CRM API，不经过 CDP 中间层，属于 Segment 式集成的核心模式。
主要能力：区分自定义属性与自定义行为事件两种机制并给出选型依据；启动时校验属性定义是否存在及类型是否匹配；按事件与属性组合设计幂等键，避免重试导致计数翻倍；使用令牌桶队列把事件风暴合并为批量调用；解析 207 Multi-Status 的部分失败并把失败记录写入死信队列；按邮箱 upsert 或先查后建，处理联系人尚不存在的情况；从 429 响应的 Retry-After 头部读取退避时间。
使用方式：需 Node.js 18+ 或 Python 3.10+、具有联系人及公司读写与 schema 读写权限的 HubSpot 私有应用令牌、已定义或可创建的自定义属性、后端事件流（Kafka、SQS、webhook 或轮询）以及可重放的死信存储。属性校验应在服务启动时执行而非逐事件执行；计数器属性需先读取当前绝对值、计算后写回绝对值，并用幂等键跳过整个读写操作。
适用场景：产品数据、计数、时间戳、层级标记写入联系人/公司记录，供销售按产品信号筛选。
限制：若需要时间线可见的行为序列或营销归因，应使用自定义行为事件，其仅限 Marketing Hub Enterprise；属性类型不匹配时 HubSpot 仍返回 200 且静默转换，需自行校验；批量更新对不存在的联系人会静默丢弃；207 不能当作成功处理。资料未提供价格与其他平台细节。