SuperAPI AI 工具集

hubspot-create-meeting

办公与效率

查看项目

更新于 10-15 08:14

技能介绍

用途

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:将会议关联到联系人。