SuperAPI AI 工具集

hubspot-create-company

办公与效率

查看项目

更新于 10-15 08:13

技能介绍

用途

该技能用于在 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:触发限流,等待后重试。

定价、平台支持范围、速率限制的具体数值等细节暂未提供。