用途
hubspot-create-meeting 是一个专门用于在 HubSpot CRM 中创建会议(meeting engagement)的技能。当用户表达“create meeting”“add meeting”“schedule meeting”“new meeting”等意图时加载该技能,用于把会议安排写入 HubSpot CRM。
主要能力
- 在 HubSpot CRM 中创建会议活动记录。
- 支持设置会议标题、描述/备注、开始时间与结束时间。
- 以 JSON 格式返回创建结果,包含会议 ID 及会议属性(标题、正文、开始时间、结束时间、时间戳)。
- 提供可读的展示格式,显示会议 ID、标题、开始时间、结束时间、时长与备注。
使用方式
运行前需先执行配置检查:
python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json
如果 ai_action 不是 proceed_with_operation,则需按照 hubspot-connect 设置指南完成配置。
必填参数:
--title:会议标题(必填)。
可选参数:
--body:会议描述/备注。--start:开始时间,ISO 格式,默认为当前时间。--end:结束时间,ISO 格式,默认为开始时间加 1 小时。
示例一,指定时间:
python 00-system/skills/hubspot/hubspot-master/scripts/create_meeting.py \
--title "Product Demo" \
--body "Demo of new features for enterprise team" \
--start "2025-12-15T14:00:00Z" \
--end "2025-12-15T15:00:00Z" \
--json
示例二,快速创建(默认当前时间加 1 小时):
python 00-system/skills/hubspot/hubspot-master/scripts/create_meeting.py \
--title "Quick sync call" \
--json
输出格式示例:
{
"id": "14771947458",
"properties": {
"hs_meeting_title": "Product Demo",
"hs_meeting_body": "Demo of new features...",
"hs_meeting_start_time": "2025-12-15T14:00:00Z",
"hs_meeting_end_time": "2025-12-15T15:00:00Z",
"hs_timestamp": "2025-12-15T14:00:00Z"
}
}
展示格式示例:
✅ Meeting created!
ID: 14771947458
Title: Product Demo
Start: 2025-12-15 14:00
End: 2025-12-15 15:00
Duration: 1 hour
Notes: Demo of new features for enterprise team
时间格式使用 ISO 8601,例如:
2025-12-15T14:00:00Z(UTC)2025-12-15T14:00:00+01:00(带时区)
适用场景
- 需要将会议安排记录到 HubSpot CRM 时。
- 通过命令行或自动化流程批量创建会议记录时。
- 需要以结构化 JSON 获取创建结果以便后续处理时。
限制与错误处理
- 需要有效的 HubSpot 访问令牌与相应权限,否则会返回错误。
- 常见错误及处理:401 表示令牌无效,需重新运行设置;403 表示缺少 crm.objects.meetings.write 权限范围;400 表示时间格式无效;429 表示触发速率限制,需等待后重试。
- 时间必须使用 ISO 8601 格式。
相关技能
- hubspot-list-meetings:列出所有会议。
- hubspot-get-associations:将会议关联到联系人。