hubspot-create-deal

用途

本技能用于在 HubSpot CRM 中创建新的交易（Deal）。当用户表达“create deal”“add deal”“new deal”“new opportunity”等意图时加载使用。

运行前检查

在执行操作前，需先运行配置检查：

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

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

参数

必填参数：

--name - 交易名称（必填）

可选参数：

--amount - 交易金额（美元）
--stage - 交易阶段 ID
--closedate - 预期成交日期（YYYY-MM-DD）
--pipeline - 管道 ID（未指定时使用默认管道）

使用方式

仅提供名称的最小示例：

python 00-system/skills/hubspot/hubspot-master/scripts/create_deal.py
--name "New Enterprise Deal"
--json

提供完整信息的示例：

python 00-system/skills/hubspot/hubspot-master/scripts/create_deal.py
--name "Acme Corp - Enterprise"
--amount 50000
--stage "qualifiedtobuy"
--closedate "2025-03-15"
--json

常见交易阶段

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": "5840795376", "properties": { "dealname": "Acme Corp - Enterprise", "amount": "50000", "dealstage": "qualifiedtobuy", "closedate": "2025-03-15T00:00:00Z", "createdate": "2025-12-13T10:00:00Z" } }

显示格式示例：

✅ Deal created! ID: 5840795376 Name: Acme Corp - Enterprise Amount: $50,000 Stage: Qualified to Buy Close Date: 2025-03-15

错误处理

401：令牌无效，需重新运行 setup
403：缺少 crm.objects.deals.write 权限范围
400：阶段 ID 无效，请检查阶段列表
429：触发速率限制，需等待后重试

适用场景

适用于需要通过脚本或自动化方式向 HubSpot CRM 录入销售交易、商机的场景，尤其适合在用户以自然语言指令触发创建交易时使用。

限制

交易名称必填；其他参数可选。阶段 ID 需为有效值，否则返回 400 错误。API 令牌需具备 crm.objects.deals.write 权限范围，否则返回 403。触发速率限制时需等待重试。关于定价、收费等信息，资料中暂未提供。

技能介绍

用途