hubspot-list-meetings

用途

hubspot-list-meetings 是一个专门用于从 HubSpot CRM 中列出会议互动（meeting engagements）的技能。当用户表达“list meetings”“show meetings”“meeting history”“hubspot meetings”等意图时，可加载该技能来获取已安排的会议记录。

主要能力

• 列出 HubSpot CRM 中的会议互动记录。
• 支持默认返回 10 条会议。
• 支持通过 --limit 参数自定义返回数量。
• 支持通过 --after 参数进行分页，使用游标值获取下一页。
• 输出 JSON 格式结果，包含会议 ID、标题、正文/备注、开始时间、结束时间、时间戳以及分页信息。
• 提供格式化展示，显示会议数量、标题、开始时间、结束时间、时长、备注和 ID。

使用方式

运行前需先执行配置检查：

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

如果 ai_action 不是 proceed_with_operation，则需按照 hubspot-connect 设置指南进行操作。

基本列表（默认 10 条会议）：

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

指定数量：

python 00-system/skills/hubspot/hubspot-master/scripts/list_meetings.py --limit 25 --json

分页：

python 00-system/skills/hubspot/hubspot-master/scripts/list_meetings.py --after "cursor_value" --json

输出 JSON 结构示例：

{
  "results": [
    {
      "id": "14771947458",
      "properties": {
        "hs_meeting_title": "Product Demo",
        "hs_meeting_body": "Demo of new features for enterprise team",
        "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"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

展示格式示例：

Found {count} meetings:

1. 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
   ID: 14771947458

2. Discovery Call
   Start: 2025-12-16 10:00
   ...

错误处理

• 401：无效令牌，需重新运行设置。
• 403：缺少 crm.objects.meetings.read 权限范围。
• 429：触发速率限制，需等待后重试。

相关技能

• hubspot-create-meeting：安排新会议。
• hubspot-get-associations：获取会议参会者。

适用场景

适用于需要从 HubSpot CRM 查询会议历史、查看已安排会议列表、按数量或分页获取会议记录的场景，例如销售团队回顾客户会议、检查即将进行的会议安排等。

限制

使用前必须完成 HubSpot 配置检查与连接设置；需要具备 crm.objects.meetings.read 权限范围；受 HubSpot 接口速率限制影响。关于收费、价格、平台支持范围等信息暂未提供。