hubspot-list-calls

用途

本技能是 HubSpot CRM 的专项技能，用于列出通话互动记录。适用触发词包括“list calls”“show calls”“call history”“hubspot calls”。返回已记录的通话记录。

主要能力

列出通话互动记录，默认返回 10 条。
通过 --limit 参数指定返回数量。
通过 --after 参数配合游标实现分页。
输出结构化 JSON，包含通话属性与分页信息。
提供人类可读的展示格式。

使用方式

运行前先执行配置检查：

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_calls.py --json

指定数量：

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

分页：

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

输出格式

{
  "results": [
    {
      "id": "14772074448",
      "properties": {
        "hs_call_title": "Discovery Call",
        "hs_call_body": "Discussed requirements and timeline...",
        "hs_call_direction": "OUTBOUND",
        "hs_call_duration": "1800000",
        "hs_call_status": "COMPLETED",
        "hs_timestamp": "2025-12-13T10:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

展示格式

Found {count} calls:

1. Discovery Call
   Direction: Outbound
   Duration: 30 minutes
   Status: Completed
   Date: 2025-12-13 10:00
   Notes: Discussed requirements and timeline...
   ID: 14772074448

2. Follow-up Call
   Direction: Inbound
   ...

通话方向取值

取值	含义
OUTBOUND	拨出电话
INBOUND	接入电话

错误处理

错误	解决方案
401	令牌无效，重新运行设置
403	缺少 crm.objects.calls.read 权限
429	触发限流，等待后重试

限制

关于本技能支持的平台、收费方式、价格等未在资料中提供。

技能介绍

用途