用途
该技能用于在 HubSpot CRM 中创建一条新的公司记录,属于 HubSpot 技能集合中的公司创建专用技能。当用户表达“create company”“add company”“new company”等意图时可加载使用。
主要能力
- 在 HubSpot CRM 中创建公司对象。
- 支持填写名称、域名、行业、城市、电话等属性。
- 以 JSON 格式返回创建结果,包含公司 ID 与属性字段。
- 提供展示格式示例,便于在对话或日志中呈现创建成功信息。
- 附带常见错误码及对应处理建议。
使用方式
运行前先执行配置检查:
python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json
如果检查结果中的 ai_action 不是 proceed_with_operation,需按照 hubspot-connect 配置指南完成设置。
创建命令示例(仅名称):
python 00-system/skills/hubspot/hubspot-master/scripts/create_company.py
--name "Acme Corp"
--json
创建命令示例(完整参数):
python 00-system/skills/hubspot/hubspot-master/scripts/create_company.py
--name "Acme Corp"
--domain "acme.com"
--industry "Technology"
--city "San Francisco"
--json
参数说明:--name 为必填;--domain、--industry、--city、--phone 为可选。
输出格式示例:
{ "id": "6493611979", "properties": { "name": "Acme Corp", "domain": "acme.com", "industry": "Technology", "createdate": "2025-12-13T10:00:00Z" } }
展示格式示例:
✅ Company created! ID: 6493611979 Name: Acme Corp Domain: acme.com Industry: Technology City: San Francisco
适用场景
- 需要在 HubSpot CRM 中建立公司主数据时。
- 将重复性公司录入流程脚本化、自动化时。
- 与 hubspot-list-companies、hubspot-search-companies、hubspot-get-associations 等技能配合,完成公司查询、去重与联系人关联等后续操作。
限制与错误处理
使用前需具备有效 HubSpot 授权,并拥有 crm.objects.companies.write 写权限。文档列出的错误处理建议如下:
- 401:令牌无效,需重新运行设置。
- 403:缺少 crm.objects.companies.write 权限范围。
- 409:公司可能已存在,建议先搜索。
- 429:触发限流,等待后重试。
定价、平台支持范围、速率限制的具体数值等细节暂未提供。