hubspot-log-call

用途

hubspot-log-call 是一个专门用于在 HubSpot CRM 中记录通话互动（Call Engagement）的技能。当用户表达“log call”“record call”“add call”“call made”等意图时加载使用，帮助将已发生的通话记录写入 HubSpot CRM。

主要能力

该技能通过 Python 脚本 log_call.py 向 HubSpot 写入通话记录，支持以下参数：

必填参数：--title，通话标题。
可选参数：--body，通话备注或摘要；--duration，通话时长（分钟，默认 0）；--direction，通话方向，取值为 OUTBOUND 或 INBOUND（默认 OUTBOUND）；--status，通话状态，取值为 COMPLETED、BUSY、NO_ANSWER、FAILED、CANCELED 等（默认 COMPLETED）。

脚本支持 --json 输出，返回记录 ID 与属性信息，包括 hs_call_title、hs_call_body、hs_call_direction、hs_call_duration、hs_call_status、hs_timestamp 等字段。

使用方式

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

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

若返回的 ai_action 不是 proceed_with_operation，则需按照 hubspot-connect 设置指南完成配置。

记录已完成通话的示例：

python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py
--title "Discovery Call with Acme"
--body "Discussed requirements, timeline, and budget. Next step: send proposal."
--duration 30
--json

记录未接来电的示例：

python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py
--title "Follow-up attempt"
--status "NO_ANSWER"
--direction "OUTBOUND"
--json

通话状态取值

COMPLETED：通话已接通
BUSY：线路忙
NO_ANSWER：无人接听
FAILED：通话失败
CANCELED：通话已取消

输出与展示

脚本以 JSON 格式返回记录信息，包含记录 ID 和属性字段。展示格式示例：

✅ Call logged! ID: 14772074448 Title: Discovery Call with Acme Direction: Outbound Duration: 30 minutes Status: Completed Notes: Discussed requirements, timeline...

错误处理

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

限制

该技能依赖 HubSpot 配置与有效令牌，需具备 crm.objects.calls.write 权限范围。关于收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途