技能介绍

要解决什么问题

把 HubSpot 当 CRM 用时，认证方式选错会直接卡在权限或审核上：公共应用要走 OAuth 2.0，单账户集成更适合 Private App Token。另外，联系人、公司等对象的创建、读取、更新、删除如果按「一条 HTTP 一条记录」来写，很容易撞限流；该用批量或 Webhook 的地方却用轮询，运维成本也会上去。本技能把这些决策和操作边界写清楚，避免按已弃用路径集成。

技能如何工作

技能围绕 HubSpot 集成的两条主线组织说明：

认证模式：区分面向公共应用的 OAuth 2.0 与面向单账户的 Private App Token，对应不同的集成场景。
CRM 对象 CRUD：对标准 CRM 记录执行创建、读取、更新、删除，作为与 HubSpot 数据面交互的基础能力。
反模式清单：明确不建议使用已弃用的 API Key、用单条请求替代批量请求、以及用轮询替代 Webhook。

文档中还整理了易踩坑项（含高/严重等级），遇到具体报错或边界行为时应回到官方文档对照，而不是凭经验硬改请求参数。

适用边界与注意点

技能侧重集成模式与 API 使用规范，不会替你完成 HubSpot 应用注册、回调 URL 配置或 Webhook 订阅的全部运维细节；这些仍需在 HubSpot 开发者后台按账号类型完成。若你的场景是 Marketplace 公共应用，应优先按 OAuth 流程设计；若是内部工具连单一 Portal，Private App 通常更简单。表格中的「参见文档」项意味着实现细节以 HubSpot 当前 API 文档为准，版本变更时需自行核对字段与端点。