hubspot-update-deal

用途

该技能用于更新 HubSpot CRM 中已存在的交易（Deal），属于 HubSpot 系列技能中的交易更新环节。当用户说出“update deal”“edit deal”“change deal stage”“move deal”“close deal”等指令时加载本技能。执行更新操作必须提供交易 ID。

主要能力

修改交易名称（--name）
修改交易金额（--amount）
修改交易阶段（--stage）
修改预计成交日期（--closedate，格式为 YYYY-MM-DD）

以上可选参数至少需要提供一个。

使用方式

运行前检查

在执行更新前，先运行配置检查：

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

如果返回的 ai_action 不是 proceed_with_operation，则需按照 hubspot-connect 设置指南完成配置。

参数说明

必需参数：

--id：交易 ID

可选参数（至少提供一个）：

--name：新的交易名称
--amount：新的交易金额
--stage：新的交易阶段
--closedate：新的预计成交日期（YYYY-MM-DD）

示例

更新阶段（移动交易）：

python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py \
  --id 5840795376 \
  --stage "closedwon" \
  --json

更新金额：

python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py \
  --id 5840795376 \
  --amount 75000 \
  --json

将交易标记为赢单：

python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py \
  --id 5840795376 \
  --stage "closedwon" \
  --closedate "2025-12-13" \
  --json

常见交易阶段

阶段 ID	名称
appointmentscheduled	Appointment Scheduled
qualifiedtobuy	Qualified to Buy
presentationscheduled	Presentation Scheduled
decisionmakerboughtin	Decision Maker Bought In
contractsent	Contract Sent
closedwon	Closed Won
closedlost	Closed Lost

查找交易 ID

如果用户说“close the Acme deal”，先搜索：

python 00-system/skills/hubspot/hubspot-master/scripts/search_deals.py --name "Acme" --json

然后使用返回的 ID 进行更新。

输出格式

脚本以 JSON 返回更新后的交易属性：

{
  "id": "5840795376",
  "properties": {
    "dealname": "Acme Corp - Enterprise",
    "amount": "75000",
    "dealstage": "closedwon",
    "hs_lastmodifieddate": "2025-12-13T10:30:00Z"
  }
}

展示格式示例：

✅ Deal updated!
  ID: 5840795376
  Name: Acme Corp - Enterprise
  Updated fields:
    - stage: Closed Won
    - amount: $75,000

错误处理

错误	解决方案
401	令牌无效，重新运行设置
403	缺少 crm.objects.deals.write 权限范围
404	交易未找到，检查 ID
400	阶段 ID 无效
429	触发限流，等待后重试

适用场景

适用于需要在 HubSpot CRM 中调整已有交易信息的场景，例如推进销售阶段、更新成交金额、修改预计成交日期或将交易标记为赢单/输单。

限制

执行更新必须提供交易 ID；可选参数至少提供一个；运行前需通过配置检查，否则需先完成 hubspot-connect 设置。其他未在资料中说明的限制暂未提供。

技能介绍

用途