hubspot-create-note

用途

hubspot-create-note 是一个专门用于在 HubSpot CRM 中创建笔记（note）互动记录的技能。当用户表达“create note”“add note”“new note”“record note”等意图时加载该技能。笔记内容（body）为必填项。

主要能力

在 HubSpot CRM 中创建一条笔记互动记录。
支持指定笔记正文内容。
支持指定 ISO 格式的时间戳，未指定时默认使用当前时间。
以 JSON 格式返回创建结果，包含笔记 ID 及属性（如 hs_note_body、hs_timestamp）。
提供展示格式，输出笔记 ID、内容与时间戳。

使用方式

预检

运行前需执行配置检查：

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

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

必填参数

--body：笔记内容（必填）。

可选参数

--timestamp：ISO 时间戳（默认当前时间）。

示例

简单笔记：

python 00-system/skills/hubspot/hubspot-master/scripts/create_note.py \
  --body "Spoke with John about pricing. He's interested in the enterprise tier." \
  --json

带时间戳的笔记：

python 00-system/skills/hubspot/hubspot-master/scripts/create_note.py \
  --body "Meeting notes from yesterday's call" \
  --timestamp "2025-12-12T14:00:00Z" \
  --json

输出格式

{
  "id": "16977760701",
  "properties": {
    "hs_note_body": "Spoke with John about pricing...",
    "hs_timestamp": "2025-12-13T10:00:00Z"
  }
}

展示格式

✅ Note created!
  ID: 16977760701
  Content: Spoke with John about pricing. He's interested in the enterprise tier.
  Timestamp: 2025-12-13 10:00

适用场景

记录与联系人的沟通要点，例如讨论定价、产品兴趣等。
保存会议记录与通话纪要。
记录不适合写入邮件的内部上下文信息。
记录行动项与后续步骤。

最佳实践

保持笔记简洁但信息充分。
包含行动项与后续步骤。
引用具体讨论的主题。
用于不会出现在邮件中的内部上下文。

错误处理

错误	解决方案
401	令牌无效，重新运行设置
403	缺少 crm.objects.notes.write 权限范围
429	触发速率限制，等待后重试

限制

关于该技能是否收费、支持的具体平台范围、性能效果等，资料中暂未提供。

技能介绍

用途